用Jekyll在github上写博客

用Jekyll在github上写博客——《搭建一个免费的，无限流量的Blog》的注脚

本来打算买域名，买空间，用wordpress写博客的。后来问了一个师兄，他说他是用github的空间，用Jekyll写博客，说很多人都这么做。于是我就研究了一下。

比较有价值的文章有这么几篇：

http://kyle.xlau.org/posts/blogging-like-a-hacker.html  ：这个是Jekyll原作者的文章的译文，必读

http://www.ruanyifeng.com/blog/2012/08/blogging_with_jekyll.html  这个就是标题中提到的文章，清晰易懂，可以按部就班地跟着做。不过这篇文章有些注意点没提到，因为作者可能用的是Mac（我用的是win7）

我在把该文的小例子成功完成之后，在原文下写了一个评论，抄过来：

感谢博主的文章，清晰易懂:)

不过，建议博主把回复里的注意点添加到博客正文中，免得被读者忽略。比如yaml的代码要顶头写，字符编码要用UTF8无BOM（我是在win7中文版下，默认的编码是ANSI，用notepad++转换编码后才成功）

还有就是，在github上新建一个repo后再执行git remote add origin https://github.com/USERNAME/jekyll_demo.git会报错：“fatal: remote origin already exists.”，网上有说可以先执行git remote rm origin，但是我试了，也不行（报错：error: Could not remove config section 'remote.origin'），不过git remote set-url origin [email protected]:USERNAME/jekyll_demo.git是可行的。所以建议博主用“git remote set-url origin [email protected]:USERNAME/jekyll_demo.git”代替“git remote add origin https://github.com/USERNAME/jekyll_demo.git”（我对git不熟，都是网上看来的，如有错误，还请指出）

我是收到了5封page build failure才搞定，花了好长时间，希望后来人可以少走点弯路吧

最后，放上链接供有需要的同志们参考：https://github.com/ttang235/jekyll_demo

（再补充一点：不一定要用gh-pages这个分支，master好像也行，比如 https://github.com/mojombo/tpw，这个就是Jekyll的原作者的博客目录）

如果你也打算用Jekyll在github上写博客的话，可以在读完那篇文章后，过来读一下我的这条评论，还可以到我的github的 jekyll_demo目录下载下来，这样当你出错的时候，可以有个正确的作为比较，减轻漫无目的、漫山遍野找bug的痛苦。

 

http://jekyllrb.com/ ：官网是肯定要看的，至少要知道Jekyll的功能是“Transform your plain text into static websites and blogs.”

 

--

ps：

要安装Jekyll，首先要安装ruby，安装ruby的过程我也绕了一点弯路，作为一个提醒，写在下面：

http://rubyinstaller.org/downloads/ 这个页面有ruby和devkit

如果安装ruby2.0.0，对应的devkit是mingw64-32-4.7.2（这个页面上写了这句话，我愣是没看到- -）

 

 

 

标签:  安装与配置