我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

配置 GitHub 页面的发布源

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

对于项目页面站点和符合特定条件的其他页面站点,您可以配置 GitHub 页面 以从 master 分支上的 mastergh-pages/docs 文件夹中发布站点的源文件。

如果您的站点是含有名为 <username>.github.io<orgname>.github.io仓库的用户或组织页面,则无法从不同位置发布站点源文件。 含有此类仓库名称的用户和组织页面只能从 master 分支发布。

有关不同类型 GitHub 页面 站点的更多信息,请参阅“用户、组织和项目页面”。

没有用户名命名方案的仓库的默认源设置

发布站点源文件的默认设置取决于站点类型和站点仓库中所含的分支。

如果站点仓库中没有 mastergh-pages 分支,则 GitHub 页面 发布源将被设置为 None(无),您的站点将不会发布。

none-source-setting

创建 mastergh-pages 分支后,您可以将其中一个设置为发布源,以便您的站点能够发布。

如果您复刻或上传只含 mastergh-pages 分支的站点仓库,则将对该分支自动启用站点的源设置。

启用 GitHub 页面以从 mastergh-pages 发布站点

要选择 mastergh-pages 作为发布源,您的仓库中必须含有该分支。 如果没有 mastergh-pages 分支,您可以创建它们,然后返回源设置以更改发布源。

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

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

    仓库设置按钮

  3. 使用 Select source(选择源)下拉菜单选择 mastergh-pages 作为 GitHub 页面发布源。

    select-gh-pages-or-master-as-source

  4. 单击 Save(保存)

    click-save-next-to-source-selection

master 分支上的 /docs 文件夹发布 GitHub 页面站点

要从 master 分支上的 /docs 文件夹发布站点的源文件,您必须拥有 master 分支并且您的仓库必须:

GitHub 页面 将从 /docs 文件夹读取所有内容以发布站点,包括 CNAME 文件。 例如,通过 GitHub 页面 设置编辑自定义域时,该自定义域将写入 /docs/CNAME

提示:如果在启用后从 master 分支删除 /docs 文件夹,则站点无法生成,并且您将收到缺少 /docs 文件夹的页面生成错误消息

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

  2. master 分支上创建仓库根目录中的文件夹,名为 /docs

  3. 在仓库名称下,单击 Settings(设置)

    仓库设置按钮

  4. 使用 Select source(选择源)下拉菜单选择 master branch /docs folder(master 分支 /docs 文件夹)作为 GitHub 页面 发布源。

    select-master-branch-docs-folder-as-source

    提示:如果 master 分支上不存在 /docs 文件夹,则 master branch /docs folder(master 分支 /docs 文件夹)源设置不会作为选项出现。

  5. 单击 Save(保存)

    click-save-next-to-master-branch-docs-folder-source-selection

进一步阅读

问问别人

找不到要找的内容?

联系我们