Jekyll 搭建静态博客

序

文章大部分来自网络，我添加修改了一些

一直以来都想搭建一个自己的博客，但是近半年做项目太忙，再加上教室的网络很坑爹，所以也一直没顾得上。在知乎上看到一些相关的内容，于是选择了在github上用jekyll搭建博客。

搭建过程

在jekyll的官网上 http://jekyllrb.com/ 其实已经说得比较明白了，我在这里还是简单的说一下吧。

我用的是Windows系统。

主要环节有：安装Ruby，安装RubyGems，安装jekyll，安装代码高亮插件，安装node.js

安装Ruby

ruby官网下载安装：https://www.ruby-lang.org/en/downloads/

安装完成后配置环境变量

在命令提示符中，得到ruby版本号，如下图，即安装成功
ruby-v

安装RubyGems

官网下载 http://rubygems.org/pages/download rubygems-2.4.5.zip

cd到RubyGems目录

ruby-gems

执行安装

ruby-gems-setup

安装DevKit

DevKit 是windows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make, gcc, sh来进行编译。注：这个方法目前仅支持通过RubyInstaller安装的Ruby，如果不是建议你重新安装。安装方法：双击下载的7z文件，指定解压路径，路径中不能有空格。如C:\DevKit，这个路径就是。
根据自己的ruby版本下载响应的devkit版本

用RubyGems安装Jekyll

执行下面的语句安装

jekyll-setup

安装结束画面

jekyll-setup-finish

至此jekyll就已经安装完毕了，后续就是个性化的自己设定了。

创建博客

在d盘新建一个工作区jekyllWorkspace

cd到jekyllWorkspace

执行jekyll new name创建新的工作区

jekyllWorkSpace

文件结构如下：

jekyllFiles

cd到博客文件夹，开启服务器

serve

watch为了检测文件夹内的变化，即修改后不需要重新启动jekyll

我的环境下启动报错(你的可能没有)，再安装yajl-ruby和rouge

yajl

再次启动服务器成功

serve-sucess

访问 http://localhost:4000/

browser

详细文章页面

browser2

后续

整个安装过程参考了jekyll官网，注意jekyll还有一个简体中文官网，不过比较坑（我就被坑了），有些内容没有翻译过来，有可能会走弯路，建议如果想看中文的相关资料，也要中英对照着阅读。jekyll中文网 http://jekyllcn.com, jekyll英文网 http://jekyllrb.com
jekyll中的css是用sass写的，当然直接在_sass/_layout.scss中添加css也是可以的。
本文是用Markdown格式来写的，相关语法可参考： Markdown 语法说明 (简体中文版) http://wowubuntu.com/markdown/
按照本文的说明搭建完博客后，用github Pages托管就可以看到了。注意，在github上面好像不支持rouge，所以要push到github上时，我将配置文件_config.yml中的代码高亮改变为highlighter: pygments就可以了
博客默认是没有评论系统的，本文的评论系统使用了多说，详细安装办法可访问多说官网 http://duoshuo.com/，当然也可以使用搜狐畅言 http://changyan.sohu.com/作为评论系统。
也可以绑定自己的域名，如果没有域名，可以在godaddy http://www.godaddy.com/上将域名放入购物车等待降价，买之。
祝各位新年快乐！

可能出现的问题

`hitimes/hitimes (LoadError)`

错误代码：

C:/Ruby22/lib/ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:in `require': cannot load such file -- hitimes/hitimes (LoadError)

解决方法：

在stackoverflow上又一个很好的解决方法。hitimes require error when running jekyll serve on windows 8.1 虽然上面的题主问的是 win 8.1 系统下的情况，但是同样适用于 win7。下面我简单翻译一下错误原因和解决方法。

可能是 Ruby 2.2 和 hitimes-1.2.2-x86-mingw32 中有一些 ABI 变化，少了一些相关的类库。

所以卸载 hitimes 并通过 --platform ruby 重装即可。代码如下：

1
2
3

gem uni hitimes
**Remove ALL versions**
gem ins hitimes -v 1.2.1 --platform ruby

然后将自动重新编译 hitimes 并适用于 Ruby 2.2

下面是我自己的卸载和安装过程：


E:\GitWorkSpace\gaohaoyang.github.io>gem uni hitimes
You have requested to uninstall the gem:
        hitimes-1.2.2-x86-mingw32
timers-4.0.1 depends on hitimes (>= 0)
If you remove this gem, these dependencies will not be met.
Continue with Uninstall? [yN]  y
Successfully uninstalled hitimes-1.2.2-x86-mingw32
E:\GitWorkSpace\gaohaoyang.github.io>gem ins hitimes -v 1.2.1 --platform ruby
Fetching: hitimes-1.2.1.gem (100%)
Temporarily enhancing PATH to include DevKit...
Building native extensions.  This could take a while...
Successfully installed hitimes-1.2.1
Parsing documentation for hitimes-1.2.1
Installing ri documentation for hitimes-1.2.1
Done installing documentation for hitimes after 1 seconds
1 gem installed

关于，hitimes 是一个快速的高效的定时器解决方案库，详情可以去官网查看。