关于 GitHub Pages 和 Jekyll
GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。
除了支持常规 HTML 内容之外,GitHub Pages 还支持 Jekyll - 常用的静态站点生成器。
GitHub 页面 深度集成了 Jekyll - 一款常用的静态站点生成器,设计用于博客和软件文档,但实际用途很广。 Jekyll 便于创建全站点标头和脚注,而无需在每页复制。 它还提供高级模板功能和 Jekyll 主题支持。
虽然 GitHub 页面 设计为支持任何静态站点生成器,但使用 Jekyll 可提供许多内建的支持,是 GitHub Enterprise 正式详细说明的唯一静态站点生成器。 有关如何将 GitHub 页面 用于另一静态站点生成器的更多信息,请参阅“使用 Jekyll 以外的静态站点生成器”。
Jekyll 的主要优势:
- 您可以使用 Markdown 代替 HTML。 Markdown 的读取和写入更加简便。
- 您可以添加 Jekyll 主题到站点,而无需复制 CSS 文件。
- 您可以使用各文件共享的常用模板,如标头和脚注。
- 您可以使用简化的构建过程通过 GitHub 页面 构建站点。
Jekyll 的构建过程
Jekyll 使用 GitHub 页面 的简化构建过程,是使用 Jekyll 代替其他静态站点选择器的最大优势之一。 GitHub 页面 用于管理站点的构建过程,一键推送到站点的发布分支。 下面是 Jekyll 用于管理站点的构建过程:
- 将文件更改发布到页面发布分支
- GitHub 页面 发布站点。
注: 您使用的发布分支取决于您的 GitHub 页面 站点类型。
- 对于用户或组织页面,请使用
master
分支。 - 对于项目页面,请使用
gh-pages
或master
分支。 或者,也可以从master
分支的/docs
文件夹发布站点。 更多信息请参阅“配置 GitHub Pages 的发布来源”。
Jekyll 站点示例
Jekyll 是 GitHub 页面 最常用的静态站点生成器。 如果需要其内置支持,包括用于管理依赖项的 GitHub 页面 gem、特定的构建失败消息和更具体的故障排除帮助,建议使用 Jekyll。
这些 GitHub 展示包括 Jekyll 站点示例: