用Octopress在Github pages上写博客
安装Git环境
- 下载msysgit(git for windows)，并安装。
- 可以选择安装TortoiseGit，这个在windows的资源管理器里装了很多git的右键菜单，对git命令行不熟悉的同学用起来很方便。
安装Ruby环境
- 从RubyInstaller下载RubyInstaller，直接安装。
- 从RubyInstaller下载Devkit。
注意下载合适的版本：
- Ruby 1.8.6 to 1.9.3: tdm-32-4.5.2
- Ruby 2.0.0: mingw64-32-4.7.2
- Ruby 2.0.0 x64 (64bits): mingw64-64-4.7.2
- 下载的Devkit其实就是7zip的压缩包，双击时候选择解压位置，比如
c:\devkit。 - 在命令行运行如下命令安装devkit：
cd DevKit
ruby dk.rb init
ruby dk.rb install
注意如果安装失败（不是两个[INFO]），可以在跑完ruby dk.rb init之后跑一下ruby dk.rb review来看看生成的.yml文件对不对，如果没有正确的找到ruby的安装目录，就手动加在下面。 - 可以把gem的源更换到淘宝的镜像，这样比较快。
gem sources -a http://ruby.taobao.org/然后可以
gem sources -r https://rubygems.org/gem sources -l看看结果。
安装Octorpress
1 . 首先把Octopress的代码拿到本地。 git clone git://github.com/imathis/octopress.git blog
2 . 修改Octopress目录下的Gemfile文件，将第一行的http://rubygems.org/ 修改为http://ruby.taobao.org/
3 . 然后进入文件夹，安装Octopress。 gem install bundler
bundle install
rake install
4 . 解决中文问题。
-
在环境变量中设置下面的键值对：
LANG=zh_CN.UTF-8 LC_ALL=zh_CN.UTF-8 -
含有中文的文件需要保存为UTF-8无BOM格式编码。
- 在Ruby的安装路径找到文件convertible.rb，将27行修改为：
self.content = File.read(File.join(base, name), :encoding => 'utf-8')
5 . 配置Octopress，修改_config.yml。重点修改如下几个： url: http://fresky.github.io title: Flying in the free sky
subtitle: Dawei's Blog author: Dawei XU simple_search: http://google.com/search
description:
写博客
博客必须存放在source/_posts目录下，并且满足Jekyll的命名规范：YYYY-MM-DD-post-title.markdown。
1 . 用rake new_post["Title of the post"]自动生成一个新的符合命名规范的博文。注意这里的标题不能有中文。
2 . 这个自动生成的文件的开头如下：
---
layout: post
title: "Tutorial: Create a blog with octopress and host it in github pages"
date: 2013-04-22T21:24:21+02:00
comments: true
categories: [ruby,octopress]
---
在这里可以修改title为中文。
3 . 用你喜欢的编辑器编辑Markdown文本。我用的是MarkdownPad。
4 . 编辑完之后可以运行rake preview来预览自己的博客（本地机器4000端口）。
发布到Github Pages上
1 . 在Github上创建一个新的repository，名字叫做your-username.github.io。名字一定要符合这个规范。
2 . 运行命令绑定到Github Pages上： rake setup_github_pages[git@github.com:fresky/fresky.github.com.git(reponame)]
Github pages需要有2个分支，一个是main，一个是source。main上的内容用来显示。
3 . 运行命令来发布：rake deploy
4 . 调用git push origin source来把你的博文的markdown也放到github上。
在另一台机器上发布博文
Octopress的repository有2个分支，一个是source，相当于源代码，包含我们写的博文等文件，这些文件会被处理然后用来生成blog。另一个是main,包含博客本身。 main分支存储在_deploy的目录下，这个目录以下划线开头，所以在git push origin source时会被忽略掉。当运行rake deploy时，会提交master。所以我们要做的就是在新机器上重建一个Octopress的repository。
1 . 克隆source到一个本地目录。 $ git clone -b source git@github.com:fresky/fresky.github.com.git blog
2 . 克隆master到_deploy目录。
$ cd blog $ git clone git@github.com:fresky/fresky.github.com.git _deploy
3 . 运行rake来配置 $ gem install bundler $ bundle install $ rake setup_github_pages
跟上面的步骤一样。这样就在一个新的机器上设置好了Octopress的环境。
如果在多台机器上用，需要每次发布前都pull，发布完都push两个分支。
