itsPG.org

PG @ NCTU SenseLab

[教學] 在windows上安裝octopress 新手教學 / 初學者指南

以下是今天測試過，確定可以順利安裝octopress並成功發佈到github的流程，octopress安裝過程繁複，上手不易，希望這篇簡單的教學可以幫助第一次使用octopress的人順利架起環境。

另，在依照這篇教學一步一步操作之前，請先確定

  • 你的windows已經安裝完git
  • 你已經有一個github的帳號
  • 已經擁有”username.github.com”這個repo

關於這部份的教學可以google “github page”，或者是參考我寫的這篇教學在這邊就不再贅述了。

1.安裝ruby環境

在http://rubyinstaller.org/downloads/ 中，下載RubyInstaller 1.9.2-p290這個版本並安裝

2.安裝ruby的Devkit

2.1 在同樣的頁面，找到Development Kit，下載並解壓縮

2.2 進入剛剛解壓縮的資料夾，打入以下指令

ruby dk.rb init
ruby dk.rb install

以下步驟開始請從開始功能表中的 “Start Command Prompt with Ruby” 的環境下進行

3.更新gem

gem update --system

4.抓取octopress原始碼並安裝

git clone git://github.com/imathis/octopress.git octopress
cd octopress
gem install bundler
bundle install
rake install

5.設定github相關的deploy設定

rake setup_github_pages

這時候他會問你github上ssh的路徑，一般來說長得像是這樣

git@github.com:rixia/rixia.github.com.git

rixia請自行代換成你的使用者名稱

6.編輯_config.yml

這個檔案是Blog的相關設定，打開後可以依照需要自行修改，懶的改的話跳過這個步驟也可

7.建立新文章

rake new_post["this is the title"]

打完指令後在_posts下就會出現該篇文章，可以自己打開來修改並加入內容

8.發佈

rake generate
rake deploy

打完以上指令之後就會把內容編譯後上傳到github上
在上傳到github前，你也可以用rake preview指令，觀看預覽
預覽結果會出現在http://127.0.0.1:4000

如果在rake generate時出錯

這是Jekyll編譯原始碼的時候遇到UTF-8會發生的編碼問題
解決方法如下：在rake generate之前先打入以下指令

set LC_ALL=zh_TW.UTF-8
set LANG=zh_TW.UTF-8

即可解決問題

結尾

最簡單的安裝教學大致上就是這樣。

剩下進一步的操作，官方文件上面解說的算詳盡，可以參考看看

Comments