使用 Jekyll 向 GitHub Pages 站点添� 主题

拥有仓库写入权限的人员可以使用 Jekyll 将主题添� 到 GitHub Pages 网站。

Changes。 如果想先预览� 的更改，可以在本地而不是 GitHub Enterprise Server 上进行更改。 然后在本地测试站点。 有关详细信息，请参阅“使用 Jekyll 在本地测试 GitHub Pages 站点”。

添� 主题

1. 在 GitHub Enterprise Server 上，导航到站点的仓库。 1. 导航到站点的发布来源。 有关详细信息，请参阅“为 GitHub Pages 站点配置发布源”。

2. 导航到“_config.yml”。

3. 在文件视图的右上角，单击 以打开文件编辑器。

   

4. 为主题名称添� 新行。

   • 若要使用支持的主题，请键入 theme: THEME-NAME，将 THEME-NAME 替换为主题存储库的 README 中显示的主题名称。 有关支持主题的列表，请参阅 GitHub Pages 站点上的“支持主题”。
   • 若要使用在 GitHub 上托管的任何其他 Jekyll 主题，请键入 remote_theme: THEME-NAME，将 THEME-NAME 替换为主题存储库的 README 中显示的主题名称。 1. 在页面底部，输入一条简短、有意义的提交消息，描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息，请参阅“创建具有多个共同作者的提交”。 1. 在提交消息字段下面，确定是要将提交添� 到当前分支还是新分支。 如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。 有关详细信息，请参阅“创建新的拉取请求”。 1. 单击“提议文件更改”。

自定义主题的 CSS

主题的源仓库也可能对自定义主题有所帮助。 例如，请参阅“Minima 的自述文件”。

1. 在 GitHub Enterprise Server 上，导航到站点的仓库。 1. 导航到站点的发布来源。 有关详细信息，请参阅“为 GitHub Pages 站点配置发布源”。

2. 新建一个名为 /assets/css/style.scss 的文件。

3. 在文件顶部添� 以下内容：

   ---
   ---
   
   @import "{{ site.theme }}";
   

4. 在 @import 行的后面直接添� 所需的任何自定义 CSS 或 Sass（包括导入）。

自定义主题的 HTML 布局

主题的源仓库也可能对自定义主题有所帮助。 例如，请参阅“Minima 的自述文件”。

1. 在 GitHub 上，导航到主题的源仓库。 例如，Minima 的源存储库为 https://github.com/jekyll/minima 。
2. 在 _layouts 文件夹中，导航到主题的 default.html 文件。
3. 复制该文件的内容。
4. 在 GitHub Enterprise Server 上，导航到站点的仓库。 1. 导航到站点的发布来源。 有关详细信息，请参阅“为 GitHub Pages 站点配置发布源”。
5. 创建一个名为 _layouts/default.html 的文件。
6. 粘贴之前复制的默认布局内容。
7. � �据需要自定义布局。

延伸阅读

• 创建新文件