Github pages 是什么?
Github pages借助 git 工具和Jekyll(一个静态网站生成器),使得你可以将内容push到github,然后通过Jekyll发布成个人blog站点。通过github pages创建个人博客,至少有几个好处:
- 文章内容使用markdown标记语言书写,你可以使用任何你喜欢的文本编辑器编辑文章。
- 由于git的存在,你可以轻松的对你的文章进行版本控制。
- 尤其重要的一点,在天朝,你无需担心哪天你的站点被无端屏蔽,还得爬墙过去抢救数据—因为你本地就有一套完整的站点,而且都是文本格式,非常易于备份。
搭建步骤
创建github帐号
首先,你需要一个github帐号。 登录github后,创建一个USERNAME.github.com的repository,根据向导生成pages。
安装本地环境
你需要在本地搭建运行环境,这样在编写文章的时候你可以在本地进行充分的调整,满意后再push到github。 以下基于Ubuntu 10.04LTS系统安装,需要安装的包包括Ruby,RubyGems,jekyll和rake。
$ sudo apt-get install ruby1.9.1-full rubygems1.9.1
然后通过gem命令安装jekyll
$ sudo gem install jekyll
WARNING: You don't have /home/calvin/.gem/ruby/1.9.1/bin in your PATH,
gem executables will not run.
ERROR: Error installing jekyll:
liquid requires RubyGems version >= 1.3.7
安装会出错,提示RubyGems版本过低。这时候需要到http://packages.ubuntu.com/maverick/all/rubygems1.8/download 下载离线安装包安装:
$ sudo dpkg -i Downloads/rubygems1.8_1.3.7-2_all.deb
安装完成后查看gem版本:
$ which gem
/usr/bin/gem
$ gem -v
1.3.7
这时候可以继续安装jekyll了:
$ sudo gem install jekyll
安装jekyll后还需要安装rake工具,通过rake工具可以用来创建新的文章和页面,安装主题等等,十分方便。
$ sudo apt-get install rake
通过rake -T命令可以查看所有可用命令:
$ rake -T
(in /home/calvin/development/github/calvinlee.github.com)
rake page # Create a new page.
rake post # Begin a new post in ./_posts
rake preview # Launch preview environment
rake theme:install # Install theme
rake theme:package # Package theme
rake theme:switch # Switch between Jekyll-bootstrap themes.
安装Jekyll Bootstrap
由于jekyll仅仅是一个静态html的生成器,它不包含任何页面的templates,所以如果从头开始构建你的博客站点的话,还将要有很多工作要做。幸好,Jekyll Bootstrap已经提供了一套基本的构架,我们只需要在它的基础上定制,使之符合你口味即可。
$ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com
$ cd USERNAME.github.com
$ git remote set-url origin git@github.com:USERNAME/USERNAME.github.com.git
$ git push origin master
开始个性博客之旅
首先在本地启动jekyll:
$ /var/lib/gems/1.8/gems/jekyll-0.11.2/bin/jekyll --server
然后你可以访问http://localhost:4000%E6%9F%A5%E7%9C%8BJekyll Bootstrap给你提供了什么,之后你就可以开始写你的文章了。
$ rake post title="my-first-post-on-git-pages" date="2012-03-02"
rake工具会为你生成posts/2012-03-02-my-first-post-on-git-pages.md 你可以开始使用markdown标记语言编辑文章了!
发布
发布很简单,直接将文章内容推送到github即可,如果你修改了页面主题或者布局,也一并推送:
$ git add .
$ git commit -m "Add new post"
$ git push origin master
现在你就可以通过http://USERNAME.github.com%E8%AE%BF%E9%97%AE%E4%BD%A0%E7%9A%84%E9%A1%B5%E9%9D%A2%E4%BA%86%E3%80%82