By

Contents
  1. 1. 安装Git环境
  2. 2. 安装Ruby环境
    1. 2.1. tags: [ruby,octopress]
  3. 3. 参考

安装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： 
    1
    2
    3
    4
    5
    6
    	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/
    1
    2
    3
    4
    5
    然后可以`gem sources -l`看看结果。

    # 安装Octorpress

     1 . 首先把Octopress的代码拿到本地。
    git clone git://github.com/imathis/octopress.git blog
    1
    2
    3
    2 . 修改Octopress目录下的Gemfile文件，将第一行的`http://rubygems.org/` 修改为`http://ruby.taobao.org/`  

    3 . 然后进入文件夹，安装Octopress。
    gem install bundler
    bundle install
    rake install
    1
    2
    3
    4 . 解决中文问题。  

      * 在环境变量中设置下面的键值对：
    LANG=zh_CN.UTF-8
    LC_ALL=zh_CN.UTF-8
    1
    2
    3
    4

    * 含有中文的文件需要保存为UTF-8无BOM格式编码。  
    * 在Ruby的安装路径找到文件convertible.rb，将27行修改为：
    self.content = File.read(File.join(base, name), :encoding => ‘utf-8’)
    1
    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:
    1
    2
    3
    4
    5
    6
    7
    # 写博客

    博客必须存放在`source/_posts`目录下，并且满足[Jekyll](http://jekyllrb.com/)的命名规范：`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

tags: [ruby,octopress]

1
2
3
4
5
6
7
8
9
10
11
在这里可以修改title为中文。

3 . 用你喜欢的编辑器编辑Markdown文本。我用的是[MarkdownPad](http://markdownpad.com/)。    

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)]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
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
1
2
3

2 . 克隆`master`到`_deploy`目录。


$ cd blog
$ git clone git@github.com:fresky/fresky.github.com.git _deploy
1
2

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博客
Tool
Contents
  1. 1. 安装Git环境
  2. 2. 安装Ruby环境
    1. 2.1. tags: [ruby,octopress]
  3. 3. 参考