静态页面博客的鼻祖就是Jekyll。
Jekyll 和 Hexo
静态博客目前最流行的也就是 Hexo 和 Jekyll，我一直都是 Hexo 的粉丝和用户，相对于 Jekyll 我想大多数人选择 Hexo 的原因跟我差不多：
- 安装本地环境简单，只需要 nodejs 和一行命令即可
- 官网文档非常优秀，极易上手
- 众多优秀的主题可选，配置功能完善
- 目录结构清晰易懂，内容和配置分离
简单来说，Hexo 可以让你快速开始写文字，但是 Jekyll 却不见得，Jekyll 的罪状我大致列一下：
- 本地环境在 Windows 上坑超多，很多人在这一步就放弃了，官方文档很挫
- 没有专门的主题目录，导致使用新主题需要覆盖安装
- 脚本和内容混合存放，不易管理和使用
- 托管后部署如果有错无法获取报错信息，如果没有本地环境根本没法调查
另外，据说 Jekyll 站点的生成效率也比 Hexo 慢很多，不过我相信这对大多数人都没影响，我们的文章数量也不多。
但是，Jekyll 比 Hexo 有一个让你欲罢不能的优点，那就是天然被 GitHub Pages 支持，当然国内的 Coding Pages，OSC Pages 等等产商也直接支持 Jekyll，俨然这就是一个静态页面的标准。
使用 Jekyll，你可以不用考虑编译生成的问题，写完直接 commit，几分钟后就能看到效果。然而使用Hexo，你要么在本地生成页面后上传，要么找一个持续集成的服务（比如 Travis CI）帮你编译后上传，不是很简单。
因为 Jekyll 那个欲罢不能的原因，今天就说说如果在 Windows 上用最快的速度准备一个Jekyll环境。
参考资料： https://jekyllrb.com/docs/windows/
通过Bash准备Jekyll环境
如果你是 Windows 10，可以考虑使用 Bash 来运行Linux脚本和软件，详见 Bash on Ubuntu on Windows。
启动 Bash 后，运行以下命令即可完成 Jekyll 的准备工作：
1
2
3
4
5
6
sudo apt-get update -y && sudo apt-get upgrade -y
sudo apt-add-repository ppa:brightbox/ruby-ng
sudo apt-get update
sudo apt-get install ruby2.3 ruby2.3-dev build-essential
sudo gem update
sudo gem install jekyll bundler
可能遇到的坑：
-
在 Windows 10 启用 Bash 并不容易，不是所有系统版本都支持
-
就算版本支持，你的 Windows 如果是盗版或者不完整也有可能装不上
-
就算你能装上，这个 Bash 需要 Linux 子系统是一个大家伙，会吃掉你系统盘很多空间
-
就算你系统盘有足够的空间，从服务器下载数GB的文件网络不一定稳定，电脑还不能随便关机
不就是个Jekyll吗？至于嘛，Bash on Windows听起来简单，做起来就难了。
通过 Ruby Installer 安装
Ruby 的安装包可以从 https://rubyinstaller.org/ 下载安装，如果你了解Ruby或者运气很好，选择了正确Ruby版本，那么恭喜你，一切会非常顺利。
不废话，直接说最佳答案。
- 下载Ruby 2.3.3 x64 后双击运行安装。
- 下载Development KIT x64 后解压到 c:\devkit 目录
- 打开命令行工具，运行：
1
2
3
4
cd c:\devkit
ruby dk.rb init
ruby dk.rb review
ruby dk.rb install
- 安装Jekyll
1
gem install jekyll bundler
在本地运行 Jekyll
更多命令建议参考官方文档 https://jekyllrb.com/docs/quickstart/
1
2
3
4
5
6
7
8
9
10
11
12
13
# 创建一个新博客 ./myblog
jekyll new myblog
# 进入新建博客目录
cd myblog
# 安装必要的依赖
bundle
# 在本地启动预览
jekyll serve
# 打开浏览器 http://localhost:4000 即可看到效果
可能遇到的坑
如果有错误信息
错误信息：
1
2
ERROR: While executing gem ... (Encoding::UndefinedConversionError)
U+200F to IBM862 in conversion from UTF-16LE to UTF-8 to IBM862
解决办法：
从Ruby安装目录找到registry.rb，修改默认Encoding为UTF-8。
1
2
LOCALE = Encoding::UTF_8
#LOCALE = Encoding.find(Encoding.locale_charmap)
错误信息：
1
2
3
4
5
6
compiling ruby_http_parser.c
compiling ryah_http_parser.c
linking shared-object ruby_http_parser.so
c:/devkit/mingw/bin/../lib/gcc/x86_64-w64-mingw32/4.7.2/../../../../x86_64-w64-mingw32/bin/ld.exe: cannot find -lgmp
collect2.exe: error: ld returned 1 exit status
make: *** [ruby_http_parser.so] Error 1
解决办法：
Ruby版本不对，没有gmp这个库。建议卸载掉重装2.3.3。
其他的一些问题
- 不要安装Ruby2.5，除非你有强烈的需求。
- Ruby2.4 以后，在安装完成后会让你选择 MSYS2 Devkit，但是国内的网络环境你基本上装不了。
- Ruby2.4 以后，你可以通过
ridk install安装 Devkit，国内网络环境，难。 - Ruby2.4 以后，缺少Jekyll需要的依赖，目前我没办法解决。
综上，不要使用Ruby2.4来准备Jekyll环境，不然你会很难过。
小贴士&小技巧
很多朋友可能不知道，如果你已经初始化了Hexo或者Jekyll，后面写博时就可以完全抛开本地环境，专注于内容就行。
如果你是Hexo，安装完成后并且配置了自动化部署，以后写博客只需要在/source/_posts/目录下新建Markdown文件，完成后提交即可。新建的文章样式可以直接从该目录复制后修改，或者你从模板目录 /scaffolds/ 中拷贝过来也行。
如果你是Jekyll，直接从/_posts/新建文件即可，操作同上。
新博客的文件名最好也都符合yyyy-mm-dd-name.md的样式，主要是方便排序和查阅，另外Jekyll也只认识这种样式。