用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 git@github.com:USERNAME/jekyll_demo.git是可行的。所以建议博主用“git remote set-url origin git@github.com: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(这个页面上写了这句话,我愣是没看到- -)
原文地址:https://www.cnblogs.com/fstang/p/3308964.html