Jekyll 搭建静态博客
Pin Young Lv9
  • content
    {:toc}

一直以来都想搭建一个自己的博客,但是近半年做项目太忙,再加上教研室的网络很坑爹,所以也一直没顾得上。之前用过 WordPress 托管在免费的京东云擎上,但是速度太慢。在知乎上看到一些相关的内容,于是选择了在github上用jekyll搭建博客。

搭建过程

在jekyll的官网上 http://jekyllrb.com/ 其实已经说得比较明白了,我在这里还是简单的说一下吧。我用的是Windows系统。
主要环节有:安装Ruby,安装RubyGems,安装jekyll,安装代码高亮插件,安装node.js

安装Ruby

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

安装完成后配置环境变量

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

image

安装RubyGems

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

cd到RubyGems目录

image

执行安装

image

用RubyGems安装Jekyll

执行下面的语句安装

image

安装结束画面

image

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

创建博客

在d盘新建一个工作区jekyllWorkspace

cd到jekyllWorkspace

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

image

文件结构如下:

image

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

image

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

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

image

再次启动服务器成功

image

访问 http://localhost:4000/

image

详细文章页面

image

后续


可能出现的问题

hitimes/hitimes (LoadError)

错误代码:

1
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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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 是一个快速的高效的定时器解决方案库,详情可以去官网查看。