jekyll本地環境搭建(Windows)


序:最近一直在搞Github建站,所以一直沒機會寫文章,那邊的環境雖然搞好了,但是網站的界面卻是個問題,不想用別人的,總想自己設計個,卻感覺沒經驗吧,就一直耽擱了。所以也就沒心情在那邊寫文章,很久沒寫了,悶得很,一直沒機會把建站的過程總結分享下,今天突然興起,還是來這里寫寫吧~

 

PS:本人一般使用win xp,所以下文都是針對 win xp系統的,一般情況下對於win系列系統都是適用的。至於linux/unix系統,本人很少玩,有機會試試。

 

一、配置ruby環境

由於jekyll是用ruby語言寫的一個靜態網頁生成工具,所以要搭建jekyll本地環境就需要先配置好ruby環境。

1)去官網下載Ruby:https://www.ruby-lang.org/zh_cn/downloads/,可以是安裝包類型,也可以是解壓版的。

2)如果是安裝版,則默認會給你配置系統環境變量,如果是解壓版的,則需要自己配置系統環境變量。雖然本人喜歡解壓版的,但由於本人功力還不夠,發現解壓版的缺少很多必要的東東,無奈只能罷了。(當然如果一定要解壓版的,就把別人安裝好的拷過來吧!)

3)鑒於本人是初學者吧,而且官方推薦不知道如何安裝的,就選擇RubyInstaller(這種安裝方式除 Ruby 之外,捆綁一些額外的資源庫。)。所以上面兩步就略過了,呵呵,下載了“rubyinstaller-1.9.3-p429.exe”,記得安裝的時候選上“Add Ruby executables to your PATH”(添加系統環境變量),我這里安裝到了C:\Ruby下

4)下載DevKit,解壓進行執行相關命令(至於為啥,我還不懂,這個是win系統下必要的步驟)。我解壓到了C:\devkit下,打開cmd,切換到C:\devkit下,分步執行如下紅色字樣命令,出現如下提示表示安裝成功了:

C:\>cd devkit

C:\devkit>ruby dk.rb init
[INFO] found RubyInstaller v1.9.3 at C:/Ruby

Initialization complete! Please review and modify the auto-generated
'config.yml' file to ensure it contains the root directories to all
of the installed Rubies you want enhanced by the DevKit.

C:\devkit>ruby dk.rb install
[INFO] Updating convenience notice gem override for 'C:/Ruby'
[INFO] Installing 'C:/Ruby/lib/ruby/site_ruby/devkit.rb'

 

二、安裝jekyll(需要聯網安裝)

