用jekyll作为写作博客已经有半年多了,一直没有将搭建过程写出来。这几天正好想要给博客添加表格功能,本地环境却一直出错,遂决定重新搭建一下本地的博客环境。

以下以 Windows 为例,说明一下本地测试环境搭建的过程。

准备 Ruby 环境

由于 jekyll 是用 ruby 语言写的一个静态网页生成工具,所以要搭建 jekyll 本地环境就需要先配置好 ruby 环境。鉴于本人对系统的配置也不是很熟,所以接下来的步骤能省则省。

①.下载 RubyInstaller ,这是 Ruby 的一个集成包,除 Ruby 之外,捆绑一些额外的资源库,能省掉一些麻烦。下载了“rubyinstaller-2.0.0-p247.exe”,记得安装的时候选上 “Add Ruby executables to your PATH” (添加系统环境变量)这样就省去了手动设置系统环境变量的麻烦,我这里安装到了 D:\Ruby200 下

②.下载对应版本 DevKit,我下载的是 “DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe” ,解压进行执行相关命令。我解压到了D:\devkit下,打开cmd,切换到D:\devkit下,分步执行如下的命令,出现如下提示表示安装成功了:

1
2
3
4
5
6
7
8
9
10
11
12
D:\>cd devkit
D:\devkit>ruby dk.rb init
[INFO] found RubyInstaller v2.0.0 at D:/Ruby200
Initialization complete! Please review and modify the auto-generated
'config.yml' file to ensure it contains the root directories to all
of the installed Rubies you want enhanced by the DevKit.
D:\devkit>ruby dk.rb install
[INFO] Updating convenience notice gem override for 'D:/Ruby200'
[INFO] Installing 'D:/Ruby200/lib/ruby/site_ruby/devkit.rb'

经过上面的两个步骤,基本的 Ruby 环境就搭建起来了。

安装 Jekyll

在正式安装之前,建议先修改一下 Ruby 的镜像源,以加快速度。
可以参考一下http://ruby.taobao.org/的操作步骤。

打开命令提示符,输入下面的命令(via ruby.taobao.com)来修改镜像源:

1
2
3
4
5
6
7
8
$ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/
$ gem sources -l
*** CURRENT SOURCES ***
http://ruby.taobao.org
# 请确保只有 ruby.taobao.org
$ gem install rails

可能会有点慢,耐心等待一下就好。

接下来继续输入以下命令:

1
2
3
4
C:\>gem install jekyll
...
C:\>jekyll -v
jekyll 1.3.0

出现版本号就代表安装成功了。期间可能会出现unable to convert "\XXX" from ASCII-8BIT to UTF-8 for XXX/XXX.XX, skipping的错误,这个忽略就行,没什么影响。

查看一下 jekyll 的帮助文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
$ jekyll
NAME:
jekyll
DESCRIPTION:
Jekyll is a blog-aware, static site generator in Ruby
COMMANDS:
build Build your site
default
docs Launch local server with docs for Jekyll v1.3.0
doctor Search site and print specific deprecation warnings
help Display global or [command] help documentation.
import Import your old blog to Jekyll
new Creates a new Jekyll site scaffold in PATH
serve Serve your site locally
ALIASES:
hyde doctor
server serve
GLOBAL OPTIONS:
-s, --source [DIR]
Source directory (defaults to ./)
-d, --destination []
Destination directory (defaults to ./_site)
--safe
Safe mode (defaults to false)
-p, --plugins PLUGINS_DIR1[,PLUGINS_DIR2[,...]]
Plugins directory (defaults to ./_plugins)
--layouts DIR
Layouts directory (defaults to ./_layouts)
-h, --help
Display help documentation
-v, --version
Display version information
-t, --trace
Display backtrace when an error occurs

至此,Jekyll 的本地环境搭建结束了。

参考文献