这里将详细讲解一下如何利用octopress在github上部署一个博客程序，既方便写博客又无需考虑托管问题，同时天然的在本地有一个备份，所有操作都基于git，有无限版本控制。使用markdown书写具体的博客内容，自带代码高亮解决方案。
github使用的博客引擎是Jekyll，octopress也是利用Jekyll引擎来开发博客的，因此生成的博客系统可以直接在github pages上运行良好。
环境说明:
本地环境是在ubuntu14.04.1系统下部署的，其他系统也没问题，只需要支持ruby，git
1.Ruby等依赖安装
Ruby 需要高于或等于1.9.3版本的，同时由于Jekyll和octopress都是ruby写的，会有诸多ruby依赖，建议切换ruby源为国内源。对于git版本没有太大要求。
Install Ruby
sudo apt-get install ruby
查看ruby版本方法如下
ruby --version
Install bundler
bundle可以自动解决依赖，安装方法如下：
sudo apt-get install bundler
Install git
默认ubuntu14.04已经自带有安装git，如果没有安装git，请自行安装git
查看git的版本
git --version
$git version 1.9.1
安装git
sudo apt-get install git
2.octopress安装
octopress 的安装也比较简单，下载源码后会有Gemfile文件来指示所有依赖，使用bundle即可。
下载源码
git clone git://github.com/imathis/octopress.git octopress
cd octopress
安装octopress
使用bundle自动安装,执行命令bundle install就会自动安装所有octopress及其所有依赖。
bundle install
注意： 如果上面的命令执行失败，提示下面的错误：
Gem::Installer::ExtensionBuildError: ERROR: Failed to build gem native extension.
/usr/bin/ruby1.9.1 extconf.rb
/usr/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require': cannot load such file -- mkmf (LoadError)
请执行下面的命令安装ruby1.9.1-dev
sudo apt-get install ruby1.9.1-dev
安装octopress默认主题
rake install
在octopress根目录下的Rakefile定义了如何将octopress跟Jekyll连接起来，rake打包了一些常见的如发布博客主题、生成博客数据、发布博客等一系列命令来简化博主的操作。直接使用Jekyll每一个任务都需要不少命令和文件编辑。
tips： 保持Jekyll最新
由于Jekyll更新比较频繁，为了确保你在本地调试的时候看到的网站效果跟GitHub Pages上的一致，务必时常更新Jekyll，推荐使用bundle更新，命令如下：
bundle update
3.octopress配置
实际上octopress已经很好的隐藏了Jekyll的诸多配置，我们只需要简单操作几个文件。octopress就会自动生成相应的Jekyll配置。这里我们仅仅讲解一下_config.yml文件的部分配置项，具体请看官网Configuring Octopress。
该文件的配置分为三大部分:Main config、Jekyll&Plugin、3rd Party Settings。
Main config
url: # For rewriting urls for RSS, etc
title: # Used in the header and title tags
subtitle: # A description used in the header
author: # Your name, for RSS, Copyright, Metadata
simple_search: # Search engine for simple site search
description: # A default meta description for your site
date_format: # Format dates using Ruby's date strftime syntax
subscribe_rss: # Url for your blog's feed, defauts to /atom.xml
subscribe_email: # Url to subscribe by email (service required)
category_feeds: # Enable per category RSS feeds (defaults to false in 2.1)
email: # Email address for the RSS feed if you want it.
注释说明已经很详细了，有一点需要强调的是，如果你想启用自己的域名来访问，这里的url务必修改为你自己的域名，否则即便你添加了CNAME文件，使用rake部署的时候也不会部署该CNAME文件。
建议：
最好把里面的twitter相关的信息全部删掉，否则由于GFW的原因，将会造成页面load很慢。涉及到的文件比较多，小心删除，如果以发表博客，_deploy目录下无需手动删除，重新生成博客后会自动删除。同理，修改定制文件/source/includes/custom/head.html, source/includes/head.html把google的自定义字体去掉。
4.部署到github
github pages支持托管，地址为https://pages.github.com/。在这个页面你只需要大概了解一下什么事github page，如何申请就行了。
新建一个仓库，名为your_user_name.github.io，当然也可以是project，这个方法有点不一样，这里以your_user_name.github.io为例。
在octopress根目录执行 rake setup_github_pages ，按照要求输入仓库地址等，这个命令会在跟目录下新建_deploy目录，这个会push到仓库的master分支，也就是访问博客的文件。
rake setup_github_pages
Enter the read/write url for your repository
(For example, 'git@github.com:your_username/your_username.github.io.git)
or 'https://github.com/your_username/your_username.github.io')
Repository url:
生成博客， rake generate 这个会按照既定规则生成静态文件的博客。
rake generate
发布博客， rake deploy 将前一步生成的静态文件拷贝到_deploy目录并push到github
rake deploy
注意：
第一次执行 rake deploy 的时候会报错如下：
! [rejected] master -> master (non-fast-forward)
error: failed to push some refs to 'https://github.com/blackroom/blackroom.github.com.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Merge the remote changes (e.g. 'git pull')
hint: before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
解决方法是手动进入_deploy目录手动强制push一次。
cd octopress/_deploy
git push origin +master
cd ..
rake deploy
这样再次执行就不会报错了。
博客本地预览
如果在部署到仓库之前，需要先预览一下博客，可以在终端输入 rake preview 命令，然后就能在浏览器中进行本地预览访问了：”http://127.0.0.1:4000/“或”http://localhost:4000/“，效果跟仓库的一样。
rake preview
提交源码用于备份
前面提到的deploy只是部署博客代码到github上面，整个octopress并没有提交，为了保证在任何地方随时发布博客，而无需再次详细配置以保证跟github上的最新代码一致，可以将当前octopress的源码存放到github的source分支下：
git commit -am 'Initial source commit'
git push origin source
5.新建博文
新建博文也非常简单，octopress已经预定义了脚本 rake new_post[“title”] 方便我们操作，因为Jekyll有一套固定的文档路径以及命名规范，需要按照它的规定来实现才能成功生成博文。博文必须存储在source/_posts目录下，并且需要按照Jekyll的命名规范对文章进行命名：YYYY-MM-DD-post-title.markdown。文章的名字会被当做url的一部分，而其中的日期用于对博文的区分和排序。
rake new_post["title"]
new_post执行后会自动新建博文，并在相应的markdown文件中写入yaml元数据。
---
layout: post
title: "title"
date: 2013-01-20 16:36
comments: true
categories:
---
这里的categories是自定义的分类名，支持的定义方式如下：
#One category
categories: Sass
#Multiple categories example 1
categories: [CSS3, Sass, Media Queries]
#Multiple categories example 2
categories:
- CSS3
- Sass
- Media Queries
除此之外，还支持 author: Your Name 来指明作者，支持 published: false 表明当前博文是草稿暂时不发布。
发布博文完整流程：
rake new_post["New Post"]
edit the file source/_posts/{DATETIME}-New-Post.markdown
rake generate
git commit -am "Some comment here."
git push origin source
rake deploy
新建页面
你可以在博客源目录下任意地方添加页面，Jekyll会自动拼接，对应的url地址也会根据页面路径自动生成 ，如果要添加 about.markdown ，那么就会生成 site.com/about.html ，如果你想要的url地址是 site.com/about/ ,你需要新建的页面应该是 about/index.markdown .同样的，octopress也有脚本完成这个操作。
rake new_page[super-awesome]
$creates /source/super-awesome/index.markdown
rake new_page[super-awesome/page.html]
$creates /source/super-awesome/page.html
像发布博文一样，默认后缀依然是markdown，但是你可以再Rakefile中修改这个默认配置；一个干净的页面文件如下：
---
layout: page
title: "Super Awesome"
date: 2013-01-20 5:59
comments: true
sharing: true
footer: true
---
这里的title来自于文件名。你也可以手动修改。跟博文的一样，除了不包含分类 categories，对于 sharing 和 comments 你可以关闭，对于 footer 你可以删除，这样就不会添加默认的footer信息到该页面；如果你不像要再页面中显示日期，可以删除这里的 date 。
内容
页面和博文会调用markup 引擎渲染，默认引擎是再配置文件中；此外，你可以使用任何Jekyll docs中所介绍的模板特性。
默认首页是显示全文，要想仅仅显示摘要，请在合适的地方插入下面的代码
<!-- more -->
这个会生成一个”Continue →” 链接来指向完整博文，这个跟wordpress的一样。