用Octopress搭建博客

用Octopress把博客顺利搭建了起来，所遇到的问题也都顺利解决。

之前在用Wordpress的时间里，它一度让我忍无可忍。淘宝上25元买来的主机当然太过缓慢，在无比缓慢的操作下，我失去所有的耐心。终于某一天，我愤怒地一气之下删掉了数据库中所有文件，关闭了Wordpress。（删除前数据库备份过。）

看到阮一峰在博客上介绍怎样用Github Pages和Jekyll搭建博客，我眼前一亮。这的确是一种“建立网站的全新思路”，开始吸引到我，不仅因为它免费，不用自己的服务器，而且因为它看上去够轻量级，够快够酷。

我按照阮一峰的文章教程执行了一遍。生成的文章页面似乎过于单调，需要更多个人配置，于是决定转战Octopress。Octopress是在Jekyll上建立起来的，算是Jekyll的简化版。

开始我看了一些个人博客上介绍Octopress如何搭建的文章，不同博客说法各异。我主要参考的是Octopress的Documentation。

下文的介绍完全参考官网文档的步骤。我是纯小白，下面的叙述可能有很多不正确或者不严谨的地方，欢迎指正。

搭建步骤

1. 安装前配置

首先安装Git。

然后安装Ruby。需要安装rbenv或者RVM。

执行ruby --version查看Ruby版本，要求1.9.3或者更高。

2. 安装Octopress：

从GitHub上clone源码：

git clone git://github.com/imathis/octopress.git octopress
cd octopress    

接着安装依赖项(dependencies)：

gem install bundler
rbenv rehash    # If you use rbenv, rehash to be able to run the bundle command
bundle install

然后安装Octopress默认主题：

rake install

如果日后想更改主题，一般可执行以下命令进行更改：

cd octopress
git submodule add GIT_URL .themes/THEME_NAME
rake install['THEME_NAME']
rake generate

这里提供了许多第三方开发主题。

3. 配置Octopress

主要修改Octopress文件夹中的_config.yml文件：最基本的是修改url，title，subtitle和author。这里，如果想给博客增添评论功能，可以使用Disqus，在# Disqus Comments处填写上disqus_short_name，并把disqus_show_comment_count改为true。

另外根据此博客，还最好做一些配置避免因为GFW使页面加载过慢：首先是在_config.yml中，把里面的twitter相关的信息全部删掉；其次，修改定制文件/source/_includes/custom/head.html 把google的自定义字体去掉。

4. 生成博客

博客存放在source/_posts目录下，命名规则是YYYY-MM-DD-post-title.markdown。

执行下面语句生成一篇新博文：

rake new_post["title"]

比如：

rake new_post["Blogging with Octopress"]

可以在文本编辑器中看到以下内容，并继续写作。

---
layout: post
title: "Blogging with Octopress"
date: 2014-09-08 8:88
comments: true
external-url:
categories:
---

如果想生成新页面则执行：

rake new_page[super-awesome]

或者

rake new_page[super-awesome/page.html]

博文采用markdown语法。相关语法可以参考这篇和这篇文章。在Mac平台可以使用Mou作为Markdown编辑器。此外Windows平台有MarkdownPad和MarkPad，Linux平台有ReText。

写完博文后，

接着执行：

rake generate

生成静态文件；

并可以执行：

rake preview

在浏览器中输入http://localhost:4000/ 进行预览。

5. 将博客部署到GitHub Pages

官方文档提供了三种部署(deploying)博客的方法：GitHub Pages, Heroku 和 Rsync。我选择使用GitHub Pages。

注册一个Github账号，建立一个新的代码仓库（repository），使用username.github.io命名，这里username是GitHub的用户名。

然后执行：

rake setup_github_pages

需要输入刚才repository的HTTPS clone URL，直接拷贝即可，像这样：[email protected]:username/username.github.io.git。

接着执行：

rake generate
rake deploy

发布文件。

最后将source提交到git：

git add .
git commit -m 'comment'
git push origin source

6. 发布博文

之后发布博文，执行下面命令即可：

rake new_post["New Post"]
rake generate
git add .
git commit -m 'comment' 
git push origin source
rake deploy