Skip to main content

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

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

People with admin permissions for a repository can use the theme chooser to add a theme to a GitHub Pages site.

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

关于主题选择器

Note: The Jekyll theme chooser is not supported for GitHub Pages sites that are published with a custom GitHub Actions workflow. If you build your site with Jekyll and publish your site with a custom GitHub Actions workflow, you can add a theme by editing the _config.yml file. For more information, see "Adding a theme to your GitHub Pages site using Jekyll."

主题选择器可用于向仓库添加 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. 在边栏的“Code and automation(代码和自动化)”部分中,单击 Pages

  4. 在“GitHub Pages”下,单击 Choose a theme(选择主题)Change theme(更改主题)选择主题按钮

  5. 在页面顶部单击所需的主题,然后单击 Select theme(选择主题)主题选项和选择主题按钮

  6. 系统可能会提示您编辑站点的 README.md 文件。

    • 要稍后编辑该文件,请单击 Cancel(取消)编辑文件时取消链接
    • 要现在编辑文件,请参阅“编辑文件”。

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

延伸阅读