Skip to main content

此版本的 GitHub Enterprise Server 已于以下日期停止服务 2023-09-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

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

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

从分支进行发布

  1. 确保你要用作发布源的分支已经存在于你的存储库中。

  2. 在 GitHub Enterprise Server 上,导航到站点的仓库。

  3. 在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。 存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  4. 在边栏的“代码和自动化”部分中,单击“ Pages”。

  5. 在“GitHub Pages”下,使用分支下拉菜单,选择发布源。 GitHub 存储库中 Pages 设置的屏幕截图。 用于为发布源选择分支的菜单(标有“无”)用深橙色框出。

  6. (可选)使用文件夹下拉菜单选择发布源的文件夹。 GitHub 存储库中 Pages 设置的屏幕截图。 用于为发布源选择文件夹的菜单(标有“/(根)”)用深橙色框出。

  7. 单击“ 保存”。

从分支进行发布疑难解答

Note: If your repository contains symbolic links, you will need to publish your site using a GitHub Actions workflow. For more information about GitHub Actions, see "GitHub Actions 文档."

注释

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

  • 由使用 GITHUB_TOKEN 的 GitHub Actions 工作流推送的提交不会触发 GitHub Pages 生成。

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