Skip to main content
编辑时你的更改会自动保存，但只有在你发布之后才会出现在你的线上站点上。发布时会发生什么，取决于你在哪个分支上工作，以及该分支是否设置了分支保护。
如果编辑器工具栏中没有 Publish 按钮，说明你的 deployment 启用了自动发布，你的编辑会自动上线。如果没有分支选择器，请显示分支选择器。如果 Publish 菜单中只看到你自己的更改，请开启分级发布以查看所有人的更改。

​
待处理更改

在你的 deployment branch 上，编辑器会把以下内容记录为待处理更改，直到你发布它们：
  • 页面中的内容编辑
  • 新增或删除的页面
  • 导航结构的更改
  • 上传的媒体文件
  • 配置更新
点击工具栏中的 Publish 即可查看待处理更改。点击任意已更改的文件即可将其与已发布版本进行比较。

​
发布时会发生什么

  • Publish：将你的待处理更改提交到 deployment branch 并部署到你的线上站点。
  • Request review：将该分支的 pull request 标记为可供审阅。
  • Merge and publish：将 pull request 合并到 deployment branch 并进行部署。当 pull request 达到可供审阅或已获批准状态（取决于你仓库的审阅要求）后即可使用。
  • Create branch：当你无法发布到当前分支时，创建一个新的 feature branch。
每个分支同一时间只能进行一次发布。如果同事正在向同一分支发布，请等待其发布完成后再重试。
Mintlify 完成构建和部署后，你的线上站点才会更新。这通常需要 30 秒到几分钟。请在仪表板上查看部署状态。

​
无效的 MDX 会阻止发布

如果你分支上的任何页面存在无效的 MDX，编辑器会禁用 Publish 和 Request review 按钮，直到你修复它。将鼠标悬停在 Publish 上可查看有多少页面存在错误，然后以 source 模式打开每个页面查看并修复错误。有关详细信息，请参阅由于 MDX 无效导致发布按钮被禁用。

​
发布特定更改

当多人在你的 deployment branch 上有待处理更改时，分级发布设置控制 Publish 菜单显示哪些更改。 分级发布关闭（默认）：Publish 菜单仅显示你的更改。这包括你编辑过的文件、你和同事都编辑过的文件，以及没有记录作者的文件。Publish 和 Discard all 只对这些更改生效。如果同事有其他待处理更改，会显示提示说明他们的更改已隐藏。 分级发布开启：Publish 菜单会把待处理更改分为 Your changes 和 Modified by others。你的更改默认选中，其他人的更改默认未选中。使用复选框选择要发布的更改。每个分区都有各自的 Discard 按钮。 对于由你之外的成员编辑过的文件，会显示一个贡献者图标。将鼠标悬停在上面即可查看是谁编辑了该文件。
  • 分级发布仅在没有分支保护的 deployment branch 上生效。在 feature branch 上，发布会包含所有待处理更改。
  • 删除文件夹会删除其中所有页面。这些删除操作会一起发布。你无法只删除文件夹中的一部分。
  • 有些更改互相依赖，例如页面及其导航条目。如果你的选择忽略了某个被选更改所依赖的更改，发布会失败并显示错误。请调整你的选择以包含该依赖，然后再次发布。

​
在分支上工作

如果你不使用审阅工作流，可以直接在 deployment branch 上编辑。如果每项更改在上线前都需要审阅，请创建分支。 若要创建分支：
  1. 点击编辑器工具栏中的分支名称。在 deployment branch 上，该名称会带有 Live 徽章。
  2. 可选：在 Find a branch 中为分支输入标题。
  3. 点击 New branch。
如果你不输入标题，编辑器会以当前日期为分支命名。如果创建分支时你有待处理更改，编辑器会询问是 Bring them to this branch 还是 Leave them behind。无论哪种选择，你的原始分支都会保留其待处理更改。 在编辑器中创建的分支上进行的编辑会自动提交到该分支，通常在你停止编辑约 15 秒后。首次提交会打开一个针对 deployment branch 的 pull request。如果启用了默认创建草稿 pull request，pull request 会以草稿形式打开。 准备好之后，点击 Publish，然后点击 Request review。当你的 pull request 满足仓库的审阅要求后，点击 Merge and publish。编辑器会合并 pull request，并把你切换回 deployment branch。

​
管理分支

分支菜单会列出你的 deployment branch 以及带有打开 pull request 的分支，包括在编辑器之外打开的 pull request。每个分支都会显示其 pull request 状态。若要查找已合并或已关闭的分支，请按名称搜索。 若要重命名或删除分支，请在分支菜单中将鼠标悬停在其上并点击 Rename branch 或 Delete branch。删除分支会将其永久从你的仓库中移除，同时删除其上任何未发布的更改。

​
显示分支选择器

如果你的 deployment branch 没有分支保护，当你在 deployment branch 上工作时，编辑器会隐藏分支选择器。若要显示它，请点击顶部栏中的 More options，然后开启 Branches。此偏好设置仅对你生效。 当你的 deployment branch 具有分支保护，或你在 feature branch 上工作时，分支选择器始终显示。

​
解决冲突

当有人从编辑器之外向你的仓库推送时，编辑器会把他们的更改合并到你打开的页面中。通知会告诉你应用了多少次更新。 如果远程更改和你的编辑影响了页面的同一部分，编辑器会同时保留两个版本并高亮显示。查看高亮内容，保留你想要的版本，删除另一个版本。

​
提交签名

在你的账户设置中授权 GitHub 账户，即可用它签署 commit。未经授权时，编辑器中所做的 commit 由 Mintlify GitHub App 签署。

​
自动发布

如果你的 deployment 启用了自动发布，在你停止输入后不久，编辑器就会提交到你的 deployment branch。分支选择器和 Publish 按钮会被隐藏。没有待处理状态，也没有审阅环节。