我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

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

  1. 在 GitHub Enterprise 上,导航到站点的仓库。

  2. 导航到站点的发布来源。 有关发布源的更多信息,请参阅“关于 GitHub Pages”。

  3. Navigate to _config.yml.

  4. 在文件视图的右上角,单击 打开文件编辑器。

    编辑文件按钮

  5. 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.

    Supported theme in config file

  6. 在页面底部,输入一条简短、有意义的提交消息,描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 更多信息请参阅“创建有多个合作作者的提交”。

    有关更改的提交消息

  1. 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是 master,则应选择为提交创建新分支,然后创建拉取请求。 更多信息请参阅“创建新的拉取请求”。

    提交分支选项

  2. 单击 Propose file change(提议文件更改)

    提议文件更改按钮

Customizing your theme's CSS

主题的源仓库也可能对自定义主题有所帮助。 例如,请参阅“Minima's README”。

  1. 在 GitHub Enterprise 上,导航到站点的仓库。

  2. 导航到站点的发布来源。 有关发布源的更多信息,请参阅“关于 GitHub Pages”。

  3. Create a new file called /assets/css/style.scss.

  4. Add the following content to the top of the file:

    ---
    ---
    
    @import "";
    
  5. 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”。

  1. On GitHub, navigate to your theme's source repository. For example, the source repository for Minima is https://github.com/jekyll/minima.

  2. In the _layouts folder, navigate to your theme's default.html file.

  3. Copy the contents of the file.

  4. 在 GitHub Enterprise 上,导航到站点的仓库。

  5. 导航到站点的发布来源。 有关发布源的更多信息,请参阅“关于 GitHub Pages”。

  6. Create a file called _layouts/default.html.

  7. Paste the default layout content you copied earlier.

  8. 根据需要自定义布局。

延伸阅读

问问别人

找不到要找的内容?

联系我们