安装Octopress的记录

平时学习的时候会看一些大牛的博客，发现大牛的博客都类似，查阅相关资料后发现都是用的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/

ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

brew update
brew install rbenv
brew install ruby-build

rbenv install 1.9.3-p125
rbenv local 1.9.3-p125
rbenv rehash

ruby --version

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

rake setup_github_pages

rake generate

rake deploy

git add .
git commit -m ‘your message‘
git push origin source

url: http://PeterPan507.github.io
title: Peter潘 & Tomato
subtitle: 记录自己学习点滴
author: Peter潘
simple_search: http://google.com/search
description:

git clone 主题地址 .themes/主题名

rake install[‘主题名‘]

rake generate
rake deploy

rake preview

安装Octopress的记录

原文：http://www.cnblogs.com/peterpan507/p/3538057.html