平时学习的时候会看一些大牛的博客，发现大牛的博客都类似，查阅相关资料后发现都是用的Octopress，所以抽时间也好好的给自己搭了一个，以下是自己的搭建过程。
这是[我自己的octopress地址](http://peterpan507.github.io/)
##什么是Octopress
Octopress是一个免费框架，专门用来建立个人博客
基于的原理是 github的[pages](http://pages.github.com/)功能
> *pages*
> pages就是能够允许你上传html文件并将其显示为一个网页。
---
##安装
首先给出[官方的安装教程链接](http://octopress.org/docs/setup/)
我实际安装过程与官方的过程基本一致，不过还是有一些小问题
* Mac OS X版本过新：我的Mac系统是10.9，导致我的ruby1.9.3安装困难,最后使用Homebrew才安装成功
* github的仓库地址错误：我的github名称是大写的，但是建立的仓库名称却使小写的，最终在填写仓库url的时候出了不少问题。最好的解决方法是直接取github上复制仓库地址，而不是自己填写
* 部署到github：归根结底的问题还是自己对于git的操作不太熟悉，这一步有待加强
安装ocotopress主要需要两个东西
* `git`
* `ruby1.9.3`
git呢我们的mac都默认安装了，就跳过了
ruby比较麻烦，以为ocotopress需要的ruby是低版本的1.9.3的版本，但是我们mac默认安装的是2开头的版本，所以安装低版本的ruby是整个安装过程中最费时的
###1.安装Homebrew
给出[Homebrew官方安装方法链接](http://brew.sh/)
```
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
```
###2.安装Rbenv
注：如果不想安装Rbenv，也可以安装RVM，目的都是一样的，都是为了安装低版本的ruby
```
brew update
brew install rbenv
brew install ruby-build
```
###3.安装低版本ruby
>*注*:官方要求的ruby版本是1.9.3
>但是我在过程中发现这个版本有问题，可能是我本身自己的问题，如果你安装这个版本也有问题的话，可以试试我用的版本
>我用的是 1.9.3-p125
```
rbenv install 1.9.3-p125
rbenv local 1.9.3-p125
rbenv rehash
```
你可以使用以下命令来查看是否安装成功，如果成功的话，版本号应该显示的是1.9.3-p125
```
ruby --version
```
###4.安装octopress
用git把octopress克隆下来
```
git clone git://github.com/imathis/octopress.git octopress
cd octopress
```
安装依赖项
```
gem install bundler
rbenv rehash # If you use rbenv, rehash to be able to run the bundle command
bundle install
```
安装默认主题
```
rake install
```
###5.部署到github上
a.在你的github上创建一个仓库，名称为`http://username.github.com`
这个仓库就是用来存放你的博客的，最后会有两个分支
* master
* source
master是跟octopress有关的，source是用来存放你的博文和相关设置的等等
b.将octopress关联到到github的pages上去
```
rake setup_github_pages
```
命令执行完后会要求你输入你的仓库地址
c.生成博客
```
rake generate
```
d.部署
```
rake deploy
```
e.将博文和设置等上传到github
```
git add .
git commit -m 'your message'
git push origin source
```
---
##博客简单设置
你博客中的一些简单设置都是在`_config.yml`文件中设置的
以下是我的配置
```
url: http://PeterPan507.github.io
title: Peter潘 & Tomato
subtitle: 记录自己学习点滴
author: Peter潘
simple_search: http://google.com/search
description:
```
修改完配置后要记得重新生成博客和部署，同时不要忘记把修改提交到github上去
---
##主题安装
octopress提供了很多主题模板，你可以到[主题网站](http://opthemes.com/)去挑选自己喜欢的主题。
###1.克隆主题到本地的主题文件夹
```
git clone 主题地址 .themes/主题名
```
###2.安装主题
```
rake install['主题名']
```
###3.重新生成博客并部署
```
rake generate
rake deploy
```
---
###本地预览
在使用过程中有一个功能非常有用就是本地预览
命令如下
```
rake preview
```
你可以在`rake generate`生成博客后预览一下
然后再浏览器里输入`http://localhost:4000/`就可以本地预览你自己的博客啦，觉得满意了在部署上去，觉得不满意再继续改，继续生成，继续预览，知道满意为止。
---
##后记
我自己的安装过程比较粗略简单，如果想更深入的话可以看看以下的参考资料。
**参考资料：**
* http://www.cnblogs.com/findingsea/p/3336471.html
* http://williamherry.com/blog/2012/07/20/octopress-setup/
* http://blog.devtang.com/blog/2012/02/10/setup-blog-based-on-github/
* http://beyondvincent.com/blog/2013/08/03/108-creating-a-github-blog-using-octopress/
* http://blog.xcodev.com/blog/2013/10/16/start-using-octopress/
* http://brew.sh/index_zh-cn.html
* http://caok1231.com/blog/2012/06/24/install-octopress-to-write-blog/
* http://yanping.me/cn/blog/2012/01/07/theming-and-customization/
