Ubuntu上使用octopress+github建立个人博客-摩杜云开发者社区

关于本文

　　初用octopress，感觉很适合我。不许要操心管理网站的问题，也不会受到广告等等的烦恼。关于octopress的中文资料不多，我就尝试尝试把octopress的文档整理翻译一下。本文并非是文档的正式翻译，只是单纯介绍一下Ubuntu上使用octopress+github建立个人博客的基本流程，部分内容为方便就直接翻译了原文。如果有误，欢迎指正。

　　我的操作系统是Ubuntu 12.10，octopress版本是2.0

关于github

github是一个全球性的代码托管平台，支持github Pages服务。这个服务可以为个人、组织或项目建立静态主页。github为用户提供项目托管、git、pages等用于项目开发的功能。我们使用的就是其pages服务。相对于其他提供免费博客的网站，github的最大优点是无任何广告且提供git版本管理工具对博客进行管理。但劣势是需要一定的命令行操作，对于普通用户有一定门槛。也因此，octopress+github被成为最适合hack的建博方式。

Step 1 注册github

打开github.com，输入用户名、邮箱、密码，然后点sign up for free即可注册完成。

Step 2 安装octopress

(1)安装git和ruby

在终端中执行：

sudo apt-get install git ruby ruby-dev

(2)准备octopress

执行

git clone git://github.com/imathis/octopress.git octopress cd octopress # 如果你使用RVM, 你会被询问你是否信任 .rvmrc 文件 (选择 yes). ruby --version # 这条命令应该输出 Ruby 1.9.3

然后安装依赖

gem install bundler rbenv rehash # 如果你使用 rbenv, 执行 rehash 以运行 bundle 命令 bundle install

最后安装默认主题

rake install

Step 3 部署到github上

(1)建立一个新的github项目

点击【Create a New Repository】，然后以 用户名/用户名.github.io 的格式建立一个新项目。

(2)部署

首先运行

rake setup_github_pages

这条命令会询问你刚才建立的项目的地址，按提示输入，然后就会生成一些用于部署的文件。接着执行

rake generate rake deploy

这两条命令会生成博客内容，然后添加到git中，自动执行git commit然后推送到主分支(master branch)。几分钟后，你会收到github通知你你的提交已经被接受并发布了你的网站的email。

不要忘记把为你的博客提交source（Don’t forget to commit the source for your blog）

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

Step 4 发布博客

你发布的文章被放在source/_posts目录下，并按照Jekyll的命名规则命名：YYYY-MM-DD-post- title.markdown。这个名字会被用于生成url且日期会被用于为文章按时间排序。但这样比较麻烦，于是Octopress提供了一个rake task来自动按照正确的命名规则建立博文，并生成基本内容。

格式是： ``` rake new_post["title"] ```

官网给出这样的样例：

rake new_post["Zombie Ninjas Attack: A survivor's retrospective"]
# 这条命令会创建 source/_posts/2011-07-03-zombie-ninjas-attack-a-survivors-retrospective.markdown文件

会生成如下内容的文件：

---
layout: post
title: "Zombie Ninjas Attack: A survivor's retrospective"
date: 2011-07-03 5:59
comments: true
external-url:
categories:
---

你可以在这里设置评论功能开关，设置分类。如果你的博客有多个作者共用，你可以在文件中添加【author:Your Name】。如果你在编辑一个草稿，你可以添加【published： false】以使其在生成博客内容时被自动忽略。

Step 5 生成 & 预览

rake generate # 在公开目录中生成博文和页面 rake watch # 查看 source/ and sass/ 的改动 rake preview # 在浏览器中输入 http://localhost:4000 即可预览。

Step 6 推送到github

git add . git commit -m 'your message' git push origin source 然后过几分钟，github就会自动更新你的博客了。

注意：执行rake deploy前一定要先rake generate一下