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

使用 Jekyll 主题选择器将 Jekyll 主题添加到 GitHub 页面站点

GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。更多信息请参阅“GitHub 的产品。”

您可以使用 Jekyll 主题选择器创建 GitHub 页面 站点,或者更改现有 GitHub 页面 站点的主题。

您也可以编辑站点的 _config.yml 文件,手动添加 Jekyll 主题到 GitHub 页面 站点。 更多信息请参阅“关于 GitHub 上的 Jekyll 主题”。

  1. 如果 GitHub 页面 站点还没有仓库,请使用自述文件创建新仓库。 新仓库可以是公共或私有。 即使仓库是私有,发布的站点仍然是公共的。

    提示:要创建用户或组织 GitHub 页面 站点,必须使用拥有仓库的用户或组织的名称来命名仓库 <username>.github.io。 如果选择不同的仓库名称,则 Jekyll 主题选择器会自动为您创建 Project 页面站点。 更多信息请参阅“用户、组织和项目页面”。

  2. 导航到 GitHub 页面 站点的仓库。

  3. 在仓库名称下,单击 Settings(设置)

    仓库设置按钮

  4. 在设置页面上,向下滚动,在“GitHub 页面”下:

  1. 在主题选择页面中,审查主题选项。 要选择主题,请单击所需的主题,然后单击 Select theme(选择主题)

    从其他主题选项中选择主题

  2. 如果是创建 GitHub 页面 站点,将会提示您编辑站点的 README.md 文件。 单击 Cancel(取消)以后再编辑。 如果想现在编辑,请参阅“编辑仓库中的文件”并将更改提交到 master 分支。

    编辑文件时的取消链接

  3. 在仓库名称下,单击 Settings(设置)

    仓库设置按钮

  4. 要预览站点,在“GitHub 页面”下单击 GitHub 页面 站点的 URL。 有关疑难排解帮助,请参阅“GitHub 页面 构建疑难排解”。

    页面站点预览链接

进一步自定义 Jekyll 站点

如果要更改 Jekyll 主题的 CSS 或 HTML 布局,请参阅“自定义 Jekyll 主题中的 CSS 和 HTML”。

添加更多页面到站点

要详细了解如何向 GitHub 页面 站点添加其他页面或帖子,请参阅 Jekyll 关于创建页面帖子的正式文档。 您添加到站点的其他页面或帖子将共享 Jekyll 主题的样式和布局。

自定义站点的 URL

要详细了解如何自定义站点的 URL,请参阅“将自定义域用于 GitHub 页面”。

选择不同的发布来源或分支

如果要使用 gh-pages 分支或从仓库的 docs 文件夹发布 GitHub 页面 站点,请参阅“配置 GitHub 页面的发布来源”。

延伸阅读

问问别人

找不到要找的内容?

联系我们