> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Web 编辑器中发布更改

> 保存你的工作并发布你对文档站点的更改。

<div id="publishing-workflows">
  ## 发布工作流
</div>

编辑器支持两种发布文档更新的工作流程。你使用的工作流程取决于存储库的 branch 保护规则以及你正在使用的 branch。

如果你的存储库具有需要审核的 branch 保护规则，编辑器会创建一个拉取请求（PR；亦称“合并请求”/Merge Request）。团队成员可以在更改上线之前审核你的更改。有关协作工作流和团队审核流程，请参阅 [Collaborate](/zh/editor/collaborate)。

如果没有保护规则，你的更改会合并到部署用分支并立即部署。

| branch 类型                                                                         | branch 保护 | 发布时会发生什么       |
| --------------------------------------------------------------------------------- | --------- | -------------- |
| <Tooltip headline="部署用分支" tip="用于发布到线上文档站点的 branch，通常为 'main'。">部署用分支</Tooltip>   | 无         | 提交并部署更改        |
| 部署用分支                                                                             | 需要拉取请求    | 创建一个拉取请求       |
| <Tooltip headline="功能分支" tip="一个隔离的 branch，你会在其中进行更新，然后再合并到部署用分支。">功能分支</Tooltip> | 无         | 将更改合并到部署用分支并部署 |
| 功能分支                                                                              | 需要拉取请求    | 创建一个拉取请求       |

<Tip>
  在你的 Git 服务提供商中配置 branch 保护规则以要求拉取请求。请参阅 GitHub 文档中的 [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) 或 GitLab 文档中的 [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/)。
</Tip>

<div id="save-changes">
  ## 保存更改
</div>

在编辑过程中，编辑器会跟踪你的更改。

* 新建或删除的文件。
* 页面内容的修改。
* 导航结构的更改。
* 媒体文件的上传和整理。
* 配置更新。

<Frame>
  <img src="https://mintcdn.com/anotherhorizon/JcCuRMYxa7xgY0h0/images/editor/toolbar-light.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=9ce44e98625b234d296eda9028f58fc6" alt="网页编辑器工具栏，显示一个待处理的更改。" className="block dark:hidden" width="884" height="84" data-path="images/editor/toolbar-light.png" />

  <img src="https://mintcdn.com/anotherhorizon/JcCuRMYxa7xgY0h0/images/editor/toolbar-dark.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=a5d4df0bce1556405aed2a701a55abec" alt="网页编辑器工具栏，显示一个待处理的更改。" className="hidden dark:block" width="884" height="84" data-path="images/editor/toolbar-dark.png" />
</Frame>

当你在部署用分支上工作时，更改会自动保存。

当你在功能分支上工作时，可以将更改以<Tooltip headline="Commit" tip="提交是在 Git 中保存你更改快照的操作。">提交</Tooltip>的形式保存到该分支。

<Frame>
  <img src="https://mintcdn.com/anotherhorizon/JcCuRMYxa7xgY0h0/images/editor/toolbar-branch-light.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=5811bbfeae4d90ebb4c06a73b4ab685a" alt="网页编辑器工具栏，显示一个待处理的更改，以及功能分支上的 Save as commit 按钮。" className="block dark:hidden" width="1180" height="84" data-path="images/editor/toolbar-branch-light.png" />

  <img src="https://mintcdn.com/anotherhorizon/JcCuRMYxa7xgY0h0/images/editor/toolbar-branch-dark.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=628e3118519f6374c15d32a1e54fb901" alt="网页编辑器工具栏，显示一个待处理的更改，以及功能分支上的 Save as commit 按钮。" className="hidden dark:block" width="1180" height="84" data-path="images/editor/toolbar-branch-dark.png" />
</Frame>

若要放弃更改，请在 **Changes** 下拉菜单中文件名旁单击 **Undo changes**。

<div id="publish-your-changes">
  ### 发布你的更改
</div>

如果你当前位于部署用分支，在工具栏中点击 **Publish**。根据你的工作流，要么在站点重新部署后你的更改会立即生效，要么你需要在 Git 提供商中创建一个拉取请求（PR；亦称“合并请求”/Merge Request）并将其合并。

如果你当前位于功能 branch，先保存你的更改，然后在工具栏中点击 **Publish**。根据你的工作流，要么在站点重新部署后你的更改会立即生效，要么你需要在 Git 提供商中创建一个拉取请求（PR；亦称“合并请求”/Merge Request）并将其合并。

## 解决冲突

当你的 branch 和部署用分支对同一文件做了互不兼容的更改时，就会发生冲突。

<div id="what-causes-conflicts">
  ### 冲突产生的原因
</div>

冲突会在以下情况下发生：

* 你和另一位团队成员编辑了同一文件中的相同行。
* 在一个 branch 中，文件被移动或删除，但在另一个 branch 中被修改。

<div id="resolve-conflicts">
  ### 解决冲突
</div>

当冲突导致无法执行发布或切换 branch 等操作时，编辑器会显示 Warning。要解决冲突，请按照编辑器中的提示选择要保留的更改。

<div id="commit-signing">
  ## 提交签名
</div>

在你的 [账户设置](https://dashboard.mintlify.com/settings/account) 中授权你的 GitHub 账号，即可用该账号对提交进行签名。若未完成授权，则由 Mintlify GitHub 应用为在网页编辑器中完成的提交进行签名。

将提交归属到你的账号有助于准确记录是谁对你的文档进行了更改。