Github上建立Repository
- 这里假设你已经有个Github账号,知道怎么在本地建立Repository,怎么push到Github上。如果还不知道,参见这篇官方文章。
- 在Github上创建一个名为USERNAME.github.io的repository(把USRENAME换成你的Github账号)
安装Ruby
- 到这里下载Ruby 2.0.0-p247 (x64)(注意版本,下面Github-pages这个gem需要这个版本),以及对应的DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe。
- 安装ruby,注意安装时check一个选项,把它加到PATH里。
- 然后双击DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe解压到比如D:\DevKit
- 以管理员模式打开cmd,进入到D:\Devkit
- 先执行 ruby dk.rb init
- 再执行 ruby dk.rb install
- 默认ruby是从https://rubygems.org下载gem的,我们把它改成淘宝镜像,身为中国人,别问为什么。
gem sources --remove https:/rubygems.org/
gem sources -a http://ruby.taobao.org/
安装本地Jekyll环境
- Github很体贴的帮我们做了一个gem。执行gem install github-pages即可。
- 找到 - D:\Ruby200-x64\lib\ruby\gems\2.0.0\gems\jekyll-1.2.1\lib\jekyll\convertible.rb文件,- 把31行的 - self.content = File.read(File.join(base, name))- 改成 - self.content = File.read(File.join(base, name), :encoding => "utf-8")
- 找到 - D:\Ruby200-x64\lib\ruby\gems\2.0.0\gems\jekyll-1.2.1\lib\jekyll\tags\include.rb文件,- 把65行的 - source = File.read(@file)- 改成 - source = File.read(@file, :encoding => "utf-8")
从Jekyllbootstrap开始
如果你熟悉Jekyll,你可以开始写博客了,如果不熟悉,请Jekyllbootstrap帮我们的忙。
- 进入Gitbash 执行 - $ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.io
- 到你的USRERNAME.github.io文件夹下,打开 - \_config.yml文件, 在顶部- pygments: true下加上一行- markdown: rdiscount或者- markdown: redcarpet
(这是因为Github Pages使用的不是标准的Markdown,而是有一点变种,叫Github flavored markdown, 上面那句话就是为了使用Github flavored markdown)
- 本地运行
进入到你的目录,启动Jekyll
cd USRERNAME.github.io
jekyll serve
然后到http://localhost:4000就可以看到你的博客了。
- 创建第一篇博客 clone自Jekylllbootstrap以后,其实在_posts目录下已经有了一篇示例博客,你可以把它删掉,不过建议先留着,作参考。 我们来创建自己的第一篇博客,先按ctrl+c退出本地Jekyll,然后运行
rake post title="Hello World"
就可以在_posts下看到一个名为20XX-xx-xx-hello-world.md的文件,打开它,你需要学习Markdown语法来编辑它。 再次执行Jekyll serve。就可以看到你的新博客了。
push到Github
相信你在Github上已经建立了USRENAME.github.io的repository。push上去。
$ cd USERNAME.github.io
$ git remote set-url origin git@github.com:USERNAME/USERNAME.github.io.git
$ git push
然后(也许要等几分钟),到http://USRENAME.github.io就可以看到你博客了
参考资料
- Generating SSH Keys
- Using Jekyll with Pages
- 使用Github Pages建独立博客
- 在Windows上建立Jekyll平台
- Jekyll Quick Start
- Markdown Cheetsheet
文档信息
- 本文作者:蔡建斌
- 本文链接:https://johncai.github.io/2013/09/07/blogging-with-jekyll-and-github-page/
- 版权声明:自由转载-非商用-非衍生-保持署名(创意共享3.0许可证)
