跳至主要內容
EasyLaTeXDocs

多檔案專案

把每個章節儲存為獨立的 .tex 檔案,主檔案只保留文件類、套件、全域設定和章節順序。這樣多人協作、定位錯誤和重複使用章節都會更容易。

EasyLaTeX 編譯器設定:XeLaTeX + ctex;基礎方案不需要額外套件。所有被引用檔案都應使用專案內的相對路徑。

使用 \input 插入內容

\input{檔名} 在當前位置讀取另一個檔案的內容,檔名通常省略 .tex:

LaTeX
\section{引言}\input{chapters/introduction}

被插入檔案只寫正文,不要重複 \documentclass、\begin{document} 或 \end{document}。

使用 \include 管理章節

\include 適合較大的章節,它會在前後分頁,併為每章建立獨立的輔助檔案:

LaTeX
\include{chapters/method}\include{chapters/results}

平台仍從選中的主檔案編譯。\includeonly{chapters/results} 可用於只預覽指定章節,但跳過章節的引用依賴輔助資訊,不應假設在每次任務中都會保留;最終檢查前移除此設定並編譯全文。

選擇 \input 還是 \include

指令特點適合內容
\input不分頁,能巢狀,粒度小小節、圖表、摘要片段
\include自動分頁,不能巢狀,支援 \includeonly獨立的大章節

不要在同一個檔案中混用兩套方式來控制同一章節的分頁;讓主檔案決定章節邊界。

組織目錄和路徑

推薦讓目錄名錶達用途:

LaTeX
project/├── main.tex├── chapters/│   ├── introduction.tex│   └── results.tex└── figures/

路徑相對於主檔案解析。檔名儘量使用英文、數字和連字元,避免空格及特殊字元造成跨平台問題。

單獨編譯章節

章節檔案預設不能獨立編譯,因為它依賴主檔案的導言區。需要單獨預覽時,可使用 subfiles 套件建立共享前導:

LaTeX
% main.tex\usepackage{subfiles}\subfile{chapters/introduction}
LaTeX
% chapters/introduction.tex\documentclass[../main.tex]{subfiles}\begin{document}章節內容。\end{document}

在平台中使用這種結構時,只有包含完整入口的子檔案才可在主檔案選擇處單獨選中。完成區域預覽後,把主檔案選擇恢復為專案入口;普通專案始終從 main.tex 編譯更簡單。

常見問題

找不到檔案

檢查路徑大小寫、相對位置和副檔名。\input{chapters/a} 與檔案 chapters/A.tex 在區分大小寫的系統上不是同一個檔案。

子檔案出現 \documentclass 錯誤訊息

基礎 \input/\include 子檔案只能包含正文。把文件類和套件移回主檔案。

交叉引用變成 ??

在 EasyLaTeX 中從完整主檔案編譯,並等待本次任務結束。平台會處理引用所需的編譯輪次。若仍顯示 ??,檢查標籤拼寫、重複名稱、標籤位置,以及日誌中的第一處錯誤。

完整示例

主檔案 main.tex:

LaTeX
\documentclass[UTF8,a4paper,12pt]{ctexart}\ctexset{contentsname={目錄},listfigurename={插圖目錄},listtablename={表格目錄},figurename={圖},tablename={表}}\usepackage[colorlinks=true,linkcolor=blue]{hyperref}​\begin{document}\tableofcontents\input{chapters/introduction}\input{chapters/results}\end{document}

chapters/introduction.tex:

LaTeX
\section{引言}\label{sec:introduction}這是引言內容。

chapters/results.tex:

LaTeX
\section{結果}結果見第 \ref{sec:introduction} 節的研究背景。