Ruby开源项目之Octopress：像黑客一样写博客

1. 准备工作

既然是为黑客设计的博客框架，安装起来肯定没有像普通应用程序那么简单，需要一些准备工作，但请相信我，并不复杂。

1.1 安装 git

既然要使用 Github，那么肯定首先要安装 Git，这个很简单：

1.2 安装 Ruby

先说句题外话，其实我是从 Ruby 语言才知道有诞生石这种说法的。安装 Ruby 稍稍有些复杂，不过你只要按照以下步骤一步一步来就好了!

安装 HomeBrew

HomeBrew 是一个非常有用的软件包管理系统，你可以把它想象成一个稍微抽象一点的 Mac App Store. 正如我们用 Mac App Store 来安装其他软件一样，我们这一步安装 HomeBrew 的目的是为了安装别的软件 (Ruby) 。当然 Mac App Store 和 HomeBrew 本身也是软件。

安装 HomeBrew 非常简单，打开终端 (Terminal)，执行以下命令（所谓「执行」即「输入+回车」，下同）：

如果在执行上如命令的时候弹出需要安装 Xcode Command Line Tool 的提示，直接点击安装即可。

安装好之后最好先执行以下命令：

此条命令用来诊断安装中出现的问题并提示修复方法，如果没有问题则会显示：

Your system is ready to brew.

如遇问题，则按照提示处理，如果不懂如何处理可以先试着执行后面的步骤，如果能成功，则没有太大问题，毕竟我们只是想写博客而已。当然，做任何事情之前，备份是必须的。

使用 RVM 安装 Ruby

执行以下命令安装 RVM，最新的稳定版 Ruby 也会随之安装：

为避免出现问题，可执行以下命令安装 Ruby 2.0.0:

可以执行 命令来查看现在使用的 Ruby 版本，确保正在使用的是 Ruby 2.0.0

1.3 注册 Github 账号

这个没什么好说的，早晚需要，去 http://github.com 注册吧。

1.4 域名指向（可选）

如果你有自己的域名可用，可以在这时就配置好，毕竟解析起来需要一段时间，不如在我们搭建博客的时候让它开始，这样我们搭建完成后，基本上就可以直接用自有域名访问了。

如果你用的是顶级域名，比如 shengmingzhiqing.com, 请创建两个 A 记录 (A Record) 分别指向 和 .

如果你暂时没有域名，这一步可以暂时不用管。

2. 本地安装 Octopress

终于进入正题了。有了前面的准备工作，安装 Octopress 显得非常简单：

首先，打开终端 (Terminal) 执行如下命令：

上面的代码中，第一行的作用是把 Octopress 克隆到本地磁盘，将会在你的本地 这个文件夹下生成一个名为 octopress 的文件夹。如果你不知道 yourusername 是什么，其实就是你每次打开终端时，$ 这个符号前面显示的那玩意。

第二行的作用是进入这个新建的 octopress 文件夹。这一步可能会碰到一个「是否要信任 .rvmrc file」的问题，输入 yes.

然后我们开始安装 Octopress 所必需的依赖项(dependencies)，执行以下命令：

然后执行如下命令安装默认主题：

本地安装完毕。顺便说一句，所谓 rake 就是 ruby make 的缩写。

这时你执行如下命令：

然后在浏览器内输入，即可看到我们搭建完成的博客。也许并不好看，但很令人开心，不是么？

注意，以上各步中如果出现权限问题（关键词 permission），无法完成（关键词 abort）的话，请在各命令前加上 sudo+空格，如有提示，请输入电脑登录密码。

3. 将 Octopress 部署到 Github Pages

3.1 新建库 (Repository)

用刚刚注册的 Github 账号登录，然后在点击页面右上角的加号，在弹出菜单中点击 : 如图所示

然后会跳转到一个新建库 (Create new repository) 的页面，在一栏填 ，[your_username] 是你 Github 上的用户名，请务必按照此格式填写，否则无法在 Github 上部署博客。然后点击 按钮提交。

