快速使用Github Pages搭建个人博客

2013/09/07 Howto 共 1972 字,约 6 分钟
拔菜集

Github上建立Repository

  1. 这里假设你已经有个Github账号,知道怎么在本地建立Repository,怎么push到Github上。如果还不知道,参见这篇官方文章
  2. 在Github上创建一个名为USERNAME.github.io的repository(把USRENAME换成你的Github账号)

安装Ruby

  1. 这里下载Ruby 2.0.0-p247 (x64)(注意版本,下面Github-pages这个gem需要这个版本),以及对应的DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe。
  2. 安装ruby,注意安装时check一个选项,把它加到PATH里。
  3. 然后双击DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe解压到比如D:\DevKit
  4. 以管理员模式打开cmd,进入到D:\Devkit
  5. 先执行 ruby dk.rb init
  6. 再执行 ruby dk.rb install
  7. 默认ruby是从https://rubygems.org下载gem的,我们把它改成淘宝镜像,身为中国人,别问为什么。
gem sources --remove https:/rubygems.org/
gem sources -a http://ruby.taobao.org/

安装本地Jekyll环境

  1. Github很体贴的帮我们做了一个gem。执行gem install github-pages即可。
  2. 找到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")

  3. 找到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就可以看到你博客了

参考资料

文档信息

Search

    Table of Contents