一個根檔案,多個章節
include 與 input 的差別、includeonly,以及一次只草擬一章。
一個根檔案,多個章節
把學位論文寫在單一個 .tex 檔案裡,大約寫到第二章就會開始痛苦:捲動取代了思考,而每次編譯都要處理全部內容。標準的解法是用一個根檔案存放文件類別與序言區,每一章各自放在獨立的檔案裡,再由根檔案把它們縫合起來。
根檔案
% main.tex\documentclass{report}\begin{document}\include{chapters/intro}\include{chapters/methods}\include{chapters/results}\end{document}main.tex 是你唯一需要編譯的檔案。每個 \include 會指名另一個檔案,不含 .tex 副檔名,在所有平台上都使用正斜線,並在那個位置把該檔案的內容載入。章節檔案本身只包含內容,通常以 \chapter{...} 開頭。它們自己沒有 \documentclass,也沒有 document 環境,因為它們是這份文件的片段,而不是一份獨立的文件。
include 與 input 的比較
這兩個載入指令的行為不同,而差異決定了在哪裡該用哪一個。\include 會在內容之前先換新的一頁,適合用於章節,並且為每個被載入的檔案各寫出一個獨立的 .aux 檔案,這正是能夠選擇性編譯的原因。\input 則是單純的文字貼入:不換頁,也沒有獨立的 .aux,而且可以巢狀放在另一個 input 裡。這讓 \input 成為比一章更小的片段的正確工具,例如放在自己檔案裡的大型表格,或是共用的巨集檔。有一條結構上的規則要記住:\include 不能巢狀放在被載入的檔案裡,而 \input 可以用在任何地方。
一次只草擬一章
\includeonly{chapters/methods}放在序言區時,\includeonly 會告訴 LaTeX 只處理列出的檔案,同時仍讀取所有其他檔案已儲存的 .aux 資料。編譯速度會大幅加快,而且因為其他章節的標籤與頁數是從它們的 .aux 檔案重播而來,你正在草擬的這一章裡的交叉參照與編號仍然正確。後半段正是要優先採用這個做法、而不是把 \include 行註解掉的理由:註解掉會完全忘記其他章節,使每一個指向它們的 \ref 都變成 ??。
完整建置時請把 \includeonly 那一行註解掉,而且在分享 PDF 之前,一定要做一次完整編譯,因為過期的 .aux 資料可能跟不上你在被排除章節中所做的修改。至於產生的資料夾裡哪些檔案是你的、哪些是自動產生的,請見真實專案中的檔案。