跳转到主要内容
在更改进入你的线上站点之前先进行预览、请求审阅你的 pull request,并在编辑器中合并它。

实时预览

实时预览会在你编辑时渲染站点,无需构建步骤。在 Site 标签页中,点击顶部栏中的 Preview。预览会全屏打开。点击 Refresh preview 可重新加载,或点击 Close preview 返回编辑器。若要改为在新的浏览器标签页中打开预览,请开启 Open live preview in new tab。 若要编辑站点设置并查看其对内容的影响,请点击预览工具栏中的 Site settings,然后选择一个配置分区。 若要在预览旁边打开智能体,请点击预览工具栏中的 Ask agent。只有 editors 和 admins 才能在实时预览中使用智能体。
实时预览仅适用于公开站点以及受 Mintlify 认证保护的站点。

预览部署

当你的 feature branch 存在 pull request 时,Mintlify 会构建一个预览部署:一个临时 URL,你的更改会在其中以发布后完全一致的方式呈现。每当编辑器向该分支提交新更改时,预览都会重新构建。该 URL 由你项目的子域名和分支名称组合而成:<subdomain>-<branch-name>.mintlify.site。你可以在 Mintlify 机器人的 pull request 评论中找到确切的 URL。 预览 URL 默认可公开访问。若要将访问权限限制为你的 Mintlify 组织成员,请在仪表板的常规页面的 Previews 分区中启用预览认证。更多信息请参阅限制预览部署的访问权限。

该使用哪种预览

若要把同事引导到分支上的某个特定页面,请点击页面右上角的 More options,然后点击 Copy link。任何有权访问你 Mintlify 组织的人都可以在自己的编辑器会话中打开该链接。

审阅并合并 pull request

当你的分支存在 pull request 时,发布菜单会显示其已更改的文件和审阅状态,例如 Draft in progress、Review required、Changes requested 或 Approved。点击 View request 可在你的 Git 提供方中打开该 pull request。
如果分支仍有未解决的评论线程,发布菜单会显示一条警告,列出未解决评论的数量,以替代 Ready to publish 或 Approved。你仍然可以合并并发布。该警告用于提醒你先处理反馈。
  1. 点击顶部栏中的 Publish,然后点击 Request review。这会将 pull request 标记为可供审阅。
  2. 审阅者在你的 Git 提供方中批准 pull request。
  3. 点击 Publish,然后点击 Merge and publish。编辑器会合并 pull request,部署你的更改,并把你切换回 deployment branch。
如果 Mintlify 托管你的仓库并且不要求审批,发布菜单会改为显示 Publish,一步完成合并和部署。
在你的 Git 提供方中配置分支保护规则以要求使用 pull request。请参阅 GitHub 帮助中的 About protected branches,或 GitLab 帮助中的 Protected branches。

合并前比较更改

在发布菜单中点击任意已更改的文件,即可在 diff 视图中将其与已发布版本进行比较。若要退出 diff 视图,请点击顶部栏中的 Viewing changes。可视化模式会显示可视化 diff,source 模式会显示文本 diff。无法显示 diff 的文件(例如图片或已删除的文件)会出现在列表中,但无法点击。 出现在分支 diff 中的隐藏页面也可以从发布菜单中打开,即使它们并未出现在站点导航中。

pull request 的标题和描述

pull request 的标题来自你的分支标题。 如果你的分支存在打开的评论线程,Mintlify 会把这些线程的摘要添加到 pull request 描述中。请参阅协作。

审阅自动化运行

当自动化打开 pull request 时,在 Slack 通知或通知邮件中点击 View changes,即可在该自动化的分支上打开编辑器。编辑器会以 diff 视图打开,智能体会在旁边打开,并带有该自动化所做工作的上下文。 若要改为打开该自动化的预览部署,请在仪表板 Automations 页面的 Runs 标签页中,点击该运行上的 Preview。