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

使用主题选择器将主题添加到 GitHub Pages 站点

您可以将主题添加到 GitHub Pages 站点,以自定义站点的外观。

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。 For more information, see "GitHub's products."

本文内容

此文档对您有帮助吗?

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

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

做出贡献

或, 了解如何参与。

拥有仓库管理员权限的人可以使用主题选择器向 GitHub Pages 站点添加主题。

关于主题选择器

主题选择器可用于向仓库添加 Jekyll 主题。 有关 Jekyll 的更多信息,请参阅“关于 GitHub Pages 和 Jekyll”。

主题选择器如何工作取决于您的资源库是公共的还是私有的。

  • 如果已为仓库启用 GitHub Pages,主题选择器会将主题添加到当前发布源。
  • 如果您的仓库是公共的,并且已对仓库禁用 GitHub Pages,则使用主题选择器将启用 GitHub Pages 并将默认分支配置为发布源。
  • 如果您的仓库是公共的,并且已对仓库禁用 GitHub Pages,则必须先通过配置发布源来启用 GitHub Pages,然后才可使用主题选择器。

有关发布源的更多信息,请参阅“关于 GitHub Pages”。

如果以前曾手动向仓库添加 Jekyll 主题,则这些文件在使用主题选择器后也可能应用。 为避免冲突,请先删除所有手动添加的主题文件夹和文件,然后再使用主题选择器。 更多信息请参阅“使用 Jekyll 添加主题到 GitHub Pages 站点”。

使用主题选择器添加主题

  1. 在 GitHub 上,导航到站点的仓库。
  2. 在仓库名称下,单击 Settings(设置)
    仓库设置按钮
  3. 在“GitHub Pages”下,单击 Choose a theme(选择主题)Change theme(更改主题)
    选择主题按钮
  4. 在页面顶部单击所需的主题,然后单击 Select theme(选择主题)
    主题选项和选择主题按钮
  5. 系统可能会提示您编辑站点的 README.md 文件。
    • 要稍后编辑该文件,请单击 Cancel(取消)
      编辑文件时取消链接
    • 要立即编辑该文件,请参阅“编辑仓库中的文件”。

您选择的主题将自动应用到仓库中的 Markdown 文件。 要将主题应用到仓库中的 HTML 文件,您需要添加 YAML 前页,以指定每个文件的布局。 更多信息请参阅 Jekyll 网站上的“前页”。

延伸阅读

此文档对您有帮助吗?

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

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

做出贡献

或, 了解如何参与。