Mac 配置 Jekyll 环境

2017-02-11 Lu Huang 更多博文 » 博客 » GitHub »

原文链接 https://hlthu.github.io/blog/2017/02/11/mac-jekyll-build.html
注:以下为加速网络访问所做的原文缓存,经过重新格式化,可能存在格式方面的问题,或偶有遗漏信息,请以原文为准。


前面的博客 GitHub Pages + Jekyll + Netlify 实现 https 个性域名,讲述了如何通过 GitHub Pages + Jekyll + Netlify 实现了自定义域名支持 https 访问的个人主页(博客)。本文将介绍如何在 Mac 上配置 Jekyll 本地编译环境,实现网站的本地预览。

安装 Ruby

一般 Mac 是自带安装了 Ruby 的。可以先 ruby -v 查看下本地 Ruby 版本号,如果是 1.9.2 以上的直接跳过该步。否则的话可以参考 Mac 下搭建 jekyll 环境进行安装或升级。

安装 Jekyll

更换 gem source

据说 gem source 会被墙,所以在正式安装 Jekyll 之前可以先换成淘宝的镜像。

$ gem sources -l
$ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/

安装 Jekyll

$ gem install jekyll

Build 网站

进入 GitHub Pages 的 Repo 所在的目录,先后执行以下两个命令,然后输入 http://localhost:4000/ 即可预览网站。

# 博客生成,默认生成再_site目录下,当然也可以在配置文件中自定义
$ jekyll build
# 开启jekyll本地预览
$ jekyll server

错误解决

在安装的过程中,一开始我没法使用 Jekyll,报错如下。

/Library/Ruby/Site/2.0.0/rubygems/core_ext/kernel_require.rb:55:in `require': cannot load such file -- bundler (LoadError)
    from /Library/Ruby/Site/2.0.0/rubygems/core_ext/kernel_require.rb:55:in `require'
    from /Library/Ruby/Gems/2.0.0/gems/jekyll-3.2.0/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'
    from /Library/Ruby/Gems/2.0.0/gems/jekyll-3.2.0/exe/jekyll:9:in `<top (required)>'
    from /usr/local/bin/jekyll:23:in `load'
    from /usr/local/bin/jekyll:23:in `<main>'

参考了 Bundler LoadError on jekyll serve #5165 才得以解决。即执行下面三条命令。

$ gem install bundler
$ bundle install
$ bundle exec jekyll serve

参考