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

拥有仓库管理员权限的人可以使用主题选择器向 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. 在左侧边栏中，单击 Pages（页面）。

   

4. 在“GitHub Pages”下，单击 Choose a theme（选择主题）或 Change theme（更改主题）。

   

5. 在页面顶部单击所需的主题，然后单击 Select theme（选择主题）。

   

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

   • 要稍后编辑该文件，请单击 Cancel（取消）。
     
   • 要立即编辑该文件，请参阅“编辑仓库中的文件”。

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

延伸阅读

• Jekyll 网站上的主题