使用 Jekyll 设置 GitHub Pages 站点
您可以使用流行的静态站点生成器 Jekyll 进一步自定义 GitHub Pages 站点。
谁可以使用此功能?
GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共存储库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和专用存储库。 有关详细信息,请参阅“GitHub 的计划”。
GitHub Pages 现在使用 GitHub Actions 来执行 Jekyll 构建。 使用分支作为构建源时,如果要使用内置的 Jekyll 工作流,则必须在存储库中启用 GitHub Actions。 或者,如果 GitHub Actions 不可用或已禁用,则将 .nojekyll
文件添加到源分支的根目录将绕过 Jekyll 构建过程并直接部署内容。 有关 GitHub Actions 运行器的详细信息,请参阅“管理存储库的 GitHub Actions 设置”。
关于 GitHub 页面和 Jekyll
Jekyll 是一个静态站点生成器,内置 GitHub Pages 支持。
使用 Jekyll 创建 GitHub Pages 站点
您可以使用 Jekyll 在新仓库或现有仓库中创建 GitHub Pages 站点。
使用 Jekyll 在本地测试 GitHub Pages 站点
您可以在本地构建 GitHub Pages 站点,以预览和测试对站点的更改。
使用 Jekyll 向 GitHub Pages 站点添加内容
您可以在 GitHub Pages 上向 Jekyll 站点添加新页面或帖子。
使用 Jekyll 为 GitHub Pages 站点设置 Markdown 处理器
您可以选择一个 Markdown 处理器来确定 Markdown 在 GitHub Pages 站点上的呈现方式。
使用 Jekyll 向 GitHub Pages 站点添加主题
您可以通过添加和自定义主题来个性化 Jekyll 站点。
关于 GitHub Pages 站点的 Jekyll 构建错误
如果在本地或 GitHub Enterprise Cloud 上构建 GitHub Pages 站点发生 Jekyll 错误,您将收到一条错误消息,其中包含相关详细信息。
排查 GitHub Pages 站点的 Jekyll 构建错误
您可以使用 Jekyll 构建错误消息来排查 GitHub Pages 站点的问题。