帮助中心
关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。
Git、GitHub 与 WebDAV
通过 Git 收发项目文件，或与 GitHub、外部网盘同步。
选择合适的连接方式
按团队习惯选择 Git、GitHub 同步或 WebDAV。教育版、Plus 和 Pro 可分别为项目配置这些连接。
操作步骤
- 想把项目拉到本机、用惯常的命令行流程干活，就用 Git。
- 如果事实来源是团队已经在评审和发版的那个仓库，就用 GitHub 同步。
- 如果项目必须落到机构或个人网盘而不是代码托管平台，就用 WebDAV。
- 同时用多种也没问题，但在连第二个之前，先想清楚哪一边算权威。
- 以谁的套餐为准有所不同：Git 访问取决于你自己的套餐，GitHub 和 WebDAV 同步则取决于项目所有者的套餐。
- 想从已经放在别处的文件开始，在仪表板上选择「从 GitHub 或 WebDAV 导入」。它会从仓库分支或 WebDAV 文件夹创建一个项目，并保持连接。
建立连接
按连接方式准备凭据，再到需要同步的项目中建立连接。
操作步骤
- 命令行 Git：在账户设置里打开访问令牌并创建 Git 令牌。在项目里展开 Git，复制仓库地址或 clone 命令，把令牌当作 HTTP Basic 密码。查看者可以 clone 和 pull；所有者和编辑者还可以向 main 推送。
- 落后于项目的推送，如果你和协作者改的是不同的文件，会自动合并。如果双方改了同一个文件，推送会被拒绝并列出相关路径：运行 git pull，解决冲突，再推送一次。
- GitHub 同步：在账户设置的外部连接里连接 GitHub，并为你选定的仓库安装 JointTex GitHub App。然后在项目的外部连接视图里打开 GitHub，选择已有的仓库和分支，查看完整的变更预览，再确认这次手动同步。
- JointTex 同步的是整个仓库根目录，.github/workflows 除外。含有子模块的仓库无法同步。同步始终是手动的：GitHub 上的改动只会在项目里被标出来，直到你选择「检查并同步」。
- 要使用新仓库，选择「在 GitHub 创建仓库」，必要时授予 GitHub App 访问它的权限，然后「刷新仓库列表」。对于空仓库，JointTex 会在首次同步时创建分支。
- WebDAV：在账户设置 › 外部连接里用根目录地址、用户名和应用密码保存一份可复用的预设，或者只为单个项目填写凭据。选好项目文件夹，测试连接，检查首次同步内容，然后连接。
保持 WebDAV 同步
WebDAV 文件夹只在有必要时才会被访问，所以只存在于远端的改动要等到下一次同步。
操作步骤
- 需要拉取只存在于远端的 WebDAV 改动时，用「立即同步」。可选的 WebDAV 自动同步只在 JointTex 项目发生变化后触发；连续失败三次会暂停，直到一次手动同步成功。
- 如果首次预览显示有冲突，建立连接不会改动任何文件；连接创建之后再处理这些冲突。
- 只为单个项目填写的凭据，之后可以用「保存为账户预设」留给其他项目使用。
解决冲突与管理权限
同步出现冲突时先查看差异，再决定保留哪一版；连接权限按项目角色管理。
操作步骤
- GitHub 或 WebDAV 报告冲突时，这次同步不会改动任何文件。
- 打开「审核冲突」，对比两个版本，选择保留哪一边（有时可以两边都留），并逐条提交决定；写入前 JointTex 会重新核对两侧。
- 用「应用到所有兼容文件」可以对许多文件一次做出同样的选择。无法显示为文本差异的文件，可以在决定之前把两个版本都下载下来。
- 项目所有者负责配置或解除 GitHub 和 WebDAV 连接；所有者和编辑者可以同步和解决冲突，查看者可以查看状态。
- 如果在冲突未解决时解除连接，两个版本在 30 天内仍可在「近期冲突归档」下下载，但无法再自动应用。
- 移除 GitHub 账号或 WebDAV 预设前，先把不用的项目解除连接。