Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
 

 

使用主题选择器将主题添加到 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 网站上的“前页”。

延伸阅读