用户、组织和项目页面
GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。
有两种基本类型的 GitHub 页面 站点:项目页面站点,以及用户和组织页面站点。 它们几乎相同,但有一些重要的区别。
项目页面站点连接到特定项目,并且站点文件位于项目仓库内的分支上。 用户和组织页面站点没有关联到特定项目,并且站点文件位于专用于 GitHub 页面 文件的特殊仓库中。
警告:如果 GitHub 页面 站点的 URL 包含以破折号开头或结尾或者有连续破折号的用户名或组织名称,则使用 Linux 浏览的用户在访问该站点时会收到服务器错误。要解决此问题,请更改您的 GitHub Enterprise 用户名以删除非字母数字字符。有关如何执行此操作的说明,请参阅“更改 GitHub 用户名。”
项目页面站点
项目页面站点的源文件位于与其项目相同的仓库中,并且从以下位置之一发布:
master
分支gh-pages
分支- 位于
master
分支中名为 "docs" 的文件夹
更多信息请参阅“配置 GitHub 页面 的发布源”。
构建项目页面站点
个人和组织帐户均可创建项目页面站点,并且两者创建项目页面站点的步骤相同。
如果在 您的 GitHub Enterprise Server 实例 上启用子域隔离,则项目页面站点构建后在以下位置提供:
- 个人帐户的项目页面站点在以下位置提供:
http(s)://pages.[hostname]/<username>/<projectname>/
。 - 组织帐户的项目页面站点在以下位置提供:
http(s)://pages.[hostname]/<orgname>/<projectname>/
。
如果在 您的 GitHub Enterprise Server 实例 上没有启用子域隔离,则项目页面站点构建后在以下位置提供:
- 个人帐户的项目页面站点在以下位置提供:
http(s)://[hostname]/pages/<username>/<projectname>/
。 - 组织帐户的项目页面站点在以下位置提供:
http(s)://[hostname]/pages/<orgname>/<projectname>/
。
更多信息请参阅“启用子域隔离”或联系您的站点管理员。
用户和组织页面站点
用户和组织页面站点的源文件位于使用 GitHub Enterprise 帐户名称命名的专用仓库的 master
分支中:
- 要创建用户页面站点,请使用命名方案
<username>.[hostname]
命名该仓库。 - 要创建组织页面站点,请使用命名方案
<orgname>.[hostname]
命名该仓库。
构建用户和组织页面站点
如果在 您的 GitHub Enterprise Server 实例 上启用子域隔离,则用户和组织页面站点构建后在以下位置提供:
- 用户页面站点在以下位置提供:
http(s)://pages.[hostname]/<username>
。 - 组织页面站点在以下位置提供:
http(s)://pages.[hostname]/<orgname>
。
如果在 您的 GitHub Enterprise Server 实例 上没有启用子域隔离,则用户和组织页面站点构建后在以下位置提供:
- 用户页面站点在以下位置提供:
http(s)://[hostname]/pages/<username>
。 - 组织页面站点在以下位置提供:
http(s)://[hostname]/pages/<orgname>
。
更多信息请参阅“启用子域隔离”或联系您的站点管理员。
用户页面站点可通过任何帐户进行构建。 它们还可使用部署密钥自动执行该过程。 更多信息请参阅 GitHub 开发者文档中的“管理部署密钥”。
组织页面站点可通过具有仓库推送权限的任何成员进行构建。 要自动执行构建,您可以将计算机用户设置为组织的成员。 更多信息请参阅“管理部署密钥”。组织页面站点不支持部署密钥。