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 博客。

  • 发表于:
  • 原文链接http://kuaibao.qq.com/s/20180418G0D6UC00?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 yunjia_community@tencent.com 删除。

扫码关注云+社区

领取腾讯云代金券