打開cmd,執行如下紅色字樣命令(gem命令已在系統環境中,后面的jekyll亦如此),出現如下類似信息表示安裝成功(這里會安裝jekyll所依賴的東西,由於是聯網安裝,所以存在連接速度等網絡問題,如果出現錯誤,在確認前面安裝步驟正常的情況下請多嘗試,耐心等待!!!事后添加[2013-10-08]:修改gem命令代碼源為ruby.taobao.org速度應該會較快的,具體設置見:http://ruby.taobao.org/):

C:\>gem install jekyll
Fetching: liquid-2.5.2.gem (100%)
Fetching: fast-stemmer-1.0.2.gem (100%)
Temporarily enhancing PATH to include DevKit...
Building native extensions.  This could take a while...
Fetching: classifier-1.3.3.gem (100%)
Fetching: directory_watcher-1.4.1.gem (100%)
Fetching: syntax-1.0.0.gem (100%)
Fetching: maruku-0.6.1.gem (100%)
Fetching: yajl-ruby-1.1.0-x86-mingw32.gem (100%)
Fetching: posix-spawn-0.3.6.gem (100%)
Building native extensions.  This could take a while...
Fetching: pygments.rb-0.5.2.gem (100%)
Fetching: highline-1.6.19.gem (100%)
Fetching: commander-4.1.5.gem (100%)
Fetching: safe_yaml-0.7.1.gem (100%)
Fetching: colorator-0.1.gem (100%)
Fetching: redcarpet-2.2.2.gem (100%)
Building native extensions.  This could take a while...
Fetching: jekyll-1.2.0.gem (100%)
Successfully installed liquid-2.5.2
Successfully installed fast-stemmer-1.0.2
Successfully installed classifier-1.3.3
Successfully installed directory_watcher-1.4.1
Successfully installed syntax-1.0.0
Successfully installed maruku-0.6.1
Successfully installed yajl-ruby-1.1.0-x86-mingw32
Successfully installed posix-spawn-0.3.6
Successfully installed pygments.rb-0.5.2
Successfully installed highline-1.6.19
Successfully installed commander-4.1.5
Successfully installed safe_yaml-0.7.1
Successfully installed colorator-0.1
Successfully installed redcarpet-2.2.2
Successfully installed jekyll-1.2.0
15 gems installed
Installing ri documentation for liquid-2.5.2...
Installing ri documentation for fast-stemmer-1.0.2...
Installing ri documentation for classifier-1.3.3...
Installing ri documentation for directory_watcher-1.4.1...
Installing ri documentation for syntax-1.0.0...
Installing ri documentation for maruku-0.6.1...
Couldn't find file to include 'MaRuKu.txt' from lib/maruku.rb
Installing ri documentation for yajl-ruby-1.1.0-x86-mingw32...
Installing ri documentation for posix-spawn-0.3.6...
Installing ri documentation for pygments.rb-0.5.2...
Installing ri documentation for highline-1.6.19...
Installing ri documentation for commander-4.1.5...
Installing ri documentation for safe_yaml-0.7.1...
Installing ri documentation for colorator-0.1...
Installing ri documentation for redcarpet-2.2.2...
Installing ri documentation for jekyll-1.2.0...
Installing RDoc documentation for liquid-2.5.2...
Installing RDoc documentation for fast-stemmer-1.0.2...
Installing RDoc documentation for classifier-1.3.3...
Installing RDoc documentation for directory_watcher-1.4.1...
Installing RDoc documentation for syntax-1.0.0...
Installing RDoc documentation for maruku-0.6.1...
Couldn't find file to include 'MaRuKu.txt' from lib/maruku.rb
Installing RDoc documentation for yajl-ruby-1.1.0-x86-mingw32...
Installing RDoc documentation for posix-spawn-0.3.6...
Installing RDoc documentation for pygments.rb-0.5.2...
Installing RDoc documentation for highline-1.6.19...
Installing RDoc documentation for commander-4.1.5...
Installing RDoc documentation for safe_yaml-0.7.1...
Installing RDoc documentation for colorator-0.1...
Installing RDoc documentation for redcarpet-2.2.2...
Installing RDoc documentation for jekyll-1.2.0...

C:\>jekyll -v
jekyll 1.2.0

 

三、使用jekyll創建網站並運行

jekyll是一個靜態網頁生成工具,那么必然有所謂的“源碼”,或者說jekyll可以把你寫的有一定格式的文件轉換成靜態網頁。通過jekyll -h查看幫助可以發現有new參數,讓jekyll幫助創建一個網站,即在cmd中執行“jekyll new 網站名”即可,jekyll會在當前目錄下新建一個以網站名為名的文件夾,里面的是自動生成的一個簡單的網站內容。

為了能夠讓這里網站正常運行,這里需要刪除_post文件夾里的文件(應該有一個xxxx-xx-xx-welcome-to-jekyll.markdown字樣的文件),因為這個文件內部使用了語法高亮插件(另外不刪,則可以修改配置文件禁用該語法高亮插件,即修改根目錄下_config.yml中的pygments: true為false便可。),這個需要另外安裝,不再本文范圍內,不刪會導致生成的靜態頁面有問題,因時間有限本文暫不提此問題。

另外還會存在編碼上的問題,但現在只要不在里面用中文,就暫時沒事,后面文章再提。

最后切換到新建的網站目錄下,執行jekyll serve來啟動網站,默認生成的靜態網頁等相關資源會放入_site文件夾。命令執行結果如下:

C:\testjekyll>jekyll serve
Configuration file: C:/testjekyll/_config.yml
            Source: C:/testjekyll
       Destination: C:/testjekyll/_site
      Generating... done.
[2013-09-08 17:34:51] INFO  WEBrick 1.3.1
[2013-09-08 17:34:51] INFO  ruby 1.9.3 (2013-05-15) [i386-mingw32]
[2013-09-08 17:34:51] INFO  WEBrick::HTTPServer#start: pid=984 port=4000

如上可見配置文件是_config.yml,網站的端口是4000,通過http://localhost:4000來訪問即可。

 

PS:以上安裝完后,就可以自由拷貝到別的同類系統中配置並運行了(jekyll是被安裝在Ruby目錄下),網上有外國網友分享了此類東東,不過外國的東東多少跟我們有些出入,有興趣的朋友可以試試(我暫時還沒試過)。

 

參考資料:

http://www.madhur.co.in/blog/2011/09/01/runningjekyllwindows.html

http://jekyllrb.com/


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM