用Octopress在Github pages上写博客

安装Git环境

1. 下载msysgit(git for windows)，并安装。
2. 可以选择安装TortoiseGit，这个在windows的资源管理器里装了很多git的右键菜单，对git命令行不熟悉的同学用起来很方便。

安装Ruby环境

1. 从RubyInstaller下载RubyInstaller，直接安装。
2. 从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
3. 下载的Devkit其实就是7zip的压缩包，双击时候选择解压位置，比如c:\devkit。
4. 在命令行运行如下命令安装devkit：
   cd DevKit
ruby dk.rb init
ruby dk.rb install
   注意如果安装失败（不是两个[INFO]），可以在跑完ruby dk.rb init之后跑一下ruby dk.rb review来看看生成的.yml文件对不对，如果没有正确的找到ruby的安装目录，就手动加在下面。
5. 可以把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两个分支。

参考

1. Tutorial: Create a Blog With Octopress and Host It in Github Pages
2. Clone Your Octopress to Blog From Two Places
3. Windows下搭建Octopress博客