在 Web 编辑器中发布更改

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

​

发布工作流

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

• 创建拉取请求：如果你的存储库具有需要审核的 branch 保护规则，要求在更改合并到部署用分支之前必须先创建拉取请求，那么在你发布更改时，编辑器会创建一个拉取请求（PR；亦称“合并请求”/Merge Request）。
• 直接发布：如果没有保护规则，你的更改会在发布时合并到部署用分支并立即部署。

branch 类型	branch 保护	发布工作流
部署用分支	无	提交并部署更改
部署用分支	需要拉取请求	创建一个拉取请求
功能分支	无	将更改合并到部署用分支并部署更改
功能分支	需要拉取请求	创建一个拉取请求

在你的 Git 服务提供商中配置 branch 保护规则以要求拉取请求。请参阅 GitHub 文档中的 About protected branches 或 GitLab 文档中的 Protected branches。

​

保存更改

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

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

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

当你在功能分支上工作时，可以将更改以提交的形式保存到该分支。

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

​

发布更改

点击工具栏中的 Publish。根据你的工作流，你的更改会立即部署，或者在你的 Git 提供商中为你创建一个拉取请求（PR；亦称“合并请求”/Merge Request），供你合并。如果你在一个功能 branch 上，请在发布前先保存更改。

当没有待处理的更改，或者当前 branch 已经有打开的拉取请求时，Publish 按钮会被禁用。

​

解决冲突

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

​

冲突产生的原因

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

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

​

解决冲突

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

​

提交签名

在你的 账户设置 中授权你的 GitHub 账号，即可用该账号对提交进行签名。若未完成授权，则由 Mintlify GitHub 应用为在网页编辑器中完成的提交进行签名。

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