Octopress 安裝 + GitHub 架設部落格筆記
終於在奮戰了幾天之後，架好了我的 Octopress >__<
還記得小時候 (?) 一直都有寫 blog 的習慣，反而因為變成大人 (?) 之後荒廢了，
雖然號稱小小程式設計者，但我的學習歷程一直著重在邏輯的處理，
技術上長期沒什麼突破… (汗)
anyway 在某因緣際會下認識了 Markdown 進而發現了 Octopress 這個好東西，
不但可以用來撰寫技術文章，還可以達到快速排版的效果，
真的很吸引我這個懶惰蟲～
可是～～～～～～～～～～～～～～～～～～～～～～～～～～
對一個剛接觸「指令操作」不久、git 完全不熟悉的新手而言真的會覺得有點恐懼，
因此在這邊記錄我的安裝過程以及遇到的問題，希望能對跟我一樣困惑的小朋友有所幫助 :P
作業系統：OS X 10.9
Step1 安裝GIT
直接到網址下載安裝即可。
http://code.google.com/p/git-osx-installer
或者參考官網安裝方式。
http://git-scm.com/book/zh-tw/%E9%96%8B%E5%A7%8B-%E5%AE%89%E8%A3%9DGit
Step2 安裝Ruby
Ruby 有兩種版本控管工具，分別是 RVM 及 Rbenv ，選擇一種安裝即可。
一開始我照著官網安裝 RVM 失敗了，所以當時改以 Rbenv 來安裝。
但因為歷史久遠我已經忘記拉～所以這邊先依照官網的說明貼上 XD
以下是 Mac 的建議安裝方法，先使用 Homebrew 套件管理工具來安裝 Rbenv ，
由於 Rbenv 只對 Ruby 進行版本控管，並沒有安裝的功能，因此必須另外安裝 ruby-build 才能進行安裝。
Rbenv
$ brew update
$ brew install rbenv
$ brew install ruby-build
安裝完 Rbenv 及 ruby-build 後便可以開始安裝 ruby 囉！
最後必須執行 rehash 來進行版本重置。
$ rbenv install 1.9.3-p0
$ rbenv rehash
然後～～～～
我的第一次 Octopress 安裝就到這裡中斷了 (掩面) ，
當時假會的裝了新版的 Ruby 2.0 ，
後來竟然和我的工作環境衝突，只好進行降版，
使用 Rbenv 降版幾次都失敗後，就被迫改以 RVM 重新安裝，
畢竟工作時間就是金錢，老闆是不會等我 try N 次的 (哭)，
一樣乖乖地輸入完下面的指令就可以摟～
RVM
$ \curl -L https://get.rvm.io | bash
$ \curl -L https://get.rvm.io | bash -s -- --autolibs=read-fail
$ \curl -L https://get.rvm.io | bash -s stable --ruby
// 舊版 rvm 指令
// $ rvm install 1.9.3p327
// 新版 rvm 1.29.3 ，版本命名方式有調整喔
$ rvm install ruby-1.9.3-p327
完成後可以輸入 ruby --version 來檢視是否安裝成功，
輸出訊息如： ruby 1.9.3p327 (2012-11-10 revision 37606) [x86_64-darwin13.0.0]。
準備好 Octopress 的前置工作終於可以進入正題了！
Step3 安裝Octopress
先將 Octopress 的 source code 複製到本機，
指令的最後指的是你希望存放的資料夾名稱，如果參考官網預設是使用 octopress 。
$ git clone git://github.com/imathis/octopress.git yourProjectName
$ cd yourProjectName
接著安裝 bundler
$ gem install bundler
$ rbenv rehash #使用Rbenv套件者才需執行
$ bundle install
最後安裝 Octopress 預設的布景主題
$ rake install
基本上到這邊算是完成了 Octopress 的安裝，可以輸入以下指令來檢視是否安裝成功。
$ rake generate
$ rake preview
執行 rake preview 啓動 server 後，可以在 http://localhost:4000 檢視部落格。
Step4 部署GitHub
首先必須申請 GitHub 帳號，並且建立一個用來存放部落格代碼的程式庫 (Repository) 。
Repo 的命名必須遵照規則 username.github.io ，
例如我帳號/組織代號為 summerlize ， Repo 則需命名為 summerlize.github.io 。
輸入指令設定 GitHub page
$ rake setup_github_pages
接著會要求輸入 Repo 的 URL ， ex: git@github.com:summerlize/summerlize.github.io.git
Error：repository not found. fatal: The remote end hung up…
由於 GitHub SSH 對大小寫檢查非常敏感，若輸入錯誤則會遇到上方訊息，
建議從 Repo 頁面中右下方的 SSH clone URL 直接複製貼上，也可輸入 git remote -v show 檢查 URL 是否正確。
編譯及發佈部落格
$ rake generate
$ rake deploy
Error：permission denied(publickey)
在執行 deploy 時我遇到了 permission denied(publickey) 的錯誤訊息，
原因是因為沒有 SSH 連結造成，若無此問題可跳過，
參考官方解決方法 GitHub：Generating SSH Keys
$ cd ~/.ssh
$ ls
檢視路徑中是否存在 id_rsa.pub 或 id_dsa.pub 檔案，
如果沒有則需產生一組 SSH KEY ，如果有則可略過至下一步驟。
$ ssh-keygen -t rsa -C "your_email@example.com"
# Creates a new ssh key, using the provided email as a label
# Generating public/private rsa key pair.
# Enter file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]
這邊直接按 enter
系統會要求輸入一組密碼，注意千萬不可空白否則就要重做了。
Enter passphrase (empty for no passphrase): [Type a passphrase]
# Enter same passphrase again: [Type passphrase again]
產生出的檔名為 id_rsa.pub ，接著複製 SSH KEY 。
$ pbcopy < ~/.ssh/id_rsa.pub
進入 GitHub 網頁中的 Account Setting ，選單中的 SSH Keys 按下新增，
將複製的內容貼在Key的位置，回到 terminal 輸入以下指令，
$ ssh -T git@github.com
收到以下訊息輸入 yes
The authenticity of host 'github.com (207.97.227.239)' can't be established.
# RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
# Are you sure you want to continue connecting (yes/no)?
yes
看到以下訊息表示授權成功
Hi username! You've successfully authenticated, but GitHub does not
# provide shell access.
重新 deploy ，第一次發佈會時間會比較長，
沒耐心的時間感判斷大約等了十分鐘有，
之後發佈也是不太一定，時快時慢的，所以要多重新整理幾次。
發佈完成把網址改成 GitHub 帳號就可以查看部落格囉～ http://username.github.com/
最後記得要把 Octopress source 也上傳到 GitHub
$ git add .
$ git commit -m 'initial source commit'
$ git push origin source
相關文章：