配置 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”。

选择发布源

在配置发布源之前,请确保要用作发布源的分支 或文件夹 已存在于您的仓库中。 例如,从仓库的 master 分支上的 /docs 文件夹中发布项目站点之前,您或协作者必须在仓库的默认 master 分支上创建 /docs 文件夹。

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

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

  3. 在“GitHub Pages”下,使用 Source(源)下拉菜单选择发布源。 用于选择发布源的下拉菜单

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

:如果网站 的源文件位于默认发布源 - master(对于用户和组织站点)或 gh-pages(对于项目站点)- 但您的站点 未自动发布,请确保有一个拥有管理权限和经验证的电子邮件地址的人已推送到默认发布源。

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

此文档对您有帮助吗?隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。