目錄、圖目錄與表目錄

tableofcontents,以及為什麼第二次編譯很重要。

目錄、圖目錄與表目錄

LaTeX 的目錄不需要你自己建立或維護。你只要在想放目錄的地方放一個命令,LaTeX 就會根據你已經寫好的標題組出各個項目。圖目錄和表目錄也是如此,只是它們收集的是圖表說明文字,而不是標題。這是宣告結構直接見效的地方之一:改了節的名稱或移動了圖片,前置頁的內容會自動修正。

三個命令

\tableofcontents
\listoffigures
\listoftables

\tableofcontents 會在它所在的位置印出目錄,通常緊接在標題頁或摘要之後。每個有編號的 \chapter、\section 和 \subsection 都會連同編號、標題和頁碼列出,深度由 tocdepth 計數器決定,詳見標題課程。\listoffigures 和 \listoftables 對圖表說明文字做同樣的事,從每個 \caption{...} 取出文字。期刊論文裡不常見這兩個目錄,但學位論文通常兩者都要求,並放在目錄之後各自獨立的頁面。

為什麼第二次編譯很重要

結構有變動後,請編譯兩次。這不是迷信,而是這套機制的運作方式。編譯過程中,LaTeX 在第 2 頁時無法得知第 47 頁會出現什麼內容,所以它邊處理邊把每個標題和最終頁碼寫進輔助檔案(.toc、.lof、.lot)。\tableofcontents 讀取的是上一次執行留下的檔案。在全新的專案裡,這個檔案還不存在,所以第一次編譯會產生空白的目錄。新增或移動章節之後,目錄會顯示過時的標題或錯誤的頁碼,直到下一次執行為止。第二次編譯會讀取剛寫好的檔案,一切就對上了。執行 latexmk 或類似包裝工具的編輯器會替你處理重新編譯,所以你可能從來沒注意過。如果目錄看起來不對,在除錯其他問題之前,先再編譯一次。

加星號的節與目錄

加星號的節如果要出現在目錄裡,需要 \addcontentsline{toc}{section}{Title}。像 \section*{Acknowledgments} 這樣加星號的標題,會刻意略過編號和目錄檔案,所以如果你希望它被列出來,就要自己加上這個項目。這個命令的三個參數依序是要寫入的檔案(toc)、項目的層級(section),以及要顯示的文字。請把這一行緊接在加星號的標題之後,記錄下來的頁碼才會正確。

有個值得養成的習慣:分享 PDF 之前,先看一下目錄有沒有過時建置的明顯跡象,例如問號、缺少的項目,或最後一個項目沒有到達你的最後一章。幾乎都可以靠再編譯一次解決。自己先發現,比讓審稿人發現要省事得多。\ref 等命令也是靠同樣的輔助檔案機制運作,詳見交互參照。

返回 論文骨架