Ubuntu上使用octopress+github創建我的博客

(轉載本文時請代表原文連接：http://fzyz999.github.io/blog/2013/04/10/ubuntushang-shi-yong-octopressjian-li-bo-ke/，順便歡迎有興趣的朋友看看個人github博客：http://fzyz999.github.io)

關於本文

　　初用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一下