真实项目中的文件
.tex、.bib、.cls、.sty,以及不该提交的生成垃圾文件。
真实项目中的文件
编译之后,打开任何一个真实 LaTeX 项目的文件夹,你都会发现比你自己写的多得多的文件。这让多数初学者感到意外,而对删错东西的恐惧,让文件夹永远杂乱。有一个区分能理清这件事:有些文件是你编辑的源文件,有些是模板或宏包提供的样式,其余的则是编译器每次运行都会重新生成的临时文件。
你来写的文件
你的 .tex 文件存放真正的文档:正文、章节、图和公式。.bib 文件是你的参考文献数据库,每篇可能引用的论文或书籍对应一个条目;你可以手工维护,也可以从 Zotero 这样的文献管理器导出。这些是值得备份并纳入版本控制的文件,因为其他一切都可以从它们重新构建出来。
模板提供的文件
.cls 文件定义文档类,也就是你在 \documentclass{...} 里写下名字的那个东西。期刊和会议各自提供自己的文档类,让每份投稿看起来都一样,你几乎从不需要编辑它。.sty 文件是宏包:用 \usepackage 加载的可复用宏和设置。只有当你想在多份文档之间共享自定义命令时,才需要自己写一个。.bst 文件描述一种 BibTeX 引用样式,同样通常只是由发表渠道放进来的。
编译器生成的文件
.aux 文件在多轮编译之间保存交叉引用和引用数据;永远不要编辑它,也可以放心删除,因为下一次编译会重写它。.log 文件记录编译器所做的一切,只有出问题时才值得打开。.pdf 才是你真正想要的输出。
| 扩展名 | 作用 | 要手工编辑吗? |
|---|---|---|
.tex | 源文档和章节 | 要 |
.bib | 参考文献数据库 | 要(或从 Zotero 导出) |
.cls | 文档类 | 很少,出版方的模板 |
.sty | 宏包/样式文件 | 编写自己的宏时 |
.bst | BibTeX 样式 | 很少 |
.aux | 交叉引用数据 | 不要:自动生成 |
.log | 编译日志 | 调试时阅读 |
.pdf | 输出 | 查看/提交 |
可扩展的项目布局
paper/ main.tex chapters/ figures/ refs.bib顶层的一个 main.tex 充当入口,各章放在自己的文件夹里,用 \input 或 \include 引入,图片放在 figures/ 里,参考文献则保存在同一个 refs.bib 中。无论项目是一篇四页的论文还是一篇学位论文,这种布局都易于管理。拆分章节文件展示了这些部分如何衔接。
如果你使用 Git,把 *.aux、*.log 和其他生成的文件加入 .gitignore,这样你的历史就只跟踪真正的源文件。Oleafly 项目是磁盘上的普通文件夹,所以这条建议在那里同样适用。最常见的错误则是反过来的那种:在追查某个古怪的编译错误时,删除 .aux 文件往往就是解决办法,因为一次失败运行留下的过期 .aux 会毒害之后的每一次编译。