使用 Jekyll 设置 GitHub Pages 站点
您可以使用流行的静态站点生成器 Jekyll 来进一步自定义您的 GitHub Pages 站点。
谁可以使用此功能?
GitHub Pages 可用于包含 GitHub 免费版和 GitHub 免费版(针对组织)的公共仓库,以及包含 GitHub 专业版、GitHub 团队版、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。有关更多信息,请参阅“GitHub 的方案”。
GitHub Pages 现在使用 GitHub Actions 来执行 Jekyll 构建。当使用分支作为构建源时,如果您想使用内置的 Jekyll 工作流,则必须在您的仓库中启用 GitHub Actions。或者,如果 GitHub Actions 不可用或已禁用,则将.nojekyll
文件添加到源分支的根目录将绕过 Jekyll 构建过程并直接部署内容。有关启用 GitHub Actions 的更多信息,请参阅“管理仓库的 GitHub Actions 设置”。
关于 GitHub Pages 和 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 处理器来确定如何在您的 GitHub Pages 站点上呈现 Markdown。
使用 Jekyll 向您的 GitHub Pages 站点添加主题
您可以通过添加和自定义主题来个性化您的 Jekyll 站点。
关于 GitHub Pages 站点的 Jekyll 构建错误
如果 Jekyll 在本地或 GitHub 上构建您的 GitHub Pages 站点时遇到错误,您将收到包含更多信息的错误消息。
排查 GitHub Pages 站点的 Jekyll 构建错误
您可以使用 Jekyll 构建错误消息来排查 GitHub Pages 站点的问题。