Skip to main content

此版本的 GitHub Enterprise 已停止服务 2022-10-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

使用 Jekyll 在本地测试 GitHub Pages 站点

您可以在本地构建 GitHub Pages 站点,以预览和测试对站点的更改。

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。

任何拥有仓库读取权限的人都可以在本地测试 GitHub Pages 站点。

先决条件

在使用 Jekyll 测试站点之前,您必须:

建议使用 Bundler 安装和运行 Jekyll。 Bundler 可管理 Ruby gem 依赖项,减少 Jekyll 构建错误和阻止环境相关的漏洞。 要安装 Bundler:

  1. 安装 Ruby。 有关详细信息,请参阅 Ruby 文档中的“安装 Ruby”。
  2. 安装 Bundler。 有关详细信息,请参阅“Bundler”。

提示: 如果� 在尝试使用 Bundler 安装 Jekyll 时看到 Ruby 错误,则可能需要使用包管理器(例如 RVMHomebrew)来管理� 的 Ruby 安装。 有关详细信息,请参阅 Jekyll 文档中的“故障排除”。

本地构建网站

  1. 打开终端终端Git Bash。 1. 导航到站点的发布来源。 有关详细信息,请参阅“为 GitHub Pages 站点配置发布源”。
  2. 运行 bundle install
  3. 在本地运行您的 Jekyll 站点。
    $ bundle exec jekyll serve
    > Configuration file: /Users/octocat/my-site/_config.yml
    >            Source: /Users/octocat/my-site
    >       Destination: /Users/octocat/my-site/_site
    > Incremental build: disabled. Enable with --incremental
    >      Generating...
    >                    done in 0.309 seconds.
    > Auto-regeneration: enabled for '/Users/octocat/my-site'
    > Configuration file: /Users/octocat/my-site/_config.yml
    >    Server address: http://127.0.0.1:4000/
    >  Server running... press ctrl-c to stop.
  4. 若要预览网站,请在 Web 浏览器中导航到 http://localhost:4000

注意:如果使用 Ruby 3.0 和 Jekyll 4.2.x 或更低版本,则需要在运行 bundle install 之前将 webrick gem 添� 到项目的 Gemfile 中。

更新 GitHub Pages gem

Jekyll 是一个活跃的开源项目,经常更新。 如果计算机上的 github-pages gem 与 GitHub Pages 服务器上的 github-pages gem 已过期,则站点外观在本地构建时可能与在 GitHub Enterprise Server 上发布时不同。 为避免这种情况,请定期更新计算机上的 github-pages gem。

  1. 打开终端终端Git Bash
  2. 更新 github-pages gem。
    • 如果已安装 Bundler,请运行 bundle update github-pages
    • 如果尚未安装 Bundler,请运行 gem update github-pages

延伸阅读