about 6 years ago

以下是今天測試過,確定可以順利安裝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

即可解決問題

結尾

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

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

← [教學] 在windows上使用github 新手教學 / 初學者指南 [筆記] CSS3圓角 & CSS3動畫 →