阅读(2691)
赞(1)
使用 Jekyll 在本地测试 GitHub Pages 站点
2020-08-19 15:52:27 更新
您可以在本地构建 GitHub Pages 站点,以预览和测试对站点的更改。
GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。 更多信息请参阅“GitHub 的产品”。
任何拥有仓库读取权限的人都可以在本地测试 GitHub Pages 站点。
基本要求
在使用 Jekyll 测试站点之前,您必须:
- 安装 Jekyll。
- 创建一个 Jekyll 站点。 更多信息请参阅“使用 Jekyll 创建 GitHub Pages 站点”。
我们建议使用 Bundler 安装和运行 Jekyll。 Bundler 可管理 Ruby gem 依赖项,减少 Jekyll 构建错误和阻止环境相关的漏洞。 要安装 Bundler:
本地构建网站
- 打开 Git Bash。
- 导航到站点的发布来源。 有关发布源的更多信息,请参阅“关于 GitHub Pages”。
- 在本地运行您的 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.
- 要预览站点,请在 web 浏览器中导航到
http://localhost:4000
。
更新 GitHub Pages gem
Jekyll 是一个活跃的开源项目,经常更新。 如果您计算机上的 github-pages
gem 版本落后于 GitHub Pages 服务器上的 github-pages
gem 版本,则您的站点在本地构建时的外观与在 GitHub 上发布时的外观可能不同。 为避免这种情况,请定期更新计算机上的 github-pages
gem。
- 打开 Git Bash。
- 更新
github-pages
gem。
- 如果您安装了 Bundler,请运行
bundle update github-pages
。- 如果未安装 Bundler,则运行
gem update github-pages
.
- 如果未安装 Bundler,则运行
延伸阅读
- Jekyll 文档中的 GitHub Pages