利用GitHub Pages安装部署Octopress博客

周末闲来无事，学习了一下怎样利用github pages来建立自己的博客，现在比较成熟的博客系统是Octopress，关于其详细的介绍可以参见官方文档，本文建立的博客页面已经绑定到了zhourunsheng.com域名，可以查看博客的效果！

1. github page 的建立

要想在github上面建立自己的博客，首先需要建立page，可以参考官方的文档 http://help.github.com/pages/，简单来说，比如我的github账户名称是careychow，那么需要建立一个 careychow.github.com 的 repository，将博客的静态页面上传到该repository的master分支中，当通过浏览器访问 http://careychow.github.com的时候，github服务器就会将其中博客页面展示出来。

2. 搭建 Octopress 本地环境

linux 环境的搭建可以参见官方文档 http://octopress.org/docs/setup/

因为我自己通常都在win7下面办公，所以下面介绍一下win7环境下 Octopress 的搭建和部署

a. 安装 git，下载地址：msysgit，最新版本 Git-1.7.10-preview20120409.exe ，详细参见 http://help.github.com/win-set-up-git/

b.安装 ruby，下载地址: RubyInstaller，安装版本 rubyinstaller-1.9.2-p290.exe，注意版本是1.9.2

c. 安装gem编译环境， 下载地址：DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe，下载完成后，将其解压到 如 E:\DevKit，然后在win的cmd窗口中执行如下命令进行安装：

cd E:\DevKit

ruby dk.rb init

ruby dk.rb instal

e. 安装python，下载地址：activepython ，安装2.7版，主要是博客代码加亮模块需要python环境的支持，安装完以后，在win的cmd窗口中执行：

 easy_install pygments 

3. 更新配置

a. 中文 utf-8 编码的支持，在win7环境变量中配置如下：

LANG=zh_CN.UTF-8

LC_ALL=zh_CN.UTF-8

b. 变更 gem 的更新源，ruby的官方更新源经常被河蟹，木有办法，幸亏国内有淘宝做好事，提供了国内的更新源，这样速度就快多了，变更如下：

gem sources --remove http://rubygems.org/

gem sources -a http://ruby.taobao.org/

gem sources -l

注意 ：请确保只有 http://ruby.taobao.org/ 唯一一个条目

c. 安装 rdoc 和 bundler

gem install rdoc bundler

4. 安装 Octopress

a. 下载 Octopress 源码

git clone git://github.com/imathis/octopress.git octopress

cd octopress # If you use RVM, You'll be asked if you trust the .rvmrc file (say yes).

ruby --version # Should report Ruby 1.9.2

b. 安装依赖模块

$ vi Gemfile

将行 ： source "http://rubygems.org/"

改为 ： source "http://ruby.taobao.org/"

$ bundle install

c. 安装 默认主题

rake install

如若出错：

$ rake install

rake aborted!

You have already activated rake 0.9.2.2, but your Gemfile requires rake 0.9.2. Using bundle exec may solve this.

(See full trace by running task with --trace)

修正办法为：

$ bundle update; rake install

5. 发布博客到github pages

a. 与github建立连接

rake setup_github_pages

按照提示输入 github page repository的url地址，例如：[email protected]:RubyLouvre/rubylouvre.github.com.git

b. 生成静态页面

rake generate

c. 本地预览，访问 http://localhost:4000 查看博客本地运行效果

rake preview

e. 发送到github 服务器，访问 http://careychow.github.com 查看博客服务器运行效果

rake deploy

f. 保存博客源码到github source分支

git add .

git commit -m 'blog source'

git push origin source

6. 配置 Octopress

a. 更新配置文件 octopress/_config.yml, ，参考http://octopress.org/docs/configuring/，示例如下，若包含中文，请将文件格式保存成utf-8的格式

url: http://zhourunsheng.com

title: 润物无声

subtitle: 天空一朵雨做的云

author: Carey Chow

simple_search: http://google.com/search

description:

b. 绑定个人域名

echo 'zhourunsheng.com' >> octopress/source/CNAME

修改域名 'zhourunsheng.com'  A记录到 207.97.227.245

c. 创建新文章和新页面

rake new_post["article name"]

rake new_page["page name"]

d. 发布到github个人空间

rake generate

rake deploy

至此，一个完整的博客就搭建完毕了，具体的运行效果图请参见我的示例空间：http://zhourunsheng.com/ http://www.cnblogs.com/gossip/archive/2012/06/30/2571316.html