帮助中心
关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。
使用桌面应用
在 macOS、Windows 或 Linux 上安装 JointTex、登录，并用你自己电脑上的 TeX 编译。
安装并登录
桌面应用在一个独立的窗口里，显示和网页版相同的项目、合著者和历史。
操作步骤
- 在项目页打开账户菜单，选择「下载桌面应用」，或者从网站页脚打开下载页。
- 选择适合你电脑的下载：macOS 选 Apple 芯片或 Intel，Windows 选安装程序，Linux 选 AppImage、.deb 或 .rpm。
- 打开应用并选择「使用浏览器登录」；浏览器会打开并显示一个登录代码，应用里也会显示同一个代码。
- 核对浏览器里的代码和应用显示的是同一个，然后选择「继续」。应用就会以已登录的状态打开。
- 如果不想经过浏览器，可以选择「改为在此窗口中登录」。
在本机编译
在桌面应用里，项目可以用你已有的 TeX 构建，或者用容器里的 TeX Live 构建，而不是在 JointTex 服务器上。
操作步骤
- 在项目里打开「设置」，进入「编译」，找到「编译位置」。
- 选择「本机」使用这里安装的 TeX Live、MacTeX 或 MiKTeX，选择「本机（Docker）」或「本机（Podman）」在与你的文件隔离的容器里构建，或者选择「JointTex 服务器」。
- 看一下设置下方的那行文字：它会写出找到的本机 TeX，或者说明缺了什么。
- 第一次时，应用会询问「在本机编译？」。如果你信任一起写作的人，就选择「允许」；之后可以通过菜单项「本机编译权限…」更改。
- 照常编译。PDF、「问题」标签页以及 PDF 和源码之间的跳转都和原来一样。
窗口与更新
应用可以并排打开多个项目，并在有新版本时告诉你。
操作步骤
- 选择「文件 → 新建窗口」，再打开一个显示项目列表的窗口。
- 在项目页某个项目的菜单里选择「在新窗口中打开」，让该项目独占一个窗口。
- 在 macOS 上从应用菜单、在 Windows 和 Linux 上从「文件」菜单选择「检查更新…」。
- 有可用更新时，选择「下载」，然后打开下载的安装程序，替换你现有的版本。
CtrlN 打开新窗口。CtrlW 关闭当前标签页，这在浏览器里是做不到的。
本机编译失败时
在本机编译取决于这里安装了什么，所以大多数失败要在文档之外解决。
操作步骤
- 未找到 TeX 安装：安装 TeX Live 或 MiKTeX，或者把「编译位置」设为「JointTex 服务器」。
- 未找到 latexmk：BasicTeX 这类精简安装不包含它。在终端运行 tlmgr install latexmk（macOS 上为 sudo tlmgr install latexmk），或者在 MiKTeX Console 里安装 latexmk 宏包。
- Docker 或 Podman 已安装但未运行：启动它，或者选择另一个编译位置。
- 未允许使用本机 TeX 编译：稍等几秒后再次编译会重新询问，或者从菜单里的「本机编译权限…」更改。
- 项目中有文件名无法在本机写入：重命名该文件，或者改为在 JointTex 服务器上编译。
- 无法关联源码与 PDF 位置：安装你的 TeX 发行版中的 synctex 程序，或者改为在 JointTex 服务器上编译。