Adding a theme to your GitHub Pages site using Jekyll
You can personalize your Jekyll site by adding and customizing a theme.
GitHub Pages 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。
本文内容
People with write permissions for a repository can add a theme to a GitHub Pages site using Jekyll.
当更改合并到站点的发布源时,对站点的更改将自动发布。 如果想先预览您的更改,可以在本地而不是 GitHub Enterprise 上进行更改。 然后在本地测试站点。 更多信息请参阅“使用 Jekyll 在本地测试 GitHub Pages 站点”。
Adding a theme
-
在 GitHub Enterprise 上,导航到站点的仓库。
-
导航到站点的发布来源。 有关发布源的更多信息,请参阅“关于 GitHub Pages”。
-
Navigate to _config.yml.
-
在文件视图的右上角,单击 打开文件编辑器。
-
Add a new line to the file for the theme name. Type
theme: THEME-NAME
, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository. For a list of supported themes, see "Supported themes" on the GitHub Pages site. -
在页面底部,输入一条简短、有意义的提交消息,描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 更多信息请参阅“创建有多个合作作者的提交”。
-
在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是
master
,则应选择为提交创建新分支,然后创建拉取请求。 更多信息请参阅“创建新的拉取请求”。 -
单击 Propose file change(提议文件更改)。
Customizing your theme's CSS
主题的源仓库也可能对自定义主题有所帮助。 例如,请参阅“Minima's README”。
-
在 GitHub Enterprise 上,导航到站点的仓库。
-
导航到站点的发布来源。 有关发布源的更多信息,请参阅“关于 GitHub Pages”。
-
Create a new file called /assets/css/style.scss.
-
Add the following content to the top of the file:
--- --- @import "";
-
Add any custom CSS or Sass (including imports) you'd like immediately after the
@import
line.
Customizing your theme's HTML layout
主题的源仓库也可能对自定义主题有所帮助。 例如,请参阅“Minima's README”。
-
On GitHub, navigate to your theme's source repository. For example, the source repository for Minima is https://github.com/jekyll/minima.
-
In the _layouts folder, navigate to your theme's default.html file.
-
Copy the contents of the file.
-
在 GitHub Enterprise 上,导航到站点的仓库。
-
导航到站点的发布来源。 有关发布源的更多信息,请参阅“关于 GitHub Pages”。
-
Create a file called _layouts/default.html.
-
Paste the default layout content you copied earlier.
-
根据需要自定义布局。
延伸阅读
- "创建新文件"