真實專案中的檔案

.tex、.bib、.cls、.sty,以及你不該提交的自動產生雜物。

真實專案中的檔案

編譯之後打開任何一個真實 LaTeX 專案的資料夾,你會發現檔案遠比你自己寫的多得多。這讓多數初學者很意外,而怕刪錯東西的恐懼,讓資料夾永遠雜亂。能釐清這件事的區分是:有些檔案是你編輯的原始碼,有些是範本或套件提供的樣式,其餘則是自動產生的暫存空間,編譯器每次執行都會重新建立。

你自己寫的檔案

你的 .tex 檔案存放實際的文件內容:文字、章節、圖片與數學公式。.bib 檔案是你的參考文獻資料庫,每一篇你可能引用的論文或書籍就是一筆條目;你可以手動維護,也可以從 Zotero 這類參考文獻管理工具匯出。這些是值得備份並納入版本控制的檔案,因為其他一切都可以從它們重新建置出來。

範本提供的檔案

.cls 檔案定義一個文件類別,也就是你在 \documentclass{...} 中指名的東西。期刊與會議會提供自己的類別,讓每份投稿稿件看起來一致,而你幾乎不會去編輯它。.sty 檔案是套件:用 \usepackage 載入、可重複使用的巨集與設定。你只有在想讓好幾份文件共用自訂指令時,才會自己寫一個。.bst 檔案描述 BibTeX 的引用樣式,同樣通常只是由發表場合提供、直接放進去即可。

編譯器產生的檔案

.aux 檔案在多次編譯之間儲存交叉參照與引用資料;絕對不要編輯它,可以放心刪除,因為下次編譯會重新寫入。.log 檔案記錄編譯器做的所有事,只有在出問題時才值得打開。.pdf 才是你真正想要的輸出。

副檔名用途要手動編輯嗎?
.tex原始文件與章節要
.bib參考文獻資料庫要(或從 Zotero 匯出)
.cls文件類別很少,如出版單位的範本
.sty套件/樣式檔撰寫自己的巨集時
.bstBibTeX 樣式很少
.aux交叉參照資料不要:自動產生
.log編譯器記錄檔除錯時閱讀
.pdf輸出檢視/提交

能隨規模成長的專案結構

paper/
main.tex
chapters/
figures/
refs.bib

最上層的一個 main.tex 作為進入點,章節放在各自的資料夾並以 \input 或 \include 載入,圖片放在 figures/,參考文獻則集中在一個 refs.bib。無論專案是四頁的論文還是一本學位論文,這種結構都容易管理。拆分章節檔案說明了這些部分如何串在一起。

如果你使用 Git,請把 *.aux、*.log 與其他自動產生的檔案加進 .gitignore,這樣你的歷史記錄只會追蹤真正的原始碼。Oleafly 專案是磁碟上的一般資料夾,所以這項建議在那裡同樣適用。最常見的失誤剛好相反:在追查古怪的編譯錯誤時,往往刪掉 .aux 檔案就能解決,因為某次失敗的執行留下的過期檔案,可能會讓之後的每次編譯都出問題。

返回 打開循環