Windows 下使用 Jekyll 在 github pages 搭建博客

一直想搭建一个博客来记录些开发中遇到的问题,但是自己对前端不熟悉以及服务器主机等等原因,迟迟没有行动起来。后来发现了 github pages 这个东西,可以支持用户在 github 上搭建个人博客,于是乎开始折腾起 Jekyll 了。

Jekyll 的简单教程

1.Jekyll 是基于 Ruby 开发的,所以先安装 rubyinstaller 以及 DevKit,要注意 DevKit 需下载与 rubyinstaller 对应的版本。安装好 ruby 之后,将 DevKit 解压,在 cmd 中切换到 DevKit 的根目录,执行 $ ruby dk.rb init 生成 config.yml 配置文件,然后在 config.yml 添加 ruby 的安装目录:

1
2
---
- E:/Ruby200

注意是 *— 下面加 -* 和空格最后在 cmd 中执行 $ ruby dk.rb install,出现提示:

1
2
3
$ ruby dk.rb install
[INFO] Updating convenience notice gem override for 'E:/Ruby200'
[INFO] Installing 'E:/Ruby200/lib/ruby/site_ruby/devkit.rb'

则 ruby 环境搭建完成了。

2. 在 cmd 中通过 gem 来安装 jekyll,首先使用 $ gem list 查看是否安装 liquid,若未安装则执行 $ gem install liquid,安装完成后再执行 $ gem install jekyll 来安装 jekyll。如果安装速度很慢,可以考虑将 ruby 源更换为淘宝源:

1
2
3
4
5
6
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l
*** CURRENT SOURCES ***

https://ruby.taobao.org

如果在执行 $ gem list 出现如下时:

1
2
3
ERROR:  Could not find a valid gem 'liquid' (>= 0), here is why:
Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read server certificate
B: certificate verify failed (https://rubygems.org/latest_specs.4.8.gz)

则需要下载 cacert.pem 文件,并添加一个环境变量命名为 SSL_CERT_FILE 指向 cacert.pem 所在路径,然后就可以下载了。

3. 安装好 jekyll 后,从 github 上下载 jekyll bootstrap 模板:

1
2
3
$ git clone https://github.com/plusjade/jekyll-bootstrap.git jekyll
$ cd jekyll
$ jekyll server

在浏览器中输入 localhost:4000,成功的话会看到一个 demo 网页。