Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

创建 GitHub Pages 站点

您可以在新仓库或现有仓库中创建 GitHub Pages 站点。

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。

注意: 组织所有者可以限制从组织拥有的存储库发布 GitHub Pages 站点。 有关详细信息,请参阅“管理组织的 GitHub Pages 站点发布”。

为站点创建仓库

可以为站点创建存储库或选择现有存储库。

如果存储库中并非所有文件都与站点相关,且要为存储库创建 GitHub Pages 站点,则能够为站点配置发布源。 例如,可以使用专用分支和文件夹保存站点源files.

如果要在现有存储库中创建站点,请跳至“创建站点”一节。

  1. 在任何页面的右上角,使用 下拉菜单选择“新建存储库”。 包含创建新存储库选项的下拉菜单 1. 使用“所有者”下拉菜单选择你想要拥有存储库的帐户。 新 GitHub 存储库的所有者菜单的屏幕截图。 菜单显示两个选项:“octocat”和“github”。 1. 输入仓库的名称和说明(可选)。 如果要创建用户或组织站点,则存储库必须命名为 <user>.github.io<organization>.github.io。 如果您的用户或组织名称包含大写字母,您必须小写字母。 有关详细信息,请参阅“关于 GitHub Pages”。 创建存储库字段 1. 选择仓库可见性。 有关详细信息,请参阅“关于仓库”。 用于选择存储库可见性的单选按钮 1. 选择“使用 README 初始化此存储库”。 1. 单击“创建存储库”。

创建站点

必须先在 GitHub Enterprise Server 上有站点的仓库,然后才可创建站点。 如果未在现有存储库中创建站点,请参阅“为站点创建存储库”。

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

  1. 在 GitHub Enterprise Server 上,导航到站点的仓库。 1. 确定要使用的发布源。 有关详细信息,请参阅“配置 GitHub Pages 站点的发布源”。

  2. 为站点创建入口文件。 GitHub Pages 将查找 index.htmlindex.mdREADME.md 文件,作为站点的入口文件。

    入口文件必须位于所选发布源的顶层。 例如,如果发布源是 main 分支上的 /docs 文件夹,则入口文件必须位于名为 main 的分支上的 /docs 文件夹。 1. 配置发布源。 有关详细信息,请参阅“配置 GitHub Pages 站点的发布源”。 1. 在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择 下拉菜单,然后单击“设置” 。

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  3. 在边栏的“代码和自动化”部分,单击“ 页面”。

  4. 若要查看已发布的网站,请在“GitHub Pages”下单击“ 访问网站”。 GitHub Pages 确认消息的屏幕截图,其中列出了站点的 URL。 在 URL 右侧,标有“访问网站”的按钮用深橙色框出。

    注意: 对站点的更改在推送到 GitHub Enterprise Server 后,最长可能需要 10 分钟才会发布。 如果一小时后仍然在浏览器中看不到 GitHub Pages 站点更改,请参阅“关于 GitHub Pages 站点的 Jekyll 构建错误”。

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

后续步骤

您可以通过创建更多新文件向网站添加更多页面。 每个文件都将在网站上与发布源相同的目录结构中。 例如,如果项目网站的发布源是 gh-pages 分支,并且你在 gh-pages 分支上创建了名为 /about/contact-us.md 的新文件,该文件将在 http(s)://<hostname>/pages/<username>/<repository>/about/contact-us.html 下。

您还可以添加主题以自定义网站的外观。 有关详细信息,请参阅“使用 Jekyll 向 GitHub Pages 站点添加主题”。

要更多地自定义您的站点,您可以使用 Jekyl - 内置 GitHub Pages 支持的静态站点生成器。 有关详细信息,请参阅“关于 GitHub 页面和 Jekyll”。

延伸阅读