帮助中心

关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。

PDF 编译与预览

构建 LaTeX 或 Typst 文档、读懂日志,并选定编译方式。

本指南适用于

编译并查看结果

在编辑器里发起编译,查看生成的 PDF;遇到错误也能直接查看日志。

操作步骤

  1. 可以用快捷键、状态栏按钮,或 PDF 窗格上的编译按钮触发编译。
  2. 错误和警告会在「问题」标签页里分组显示;可按严重级别过滤,并用「定位源码」定位到具体行。
  3. 分组视图信息不够时,打开「输出」标签页查看原始日志(LaTeX 项目是 latexmk 的日志,Typst 项目是 Typst 自己的输出信息)。
  4. 可以直接在问题列表里让助手解释或修复某一条问题,也可以一次性修复全部。
  5. 编译进行中时,点击状态栏里或 PDF 窗格编译按钮上的「编译中…」可以停止它。
  6. 编译似乎在复用过期的辅助文件时,打开「编译」按钮旁边的编译菜单,选择「清除缓存并重新编译」。

或 编译项目; 停止正在进行的编译; 和 跳到下一个和上一个问题。

投稿前检查 PDF

「项目检查」有四个标签页:「源码检查」不编译、直接读源码,「文献核验」核对参考文献,「PDF」读取编译出的 PDF 本身以及最近一次编译的警告,找出出版方的检查工具或读者会注意到的问题,「最近编译」则列出这次编译自身的错误和警告。

操作步骤

  1. 在「源码检查」标签页点击「重新检查」,扫描根文件及其依赖:重复的标签和参考文献 key、未定义的文献引用和交叉引用、可能缺失的文件、图片和参考文献文件,以及需要 XeLaTeX 或 LuaLaTeX 的宏包,都会列出来。
  2. 先编译,然后打开「项目检查」并切换到 PDF 标签页。
  3. 未嵌入的字体和 Type 3(位图)字体会被报告;它们通常来自其他程序导出的图片。
  4. 未定义的引用、字体缺失的字符、超出页边距的行以及尺寸不同的页面各报告一次,并给出第一处位置。
  5. 比页面还高的图或表、仍然要求再运行一次的编译,以及编译失败后留下的上一次编译的 PDF,也会被报告。
  6. 在「源码检查」标签页打开「匿名投稿检查」后,PDF 元数据中写有作者时也会收到警告。

选择引擎和根文件

设置根文件和 LaTeX 引擎,让团队使用一致的编译方式。

操作步骤

  1. 打开项目设置,指定根 .tex 文件 —— 也就是包含 \documentclass、会被交给编译器的那个文件。
  2. 选择引擎:pdflatex、latex、xelatex 或 lualatex。用 fontspec 加载字体必须用 XeLaTeX 或 LuaLaTeX。
  3. 选择 TeX Live 版本;保持旧版本是复现旧构建结果最稳妥的办法。
  4. 设置编译模式:正常模式用于正式文档,快速(草稿)模式用于快速检查结构。

按自己的节奏编译

手动编译,或在停止输入后自动编译;每位成员都能自行设置。

操作步骤

  1. 打开自动编译,可在你停止输入后自动重建;也可以关掉,手动决定何时构建。
  2. 日志太长找不到真正原因时,打开「遇到第一个错误时停止」。
  3. 可以从光标跳到 PDF 中对应的位置,也可以在 PDF 上任意位置双击,或按住 Cmd/Ctrl 点击,跳回对应源码行。
  4. 从项目菜单下载编译好的 PDF,或在独立浏览器标签页中打开以便打印。

从源码跳到 PDF。焦点在 PDF 中时,方向键、Page Up、Page Down、Home、End 和空格键滚动页面,+ 和 - 缩放,0 适应宽度, 从选中的文字或视图中央跳回源码; 打开「在 PDF 中查找」。

问题、缺陷与建议在 JointTex 论坛向社区提问、报告问题,或为功能建议投票。
账户、账单或隐私问题?有关账户、订阅或个人数据的事项,请发送邮件给我们的支持团队。
[email protected]
JointTex

Browser compatibility

JointTex could not start

The application did not finish loading. Check your connection, then try again.

Supported versions

  • Chrome and Edge 88 or later
  • Firefox 84 or later
  • Safari and iOS Safari 14 or later
Reload