Dự án và tệp

Dự án là một tập hợp tệp được giữ trên thiết bị của bạn, trong đó có một tệp chính được đem đi dàn trang. Bạn có thể nhập cả một dự án cùng lúc bằng cách mở một tệp .zip hoặc một thư mục, chẳng hạn tệp tải về từ một trình soạn LaTeX khác.

Dự án là gì

Một dự án chứa mọi tệp mà tài liệu của bạn cần: mã nguồn .tex, một tệp .bib chứa tài liệu tham khảo, hình ảnh và tệp dữ liệu cho đồ thị. Các tệp có thể nằm trong thư mục, chẳng hạn chapters/intro.tex hoặc figures/plot.png.

Dự án được lưu trong bộ nhớ trình duyệt trên thiết bị này, ngay sau mỗi thay đổi. Bảng Dự án liệt kê chúng, mới nhất ở trên cùng, và cho phép bạn đổi tên, chuyển sang hoặc xóa chúng. Xóa một dự án ở đây không bao giờ xóa bản sao bạn đã lưu vào Google Drive.

Tệp chính

Một tệp .tex là tệp chính: tệp có \documentclass và \begin{document}. Đó là tệp được dàn trang, và nó kéo các tệp khác vào bằng \input và \include. Bảng Tệp đánh dấu nó bằng chữ chính.

Để dàn trang một tệp khác, hãy mở menu của tệp đó trong bảng Tệp và chọn Dàn trang tệp này, hoặc chọn nó trong mục Tệp chính.

Một tệp chính có danh mục tài liệu tham khảo

LaTeXSao chépMở trong trình soạn (mở trong thẻ mới)

\documentclass{article}
\begin{document}
\section{Background}
Long tables are discussed by \cite{mustermann2021}.
\bibliographystyle{plain}
\bibliography{refs}
\end{document}

Ví dụ trên cần một tệp thứ hai, refs.bib, trong cùng dự án. Hãy mở nó trong trình soạn thảo để xem cả hai tệp. Tìm hiểu thêm về tài liệu tham khảo trong Danh mục tài liệu tham khảo và trích dẫn.

Nhiều tệp .tex

Chia một tài liệu dài thành mỗi chương một tệp và kéo chúng vào tệp chính. \input{chapters/intro} chèn tệp vào đúng chỗ đặt lệnh; \include{chapters/intro} cũng làm vậy nhưng bắt đầu một trang mới trước. Có thể bỏ phần mở rộng .tex.

\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/method}
\input{appendix}
\end{document}

Lỗi trong một tệp được chèn sẽ chỉ đúng tệp và dòng trong thẻ Sự cố. Xem Dự án có nhiều tệp để biết chi tiết, bao gồm điều gì xảy ra với \includeonly và gói subfiles.

Thêm tệp

Có nhiều cách để thêm tệp vào dự án đang mở:

• Thả tệp vào bất kỳ đâu trên trình soạn thảo.
• Trong bảng Tệp, dùng Tải lên cho các tệp hoặc Thư mục cho cả một thư mục từ thiết bị này.
• Dùng Tệp mới để tạo một tệp trống. Gõ một đường dẫn như chapters/intro.tex để đặt nó vào một thư mục.
• Dùng Drive hoặc Thư mục Drive để thêm tệp từ Google Drive của bạn. Xem Lưu vào Google Drive.

Nếu dự án đã có tệp trùng tên, trình soạn thảo sẽ hỏi nên thay thế tệp đó hay giữ tệp của bạn.

Trình soạn thảo nhận các tệp .tex, .bib, .sty, .cls, .bst, .txt, .md, .csv và các tệp văn bản tương tự, hình ảnh (PNG, JPG, SVG, PDF và vài định dạng khác) và tệp .zip, vốn sẽ được giải nén.

Nhập dự án từ tệp .zip hoặc một thư mục

Hầu hết các trình soạn LaTeX và mọi bản cài đặt TeX đều giữ dự án dưới dạng một thư mục. Để đưa một dự án như vậy vào Scissor LaTeX:

1. Tải dự án về dưới dạng .zip từ trình soạn thảo kia, hoặc tìm thư mục của nó trên máy tính.
2. Trong Scissor LaTeX, chọn Dự án mới, rồi Mở tệp .tex hoặc .zip hoặc Mở thư mục.
3. Trình soạn thảo giải nén, giữ nguyên cấu trúc thư mục và chọn tệp chính.

Khi có nhiều hơn một tài liệu hoàn chỉnh, trình soạn thảo ưu tiên main.tex, sau đó là tệp trùng tên với thư mục, rồi đến tệp có đường dẫn ngắn nhất. Một ghi chú cho bạn biết nó đã chọn tệp nào, và bạn có thể đổi trong mục Tệp chính.

Một thư mục có thể chứa tối đa 2,000 tệp và 100 MB. Khi thư mục lớn hơn, các tệp mã nguồn được giữ trước, phần còn lại bị loại ra và được đếm.

Tệp mà tài liệu cần nhưng dự án còn thiếu

Sau khi bạn mở hoặc thêm tệp, trình soạn thảo kiểm tra những gì tài liệu tham chiếu đến: hình ảnh trong \includegraphics, tệp .bib, tệp trong \input và \include, và tệp dữ liệu của đồ thị. Nếu thiếu thứ gì, bảng Tệp sẽ liệt kê nó, kèm các nút để tải lên hoặc thêm từ Drive. Một tệp bạn thêm chỉ bằng tên trần sẽ được đặt vào đúng chỗ tài liệu mong đợi, nên plot.png sẽ vào figures/ nếu tài liệu yêu cầu figures/plot.png.

Cho đến lúc đó, một ảnh bị thiếu được vẽ thành một khung nét đứt có ghi tên ảnh, và thẻ Sự cố cho biết những ảnh nào bị thiếu.

Một ảnh có trong dự án, một ảnh bị thiếu

LaTeXPhần mở đầu: \usepackage{graphicx}Sao chépMở trong trình soạn (mở trong thẻ mới)

\includegraphics[width=0.45\linewidth]{figures-plot.png}

\includegraphics[width=0.45\linewidth]{figures/missing.png}

Thẻ Sự cố: Images not in the project: figures/missing.png

Tệp .sty và .cls của riêng bạn

Một dự án có thể chứa các tệp .sty và .cls của riêng nó: chúng được giữ lại, lưu vào Drive và xuất cùng dự án. Tuy vậy, bản xem trước chưa đọc chúng. Một lệnh \usepackage{mymacros} trỏ đến tệp của riêng bạn sẽ được báo trong thẻ Sự cố là một gói không có sẵn, và các lệnh được định nghĩa trong đó bị bỏ qua.

Cho đến khi điều đó thay đổi, hãy sao chép các dòng \newcommand và \newenvironment bạn cần từ tệp .sty vào phần mở đầu của tệp chính. Chúng hoạt động ở đó, và tài liệu vẫn biên dịch được trong một bản cài đặt TeX.

\documentclass{article}
% from mymacros.sty
\newcommand{\project}{River Survey}
\newcommand{\unit}[1]{\,\mathrm{#1}}
\begin{document}
The \project{} measured a flow of $44\unit{m^3/s}$.
\end{document}

Khác biệt so với một bản cài đặt TeX

Mọi ví dụ trên trang này đều được Scissor LaTeX dàn trang khi xây dựng trang web. Cập nhật lần cuối 2026-11-07.