关于主题选择器
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 站点”。
使用主题选择器添加主题
-
在 GitHub 上,导航到站点的仓库。
-
在仓库名称下,单击 Settings(设置)。
-
在边栏的“Code and automation(代码和自动化)”部分中,单击 Pages。
-
在“GitHub Pages”下,单击 Choose a theme(选择主题)或 Change theme(更改主题)。
-
在页面顶部单击所需的主题,然后单击 Select theme(选择主题)。
-
系统可能会提示您编辑站点的 README.md 文件。
- 要稍后编辑该文件,请单击 Cancel(取消)。
- 要现在编辑文件,请参阅“编辑文件”。
- 要稍后编辑该文件,请单击 Cancel(取消)。
您选择的主题将自动应用到仓库中的 Markdown 文件。 要将主题应用到仓库中的 HTML 文件,您需要添加 YAML 前页,以指定每个文件的布局。 更多信息请参阅 Jekyll 网站上的“前页”。
延伸阅读
- Jekyll 网站上的主题