帮助中心
关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。
PDF 编译与预览
构建 LaTeX 或 Typst 文档、读懂日志,并选定编译方式。
本指南适用于
编译并查看结果
在编辑器里发起编译,查看生成的 PDF;遇到错误也能直接查看日志。
操作步骤
- 可以用快捷键、状态栏按钮,或 PDF 窗格上的编译按钮触发编译。
- 错误和警告会在「问题」标签页里分组显示;可按严重级别过滤,并用「定位源码」定位到具体行。
- 分组视图信息不够时,打开「输出」标签页查看原始日志(LaTeX 项目是 latexmk 的日志,Typst 项目是 Typst 自己的输出信息)。
- 可以直接在问题列表里让助手解释或修复某一条问题,也可以一次性修复全部。
- 编译进行中时,点击状态栏里或 PDF 窗格编译按钮上的「编译中…」可以停止它。
- 编译似乎在复用过期的辅助文件时,打开「编译」按钮旁边的编译菜单,选择「清除缓存并重新编译」。
CtrlS 或 CtrlEnter 编译项目;CtrlAltS 停止正在进行的编译;F8 和 ShiftF8 跳到下一个和上一个问题。
投稿前检查 PDF
「项目检查」有四个标签页:「源码检查」不编译、直接读源码,「文献核验」核对参考文献,「PDF」读取编译出的 PDF 本身以及最近一次编译的警告,找出出版方的检查工具或读者会注意到的问题,「最近编译」则列出这次编译自身的错误和警告。
操作步骤
- 在「源码检查」标签页点击「重新检查」,扫描根文件及其依赖:重复的标签和参考文献 key、未定义的文献引用和交叉引用、可能缺失的文件、图片和参考文献文件,以及需要 XeLaTeX 或 LuaLaTeX 的宏包,都会列出来。
- 先编译,然后打开「项目检查」并切换到 PDF 标签页。
- 未嵌入的字体和 Type 3(位图)字体会被报告;它们通常来自其他程序导出的图片。
- 未定义的引用、字体缺失的字符、超出页边距的行以及尺寸不同的页面各报告一次,并给出第一处位置。
- 比页面还高的图或表、仍然要求再运行一次的编译,以及编译失败后留下的上一次编译的 PDF,也会被报告。
- 在「源码检查」标签页打开「匿名投稿检查」后,PDF 元数据中写有作者时也会收到警告。
选择引擎和根文件
设置根文件和 LaTeX 引擎,让团队使用一致的编译方式。
操作步骤
- 打开项目设置,指定根 .tex 文件 —— 也就是包含 \documentclass、会被交给编译器的那个文件。
- 选择引擎:pdflatex、latex、xelatex 或 lualatex。用 fontspec 加载字体必须用 XeLaTeX 或 LuaLaTeX。
- 选择 TeX Live 版本;保持旧版本是复现旧构建结果最稳妥的办法。
- 设置编译模式:正常模式用于正式文档,快速(草稿)模式用于快速检查结构。
按自己的节奏编译
手动编译,或在停止输入后自动编译;每位成员都能自行设置。
操作步骤
- 打开自动编译,可在你停止输入后自动重建;也可以关掉,手动决定何时构建。
- 日志太长找不到真正原因时,打开「遇到第一个错误时停止」。
- 可以从光标跳到 PDF 中对应的位置,也可以在 PDF 上任意位置双击,或按住 Cmd/Ctrl 点击,跳回对应源码行。
- 从项目菜单下载编译好的 PDF,或在独立浏览器标签页中打开以便打印。
CtrlJ 从源码跳到 PDF。焦点在 PDF 中时,方向键、Page Up、Page Down、Home、End 和空格键滚动页面,+ 和 - 缩放,0 适应宽度,CtrlJ 从选中的文字或视图中央跳回源码;CtrlF 打开「在 PDF 中查找」。
