在Winodws上運作jekyll

Jekyll是在Ruby環境下運行,而Windows對於Ruby的支援性較差,所以在安裝時較為麻煩(Mac OS使用者可以直接參考官方網站),並且會有些問題,有興趣的Windows user就來參考我這篇吧~(我至少從頭裝了5次!)。

本篇重點

介紹如何在Windows環境下安裝jekyll,並解決可能會遇到的問題,而Mac OSX使用者可以參考官方網站,如果在兩個環境都安裝一遍的情況下,會發現Mac OSX真的簡單太多了…。

Mac使用者可以從這裡開始閱讀

本篇適用於windows 7(64bit)、windows 8(64bit),其他環境未測試。

Windows下安裝Ruby

首先請打開以下連結,會看到不同版本的ruby installers,選定的Ruby版本等等會對應DevKit,如果沒有電腦內還沒有安裝Ruby的使用者,可以以參考本篇安裝2.0以上的 Ruby。

http://rubyinstaller.org/downloads/

下載完後就開始安裝吧,語系也沒什麼好調的,只有英文跟日文= =。

接受License

路徑上可以用預設即可,如果在網路上搜尋問題,大部分的人也都是用預設路徑來回答。

安裝完成。

安裝完成後,在程式集內或是windows8的動態磚可以找到 Command Prompt with Ruby,而等等還要安裝DevKit。

安裝Devkit

Gem是Ruby的應用程序,而在windows中,許多的gem都需要透過DevKit才能夠使用,Jekyll也是,所以這邊要先安裝DevKit。

上一步驟的http://rubyinstaller.org/downloads/,從這邊下載DevKit,記得版本要對應上一步驟的Ruby版本,接下來如下解壓縮。

打開Command Prompt with Ruby

輸入以下指令

cd Devkit
ruby dk.rb init    

再輸入ruby dk.rb install,就可以完成Devkit安裝了。

ruby dk.rb install


Mac OS使用者從這邊開始與Windows較為接近,可以從這邊開始閱讀。

安裝Jekyll

剛剛的Command Prompt with Ruby,會一直使用,而Ruby的指令就直接輸入在這裏面,Mac OS的使用者就打開Terminal (終端機)吧。

首先升級gem。

gem update --system

接下來安裝jekyll。

gem install jekyll

接下來驗證jekyll是否有安裝完成,以及檢查版本

jekyll -v

啟用Jekyll

辛苦建立的blog在這邊就可以看到了,在jekyll的資料夾下輸入jekyll server,就可以看到嚕。

jekyll server

這時候網址列只要輸入http://localhost:4000/,就可以看到剛剛建立的站台,注意:這個站台是在輸入jekyll server後產生的,如果檔案有修改,必須先停止jekyll server,再重新啟動才會看到新的修改

如果要停止只要按照說明按下Ctrl + C即可。


Windows 特有錯誤

在我安裝過那麼多次,都一定會遇到的錯誤,就是Windows版 jekyll中文會有編碼的問題,只要輸入jekyll server就會出現以下錯誤。

這時候就要到Ruby裡的jekyll資料夾修改一些設定檔

在windows的Ruby安裝路徑找到convertible.rb這個檔案打開

C:\Ruby200-x64\lib\ruby\gems\2.0.0\gems\jekyll-1.4.2\lib\jekyll\convertible.rb

將convertible.rb裡的值如下修改,就可以修正這個問題

原
self.content = File.read_with_options(File.join(base, name),
                                  merged_file_read_opts(opts))
改為
self.content = File.read(File.join(base, name),:encoding=>"utf-8")

接下來再輸入一次jekyll server試試看吧,這問題就會解決了。

Mac OS的優勢

windows在每次修改完檔案後,都必須停止jekyll server,再重新啟動,網站才會更新;而Mac OS只要輸入jekyll server --watch,他就會自動偵測站台是否有儲存,只要有儲存動作就會更新網站。

jekyll server --watch

所以我喜歡在Mac OS寫文章…。