Mac 配置 Jekyll 环境
原文链接 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