拥有仓库写入权限的人员可以使用 Jekyll 向 GitHub Pages 网站添加主题。
如果您从分支发布,则更改将自动发布到您的网站的发布源中。如果您从自定义 GitHub Actions 工作流发布,则更改将在您的工作流触发时发布(通常由对默认分支的推送触发)。如果您想先预览更改,可以在本地进行更改,而不是在 GitHub 上进行更改。然后,在本地测试您的网站。有关更多信息,请参阅“使用 Jekyll 在本地测试您的 GitHub Pages 网站”。
添加主题
-
在 GitHub 上,导航到您的网站仓库。
-
导航到您的网站的发布源。有关更多信息,请参阅“配置 GitHub Pages 网站的发布源”。
-
导航到 _config.yml。
-
在文件视图的右上角,单击 以打开文件编辑器。
注意:您可以选择使用 github.dev 代码编辑器 来编辑和提交文件,而不是使用默认文件编辑器。您可以通过选择 下拉菜单并单击 github.dev 来选择。您也可以通过单击 GitHub Desktop 克隆仓库并在本地通过 GitHub Desktop 编辑文件。
-
在文件中添加一个新行以用于主题名称。
- 要使用支持的主题,请键入
theme: THEME-NAME
,将 THEME-NAME 替换为主题名称,如主题仓库的_config.yml
中所示(大多数主题遵循jekyll-theme-NAME
命名约定)。有关支持主题的列表,请参阅 GitHub Pages 网站上的“支持的主题”。例如,要选择 Minimal 主题,请键入theme: jekyll-theme-minimal
。 - 要使用 GitHub 上托管的任何其他 Jekyll 主题,请键入
remote_theme: THEME-NAME
,将 THEME-NAME 替换为主题名称,如主题仓库的 README 中所示。
- 要使用支持的主题,请键入
-
单击 提交更改...
-
在“提交消息”字段中,键入一个简短且有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。有关更多信息,请参阅“创建具有多个作者的提交”。
-
如果您在 GitHub.com 上的帐户中关联了多个电子邮件地址,请单击电子邮件地址下拉菜单并选择要作为 Git 作者电子邮件地址使用的电子邮件地址。此下拉菜单中仅显示已验证的电子邮件地址。如果您启用了电子邮件地址隐私,则无回复将是默认的提交作者电子邮件地址。有关无回复电子邮件地址可能采取的确切形式的更多信息,请参阅“设置您的提交电子邮件地址”。
-
在提交信息字段下方,选择将您的提交添加到当前分支还是新分支。如果您的当前分支是默认分支,您应该选择为您的提交创建一个新分支,然后创建一个拉取请求。有关更多信息,请参阅“创建拉取请求”。
-
点击提交更改或提出更改。
自定义主题的 CSS
这些说明最适合 GitHub Pages 正式支持的主题。有关支持主题的完整列表,请参阅 GitHub Pages 网站上的“支持主题”。
您的主题源代码库可能会提供一些帮助来自定义您的主题。例如,请参阅 Minimal 的自述文件。
-
在 GitHub 上,导航到您的网站仓库。
-
导航到您的网站的发布源。有关更多信息,请参阅“配置 GitHub Pages 网站的发布源”。
-
创建一个名为 /assets/css/style.scss 的新文件。
-
将以下内容添加到文件顶部
--- --- @import "{{ site.theme }}";
-
在
@import
行之后立即添加您想要的任何自定义 CSS 或 Sass(包括导入)。
自定义主题的 HTML 布局
这些说明最适合 GitHub Pages 正式支持的主题。有关支持主题的完整列表,请参阅 GitHub Pages 网站上的“支持主题”。
您的主题源代码库可能会提供一些帮助来自定义您的主题。例如,请参阅 Minimal 的自述文件。
- 在 GitHub 上,导航到您的主题源代码库。例如,Minimal 的源代码库是 https://github.com/pages-themes/minimal。
- 在 _layouts 文件夹中,导航到您的主题的 default.html 文件。
- 复制文件的内容。
- 在 GitHub 上,导航到您的网站仓库。
- 导航到您的网站的发布源。有关更多信息,请参阅“配置 GitHub Pages 网站的发布源”。
- 创建一个名为 _layouts/default.html 的文件。
- 粘贴您之前复制的默认布局内容。
- 根据您的需要自定义布局。
进一步阅读
- "创建新文件"