在恐慌發作之前,先替研究所論文搭好 LaTeX 結構

給碩士與博士生:前置部分、章節引入、縮寫詞、學校的類別檔、編譯速度,以及 Git 歷史。

學位論文是附帶行政手續的長篇論文。LaTeX 很擅長處理長篇論文。至於行政手續,通常是一份 2009 年寫成的學校類別檔,而且上一次測試用的還是另一個版本的 TeX Live。

及早把結構搭起來,即使章節還是空的也一樣。最後一個月才在檔案之間搬移內容,正是交互參照和圖片路徑壞掉的原因。

接受類別檔,把其餘的部分隔開

把學校的 .cls(以及必要的 .bst 和標誌檔案)放進專案裡。不要改寫類別檔。把你的巨集、套件與章節內容,放在你自己掌控的檔案裡:

thesis/
main.tex
macros.tex
chapters/
figures/
university.cls

如果類別檔在現代引擎上壞掉,請依照無法編譯的學校類別檔來排查。在你投入 fontspec 之前,先確認論文辦公室接受哪一種引擎(pdfLaTeX、XeLaTeX 或 LuaLaTeX)。

口試委員會期待看到的前置部分

摘要、獻詞、致謝、目錄、圖表目錄使用羅馬數字頁碼;主要章節則使用阿拉伯數字。book 和 report 類別提供 \frontmatter 與 \mainmatter;以 article 為基礎的範本則需要手動使用 \pagenumbering。指南:先羅馬後阿拉伯。

標題頁的內容,往往必須和研究所提供的 Word 範例完全一致。請一字不差地照抄。在這裡發揮創意,會讓 PDF 被檢核清單退回。

把章節拆成檔案

一個根檔案,多個引入檔:

\include{chapters/intro}
\include{chapters/background}
\include{chapters/methods}
\include{chapters/results}
\include{chapters/conclusion}

即使共同作者協助撰寫那些會納入學位論文的論文,章節仍要由你自己掌握。把圖片放在 figures/chapter3/ 底下,這樣重新排序時路徑才會穩定。起草期間使用 \includeonly{chapters/methods},這樣每改一個方程式,就不必付出整本論文編譯的代價:拆分章節檔案。

標籤在整個專案中應該是唯一的(用 eq:ch3-main,而不是每個檔案都叫 eq:main)。專案層級的結構檢視與即時參照檢查,對一棵 200 頁的檔案樹很有幫助。

縮寫詞與符號

glossaries 套件功能強大,但很挑剔。對許多學位論文來說,在前置部分手動維護一份符號清單就夠了。如果你需要自動展開的縮寫詞,請在送件那一週之前,而不是那一週之中,預留一天學會 glossaries-extra。

把數學巨集定義在 macros.tex,並把這個檔案當成大家共同遵守的法則。符號在第 2 章和第 5 章之間走樣,等於送一份大禮給吹毛求疵的口試委員。

參考文獻

整本論文用一個 .bib,或是一小組經過謹慎合併的檔案。鍵值保持穩定。在平裝本送印之前先驗證:BibTeX 驗證工具。比對系所要求的樣式(數字式、作者年份式、大量使用腳註的人文學科樣式)。不要在同一個導言區裡混用 biblatex 和傳統的 BibTeX 組合。

速度

整本論文的編譯會越來越慢。圖片的草稿模式、\includeonly 和 TikZ externalize 能替你省回好幾個小時。筆記:縮短等待 PDF 的時間。

每週固定做一次「完整編譯」,這樣你仍能及早發現跨章節的失敗。

備份不等於歷史

Dropbox 的副本是備份。Git 則是論點如何演變的故事。章節能編譯時就提交(commit)。推送到私有的 GitHub 或 GitLab 遠端。

Oleafly (在新分頁開啟) 會為每個專案初始化一個真正的儲存庫,在編譯成功之後與閒置編輯之後建立檢查點,一鍵即可還原,同時提供專案層級的結構檢視,以及跨章節檔案仍然有效的 SyncTeX。這讓你更難跳過這個習慣。任何編輯器搭配謹慎的 Git 操作,也能做到同樣的紀律;論文不該靠你在第十八個月才想起要執行 git init。

口試委員會的回饋循環

為不會打開原始碼的讀者匯出 PDF。在 issue 或共用文件中追蹤意見,但修改要在 TeX 裡進行。當委員會成員退回掃描的批註 PDF 時,請在檔名中加上日期與版本,這樣你就知道它指的是哪一個原始碼提交。

平裝本與精裝本檢核清單

列印或送交之前:

  • 類別檔與引擎符合論文辦公室的規定。
  • 前置部分的頁碼正確;若有要求,須附簽名頁。
  • 所有 \ref/\cite 都能解析;沒有 [?]。
  • 若有要求,列出圖與表;圖說前後一致。
  • 邊界與字型大小通過檢核清單 PDF(印一頁測試)。
  • 送交後,將原始碼、PDF 和提交雜湊值(commit hash)封存。

圖、表與各種「目錄」頁面

許多論文辦公室要求附上圖目錄與表目錄。圖說必須前後一致,也不要把整個方法章節塞進一個 20 行的圖說裡。如果類別支援選用的簡短圖說,就為目錄使用簡短標題,在正文裡使用較長的說明性圖說。

抄襲與先前發表的論文

如果章節是把已發表的論文改編重組,請遵守學校對於納入已發表內容以及取得共同作者許可的規定。把每篇先前論文的錄用版 PDF 與論文章節一起放進版本控制,並附上一則說明,寫明改了什麼(符號、擴充的實驗、統一的引言)。

這個月就開始,不要等到動筆的那個月

在提出大綱的時候,就把骨架建起來。能編譯的空白章節,就算進度。後期的恐慌,大多來自結構上積欠的債,再加上一份頑固的類別檔,而不是科學上有缺口。及早還清這筆債。

所有貼文