Skip to main content

配置 GitHub Pages 站点的发布源

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

Who can use this feature

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 Pages 站点。 可以指定要用作发布源的分支和文件夹。 源分支可以是存储库中的任何分支,源文件夹可以是源分支上的存储库根目录 (/),也可以是源分支上的 /docs 文件夹。 将更改推送到源分支时,源文件夹中的更改将发布到 GitHub Pages 站点。

警告:如果你的站点管理员启用了公共页面,GitHub Pages 站点将在 Internet 上公开,即使该站点的存储库是私有的或内部的也是如此。 如果站点的存储库中有敏感数据,你可能想要在发布前删除数据。 有关详细信息,请参阅“为企业配置 GitHub Pages”和“关于存储库”。

从分支进行发布

  1. 确保你要用作发布源的分支已经存在于你的存储库中。
  2. 在 GitHub Enterprise Server 上,导航到站点的仓库。 1. 在存储库名称下,单击 “设置”。 “存储库设置”按钮
  3. In the "Code and automation" section of the sidebar, click Pages.
  4. 在“GitHub Pages”下,使用“无”或“分支”下拉菜单,选择发布源 。 用于选择发布源的下拉菜单
  5. (可选)使用下拉菜单选择发布源的文件夹。 用于选择发布源文件夹的下拉菜单
  6. 单击“ 保存”。 用于保存对发布源设置的更改的按钮

从分支进行发布疑难解答

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

如果选择任意分支上的 docs 文件夹作为发布源,稍后从存储库中的该分支中删除 /docs 文件夹,则站点不会生成,并且你将收到缺失 /docs 文件夹的页面生成错误消息。 有关详细信息,请参阅“对 GitHub Pages 站点的 Jekyll 生成错误进行故障排除”。