真实项目中的文件

.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 文件往往就是解决办法,因为一次失败运行留下的过期 .aux 会毒害之后的每一次编译。

返回 打开闭环