配置 GitHub 页面的发布源
GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。
对于项目页面站点和符合特定条件的其他页面站点,您可以配置 GitHub 页面
以从 master
分支上的 master
、gh-pages
或 /docs
文件夹中发布站点的源文件。
如果您的站点是含有名为 <username>.[hostname]
或 <orgname>.[hostname]
仓库的用户或组织页面,则无法从不同位置发布站点源文件。 含有此类仓库名称的用户和组织页面只能从 master
分支发布。
有关不同类型 GitHub 页面 站点的更多信息,请参阅“用户、组织和项目页面”。
没有用户名命名方案的仓库的默认源设置
发布站点源文件的默认设置取决于站点类型和站点仓库中所含的分支。
如果站点仓库中没有 master
或 gh-pages
分支,则 GitHub 页面 发布源将被设置为 None(无),您的站点将不会发布。
创建 master
或 gh-pages
分支后,您可以将其中一个设置为发布源,以便您的站点能够发布。
如果您分叉或上传只含 master
或 gh-pages
分支的站点仓库,则将对该分支自动启用站点的源设置。
启用 GitHub 页面以从 master
或 gh-pages
发布站点
要选择 master
或 gh-pages
作为发布源,您的仓库中必须含有该分支。 如果没有 master
或 gh-pages
分支,您可以创建它们,然后返回源设置以更改发布源。
-
在 GitHub Enterprise 上,导航到 GitHub 页面 站点的仓库。
-
在仓库名称下,单击 Settings(设置)。
-
使用 Select source(选择源)下拉菜单选择 master 或 gh-pages 作为 GitHub 页面发布源。
-
单击 Save(保存)。
从 master
分支上的 /docs
文件夹发布 GitHub 页面站点
要从 master
分支上的 /docs
文件夹发布站点的源文件,您必须拥有 master
分支并且您的仓库必须:
- 在仓库的根目录中含有
/docs
文件夹 - 不遵循仓库命名方案
<username>.[hostname]
或<orgname>.[hostname]
提示:如果在启用后从 master
分支删除 /docs
文件夹,则站点无法生成,并且您将收到缺少 /docs
文件夹的页面生成错误消息。
-
在 GitHub Enterprise 上,导航到 GitHub 页面 站点的仓库。
-
在
master
分支上创建仓库根目录中的文件夹,名为/docs
。 -
在仓库名称下,单击 Settings(设置)。
-
使用 Select source(选择源)下拉菜单选择 master branch /docs folder(master 分支 /docs 文件夹)作为 GitHub 页面 发布源。
提示:如果
master
分支上不存在/docs
文件夹,则 master branch /docs folder(master 分支 /docs 文件夹)源设置不会作为选项出现。 -
单击 Save(保存)。