Skip to main content

配置 GitHub Pages 站点的发布源

如果您使用 GitHub Pages 站点的默认发布源,您的站点将自动发布。 您也可以选择从不同的分支或文件夹发布您的站点。

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。 更多信息请参阅“GitHub 的产品”。

有关发布源的更多信息,请参阅“关于 GitHub Pages”。

选择发布源

在配置发布源之前,请确保您要用作发布源的分支已经存在于您的仓库中。

  1. 在 GitHub 上,导航到站点的仓库。

  2. 在仓库名称下,单击 Settings(设置)仓库设置按钮

  3. 在边栏的“Code and automation(代码和自动化)”部分中,单击 Pages

  4. 在“GitHub Pages”下,使用 None(无)Branch(分支)下拉菜单选择发布源。 用于选择发布源的下拉菜单

  5. (可选)使用下拉菜单选择发布源的文件夹。 用于选择发布源文件夹的下拉菜单

  6. 单击 Save(保存)用于保存对发布源设置的更改的按钮

GitHub Pages 站点发布问题疑难排解

注意:如果您的网站尚未自动发布,请确保具有管理员权限和经过验证的电子邮件地址的人员已推送到发布源。

如果选择任意分支上的 docs 文件夹作为发布源,然后从仓库的该分支中删除了 /docs 文件夹,则您的站点将不会构建,并且您将收到提示缺失 /docs 文件夹的页面构建错误。 更多信息请参阅“关于 GitHub Pages 站点的 Jekyll 构建错误疑难排解”。

GitHub Pages 站点将始终使用 GitHub Actions 工作流程运行进行部署,即使您已将 GitHub Pages 站点配置为使用其他 CI 工具构建也是如此。 大多数外部 CI 工作流程通过将构建输出提交到仓库的 gh-pages 分支来“部署”到 GitHub Pages,并且通常包含一个 .nojekyll 文件。 发生这种情况时, GitHub Actions 工作流程将检测分支不需要构建步骤的状态,并且仅执行将站点部署到 GitHub Pages 服务器所需的步骤。

若要查找构建或部署的潜在错误,可以通过查看仓库的工作流程运行来检查 GitHub Pages 站点的工作流程运行情况。 更多信息请参阅“查看工作流程运行历史记录”。 有关如何在出现错误时重新运行工作流程的详细信息,请参阅”重新运行工作流程和作业“。

Note: GitHub Actions workflow runs for your GitHub Pages sites are in public beta for public repositories and subject to change. GitHub Actions workflow runs are free for public repositories.