编写 LaTeX 并预览 PDF

在重要的编辑会话之后以及更改根文件、引擎、包集或文件夹结构之前，将项目导出为 ZIP。存档应包含源文件和在其他地方继续项目所需的添加资产。下载的PDF只是编译后的结果，不能替代可编辑的源码。打开 ZIP 并确认章节、参考书目文件、图像、自定义类和样式文件存在，然后再将其作为项目副本。

尽可能使用现有项目已指定的引擎。 pdfLaTeX 是许多已建立的文档和包的实用选择。当源需要广泛的 Unicode 文本、系统字体或 OpenType 字体功能时，XeLaTeX 通常更可取。更改引擎可能会影响字体规格、换行符、包行为和输出分页。如果不确定选择，请检查项目文档并比较代表性页面、方程、参考文献和非拉丁文本的干净编译。

从第一个有用的诊断开始，因为后来的消息通常是同一早期错误的结果。常见原因包括未知命令、不匹配的大括号、丢失文件、不正确的路径、所选引擎无法使用的包或不包含文档环境的根文档。一次纠正一个原因并重新编译。当错误指向生成的文件时，请检查创建受影响的目录、引文、标签或辅助条目的源命令。

交叉引用和参考书目可能需要多次成功编译，因为 LaTeX 首先写入辅助信息，然后在稍后的传递中读取它。确认每个标签都是唯一的，每个参考文献都使用准确的标签名称，引文关键字与参考书目条目匹配，并且参考书目文件包含在预期的工作流程中。在判断引用之前修复编译错误。如果问号仍然存在，请检查最早的引文或辅助文件诊断，并验证所选引擎和参考书目命令是否与项目匹配。

编译成功意味着生成了PDF，但并不意味着文档是正确的。检查标题页、页面顺序、标题、表格、图形、方程式、脚注、链接、引文、参考书目、页眉、页脚、页边距和分页符。查找过长的线条、剪裁的图形、缺失的字形、未解决的问号、意外的空白页和更改的字体替换。对于重要文档，以正常缩放和打印比例比较代表性页面，然后确认链接和复制的文本按预期运行。

识别预期的根 .tex 文件并保持章节、图像、参考书目、类和样式文件的相对路径一致。依赖 shell 命令、外部程序、不寻常的系统字体、不可用的软件包或不同的 TeX 发行版的项目在编译之前可能需要更改。当文件名的大小写与每个源引用完全匹配时，文件名是最安全的。导入后，首先编译一个小的已知部分，检查诊断，然后检查完​​整文档是否存在特定于包的差异或缺失的资产。