如果你在 Account settings 或编辑器中看不到 GitHub 选项,请让管理员启用 GitHub 同步。
关联你的 GitHub 账户
这只需要做一次。1
打开账户设置
点击 Account,然后点击 Account settings。滚动到 GitHub,点击 Link。

账户设置中的 GitHub
2
在 GitHub 上授权
GitHub 会打开。如有要求请登录,然后授权该应用。
3
检查关联
你会回到账户设置,按钮现在显示为 Unlink。

你的 GitHub 账户已关联

账户未关联时的提示
导入仓库
这会从 GitHub 仓库创建一个新项目,并且已与该仓库关联。1
打开导入对话框
在项目页面中,点击 New project,然后点击 Import from GitHub。

New project 菜单
当你拥有项目后才会出现 New project。欢迎页面上的 Create a new project 菜单没有导入功能,因此请先创建一个空白项目。
2
选择仓库
点击仓库旁边的 Import to Overleaf。列表包含你的仓库以及你所在组织的仓库。
如果缺少某个组织的仓库,请点击 Can’t see what you’re looking for?,查看 GitHub 关于为该组织批准应用的帮助。

你的 GitHub 仓库
3
检查项目
新项目会打开,并包含仓库中的文件。

导入的项目
将项目导出到新仓库
这会从你拥有的项目创建一个仓库,并将两者关联。项目只能通过这种方式或导入来关联:你无法将它关联到已存在的仓库。1
在编辑器中打开 GitHub
打开项目。在左侧栏中点击 Integrations,然后点击 GitHub。

Integrations 面板
2
填写仓库信息
选择 Owner,可以是你自己,也可以是你所在的某个组织。Repository Name 默认为项目名称。描述是可选的,Private 默认处于选中状态。点击 Create a GitHub repository。

Export Project to GitHub
3
检查关联
对话框现在显示 This project is linked to 以及仓库名称。

项目已关联
同步
1
打开同步对话框
打开已关联的项目。在左侧栏中点击 Integrations,然后点击 GitHub。Recent commits in GitHub 列出了将要进入项目的内容。

GitHub 中有一个新提交在等待
2
描述你的更改
如果你在项目中做了更改,会出现提交信息输入框。它是可选的:如果留空,提交名称为 
Updates from Overleaf。
你的更改的提交信息
3
点击 Sync
点击 Sync。来自 GitHub 的新提交会进入项目,你的更改会推送到仓库的默认分支。如果两边修改了不同的内容,系统会为你合并。
4
检查结果
对话框显示 No new commits in GitHub since last merge.,提交信息输入框也消失了。编辑器中的文件和 GitHub 上的提交都已是最新状态。

一切已同步
如果两边修改了相同的行
对话框会提示无法合并更改,并给出一个新分支overleaf-YYYY-MM-DD-HHMMSS,其中保存了你的更改。

冲突
- 在 GitHub 上或使用 Git 将该分支合并到默认分支。在此期间你可以关闭对话框:再次打开时它会显示相同的消息。
- 点击 I have manually merged. Continue。合并后的结果会进入项目。
- 该分支会保留在 GitHub 上。不再需要时请将其删除。
取消项目关联
当你不再希望项目同步时执行此操作。只有项目所有者可以执行。1
点击 Unlink
在同步对话框中,点击 Unlink。
2
确认
点击 Confirm。关于订阅的提示不会妨碍你再次关联该项目。

确认取消关联
3
检查结果
对话框现在显示 Export Project to GitHub。项目和仓库都会保留各自的内容。要再次同步,请将项目导出到新仓库,或将仓库导入到新项目。
取消关联你的 GitHub 账户
在 Account settings 的 GitHub 下,点击 Unlink,然后在对话框中再次点击 Unlink。
取消关联你的账户
关于共享项目中谁可以做什么,请参阅谁可以关联和同步。每位进行同步的协作者都需要关联自己的 GitHub 账户。

