使用jekyll结合EasyBook搭建个人github主页

写这篇主要是总结一下我遇到的坑。

安装环境

这个没什么好说的，主要就是参考这篇文章：Run Jekyll on Windows ，把Ruby环境搭建好。

然后根据官网的指示安装 Jekyll : Quick-start guide 。

过程中可能会遇到这样：

Error fetching https://ruby.taobao.org/:
        SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: ce
rtificate verify failed (https://rubygems-china.oss-cn-hangzhou.aliyuncs.com/spe
cs.4.8.gz)

或者是这样：

ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    Errno::ECONNRESET: An existing connection was forcibly closed by the remote
host. - SSL_connect (https://api.rubygems.org/quick/Marshal.4.8/jekyll-3.1.2.gem
spec.rz)

还有这样：

ERROR: Could not find a valid gem 'jekyll' (>= 0), here is why:
https://github.com/juthilo/run-jekyll-on-windows/issues/34

的错误，解决办法是依次运行下面的指令：

$ gem sources --remove https://rubygems.org/
$ gem sources -a http://rubygems.org/
$ gem install jekyll

使用EasyBook主题

参考：快速上手指南，不要下载 Jekyll，直接clone EasyBook的项目就行了。

再使用jekyll调试的时候，报错：

Configuration file: E:/code/GitHub/Tonypepelu.github.io/_config.yml
  Dependency Error: Yikes! It looks like you don't have jekyll-paginate or one
f its dependencies installed. In order to use Jekyll as currently configured, y
u'll need to install this gem. The full error message from Ruby is: 'cannot loa
 such file -- jekyll-paginate' If you run into trouble, you can find helpful re
ources at http://jekyllrb.com/help/!
jekyll 3.1.2 | Error:  jekyll-paginate

原因：在 _config.yml 文件中使用到了一些东西并没有安装

gems:
 - jekyll-paginate
 - jekyll-gist
 - jemoji

解决办法：依次安装一下就行了

gem install jekyll-gist
gem install jemoji
gem install jekyll-paginate

添加评论

EasyBook里面已经集成了多说和disqus 的评论系统，这里采用 disqus的评论系统，到网站去注册一下，把js代码拷贝下来，参考：使用Github Pages建独立博客取得js代码，拷贝到 _includes/comments.html文件中disqus_thread 标签下，覆盖原有内容。

git提交

因为我已经在当前git命令中绑定过一个账号了，所以这个站点只能提交到别的账号中，我采用了fork新账号的git page项目然后提交pull request，让另一个账号merge的办法。参考：Using pull requests 。

Jekyll调试

依次执行：

$ jekyll build
$ jekyll server

头像处理

这里采用小笠原的做法，把图片托管到网站上，然后在工程配置文件里添加： avatar: "//i.imgur.com/DDbB8QL.jpg?" ，比较搞笑的是上传图片必须翻墙，不然传到一半进度条还能退回来。

写作

文章应该保存在 _posts 文件夹，文件命名格式：YYYY-MM-DD-TITLE.TYPE ，例如：

2011-12-31-new-years-eve-is-awesome.md
2012-01-17-hello-world.md

这个可以使用批处理来解决，详情见下篇文章。

发布

跳进一个坑里直到半夜才爬出来，用Jekyll创建博客本地正常，上传到GitHub后不能显示文章列表？这个问题是因为：jekyll 3（github目前的jekyll版本）默认对于认定为”未来”的post，是不生成的，设置date后面的日期稍微提前一点，就可以了，比如设置为昨天。

文章摘要

文章第一段换行符之前的都是文章摘要。

END