最早的时候，是看见了唐巧大哥的博客，UI上已是觉得耳目一新。后来读到过阮一峰的博文，当知道这是搭建在Github这个程序员的facebook上时，更是心头一震，什么时候自己也搭这么个博客呢。直接用github托管代码，完全不用自己租服务器，实在方便。自己之前也有在csdn上维护了一个博客，虽然那已经是一年前的事情了。

深刻的记得，当时想将自己的weibo账户贴到博客页面上，却发现它不支持一般用户潜入javascript代码:(。这更让我对octopress的感情与日俱增。

今天终于动手啦。自己从网上搜到了很多中文的博客描述如何安装配置octopress，有些博客讲得算是清晰，但终归每台电脑有不同的环境，每个人的叙述也或多或少的主观。最要命的是，我发现好几篇博文所讲述的命令都不太一样，走了不少弯路之后，倒腾了一下午，最终还是官网救了我。这也让我进一步认识到，信息的流通中的失真在所难免，最好的方法还是直接探寻最权威的内容。

如果对octopress不太了解，不用急着动手，首先看看几个概念。（当然，lz现在也并非精通这几点，初来乍到的，先做出来再说，以后不断学习…）

• Ruby：octopress框架的实现语言。rvm（ruby version manager）是用于管理ruby版本的，rake是ruby中类似于make工具。
• 静态站点生成工具：简单地说，不用数据库，直接生成网页文件。Jekyll就是这样的工具，而octopress是构建于它的上层的框架。
• Git：我主观的认为完虐svn的分布式版本控制工具。git官网貌似被gfw墙了=.=
• Github：程序员的Facebook,为程序员托管了很多代码的站点。
• Github pages:github推出的，给与程序员*创造静态网页的功能。支持Jekyll，因此也支持octopress。
• homebrew：mac os下的软件包管理工具，类似于linux下的dpkg。它使用ruby脚本，mac os下自带了ruby。
• octopress 其官网的help中有搭建octopress的足够的权威指导

窃以为，最好的学习方式还是从最源头的资料入手。这里仅针对我的配置过程做简单描述，经验浅薄，有差错的地方还请指教:)

1. 配环境

1.0 homebrew

万事开头难，第一步还是配环境。为了软件包安装的方便，可以先安装好homebrew.

1

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

其使用方法，参见官网。

1.1 ruby

mac os x 10.8.1 的系统自带了Ruby，但是版本是1.8.3，而octopress官网所支持的最新版是1.9.3（2013.3），兼容起见，先对版本进行升级。

1
2

$ rvm install 1.9.3 && rvm use 1.9.3 
$ rvm ruby gems latest

lz在升级过程中遇到了奇怪的错误，于是又参考另一篇博文，重新安装了rvm，再升级ruby到1.9.3版本。

1.2 git

使用homebrew安装git。

1

$ brew install git

2. 搭建octopress

环境配置完成后，就可以开始参照官网的指导搭建octopress，并在github建代码仓库，同步管理啦。

3. 配置

具体配置同见官网。

经过试错，发现_config.yml的配置中，配置项和值之间必须有空格。否则会报错。

4. 自定义的调整：

装饰边栏（加weibo、豆瓣信息)

增加weibo评论： 友言版 多说版

5. 发博文和在线部署

同样的，参考官网即可。 这里大致的列出我所常用到的几条命令：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

#创建一篇博文
rake new_post["post title"] #octopress将在工作目录的source/_post/目录下生成相应的markdown文件。然后可以使用mou工具去修改编辑内容。

#生成预览
rake preview #可以通过localhost:4000在本机实时观察最新的编辑效果。

#在线发布
rake deploy #完成编辑后，可以将最新的内容部署到github上去。成功后，即可在线访问。

#向github提交源文件更新
git add -A
git commit -m "提交内容"
git push

其中推荐到的mou，是一个mac下的markdown编辑器。试用后发现有些格式兼容问题，但似乎mac下也只有他这个可视化工具了=。=

另附markdown语法