如果一切顺利会出现一个页面，有一个 SSH 地址，形如 ，下一步会用到。

3.2 将本地部署的 Octopress 发布到 Github Pages

打开终端 (Terminal)，执行以下命令：

然后会出现一个问句，请把 4.1 步生成的 SSH 地址粘贴到这里，然后回车继续。

执行以下命令：

第一行命令用来生成页面，第二行命令用来部署页面，可按照字面意思理解。如果理解不了，可以暂且不管。任何一步如果出现失败提示，请使用 。

如果上述内容完成，即可使用 http://[your_username].github.io/ 访问页面，将会出现一个和在本地预览时相同的页面。

然后，不要忘了把源文件全部发布到 分支下面，再一次可以看不懂，执行以下命令：

3.3 使用自己的域名（可选）

如果你有自己的域名，并且想指向这个新博客的话，请首先确保执行了 2.4 节中的内容。如果没有执行，可以随时执行。

然后执行下面的命令，注意把 换成你自己的域名。

然后再次执行以下命令：

这样你就可以使用自己的域名了。域名解析需要一段时间，如果没有马上生效，请不要着急。如果长时间没有生效，请确保完整执行了 2.4 节和本节内容。

4. 发布新贴

博客搭建好了，我们可以开始我们的第一贴了。那么怎么发布新贴呢？如果你真的想像个黑客一样写博客，我们可以继续使用我们的终端 (Terminal) 和命令行，执行以下命令：

把其中的 Post Title 替换为你想写的文章标题。然后会有一个名为的文件在目录下生成，其中 yyyy-mm-dd 是你当时的日期。然后执行以下命令：

即可用 vim 编辑器编辑的刚才的文章了，好吧我知道你作为这篇文章的读者并不是一个能熟练使用 vim 的人，那么请在命令行输入 退出这个编辑器。如果你不想假装是个黑客的话，其实发布文章并不需要这么麻烦。

我们直接打开 文件夹，找到刚才生成的文件，用你喜欢的 Markdown 编辑器（免费的我推荐 Mou，收费的我推荐 Byword）或者文本编辑器打开，对文章内容进行编辑。

打开文件后，你会发现文章开头有这么一段信息:

其实是这篇文章的元数据： 暂时不要理会； 是这篇文章显示在最终网页上的标题； 部分是详细的文件生成时间，如 ； 部分表示是否允许评论，目前显示是允许，如果想关闭评论，请改为 ； 指这篇文章的分类目录，请在后面引号中输入，如果没有该目录，则会自动生成。请不要删除这段信息，在这段信息下面开始你的文章内容。

这件事情给我们的启发是，以后发布文章，其实并不需要使用终端命令行生成文件。可以直接将自己写好的文章放到这个文件夹下面，当然请按照 这样的文件格式命名，同时记得在文章前面添加元数据信息。这种做法生成的文章与上面的方法无异。如果你觉得添加元数据信息过于麻烦，推荐一个非常好用的工具：TextExpander。

在文章写好之后，使用命令行执行（仔细观察命令，像不像 generate 和 deploy 的合体？）：

同样，如果在本节中，任何命令执行失败，没有取得想要结果，请在前面加 。是时候说一说 命令了，这其实是 super do 的缩写，之所以用它是因为，一般而言 Mac 上最高权限的 账户默认是关闭的。我们自己的账户哪怕是管理员也在一些地方没有权限操作，super do 其实就是越权操作的意思，因此也往往需要输入密码，一般而言短时间内不需要输入第二次。

这样你的第一篇日志就发布出来了，恭喜你正式开通了基于 Octopress 的独立博客。

当然你会发现似乎文章作者不是你，界面是英文显示，整体排版效果差强人意等等问题，不着急，我们会在接下来的文章中讲解如何配置和修改 Octopress 博客。