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

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

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

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

本文内容

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

关于主题选择器

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

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

  • 如果已为仓库启用 GitHub Pages,主题选择器会将主题添加到当前发布源。
  • If your repository is public and GitHub Pages is disabled for your repository, using the theme chooser will enable GitHub Pages and configure the default branch as your publishing source.
  • 如果您的仓库是公共的,并且已对仓库禁用 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 网站上的“前页”。

延伸阅读

问问别人

找不到要找的内容?

联系我们