Jekyll靜態(tài)網(wǎng)站后臺引擎使用教程

以前總想搭建一個自己的個人網(wǎng)站，由于不懂php后臺，所以在點(diǎn)點(diǎn)網(wǎng)開過自己的博客，后來慢慢向程序員轉(zhuǎn)變，點(diǎn)點(diǎn)網(wǎng)的博客已經(jīng)不能滿足這個職業(yè)特定的需求，于是用worldpress搭建了自己的第一個網(wǎng)站，鼓搗過幾天worldpress，從購買域名空間，修改空間域名解析，添加模板，修改模板，了解了worldpress的強(qiáng)大之處，但是鼓搗玩了worldpress之后，沒有了寫文章的動力，也沒有用足夠的時(shí)間來管理，以至于這個網(wǎng)站夭折。直到現(xiàn)在又開始鼓搗Jekyll靜態(tài)網(wǎng)站后臺引擎，下面就講講Jekyll的學(xué)習(xí)，以及在用Jekyll創(chuàng)建網(wǎng)站的時(shí)候遇到的問題。

1.Jekyll基于github.com或者bitbucket.org，后者我沒有驗(yàn)證，應(yīng)該也是支持的。不需要數(shù)據(jù)庫，不需要后臺知識，用Jekyll搭建個人中小型網(wǎng)站就是這么簡單。

2.搭建流程（因?yàn)槲沂窃趙indows上安裝Jekyll，所以會比較麻煩）： 

注冊一個github.com賬號，記住自己的用戶名和注冊時(shí)的郵箱，會在git shell驗(yàn)證時(shí)用到。

因?yàn)镴ekyll是基于Ruby寫的，所以首先安裝Ruby環(huán)境，和Ruby包管理工具gem

①Ruby安裝地址，根據(jù)自己的系統(tǒng)選擇32和64bit,在鏈接的頁面同時(shí)安裝DEVELOPMENT Kit

下載安裝后需要配置Ruby的環(huán)境變量，在系統(tǒng)的高級屬性里面設(shè)置系統(tǒng)的Path,之后，可以在控制臺檢查Ruby是否安裝成功。輸入Ruby -v即可。 

ruby dk.rb init//初始化Ruby

在Ruby安裝的config文件里面配置一下Ruby的安裝目錄：

# This configuration file contains the absolute path locations of all
# installed Rubies to be enhanced to work with the DevKit. This config
# file is generated by the 'ruby dk.rb init' step and may be modified
# before running the 'ruby dk.rb install' step. To include any installed
# Rubies that were not automagically discovered, simply add a line below
# the triple hyphens with the absolute path to the Ruby root directory.
#
# Example:
#
# ---
# - D:/ruby19trunk
# - D:/ruby192dev
#
---
- D:/Ruby

②安裝DEVELOPMENT Kit工具使用的命令行

 ruby dk.rb install 

③在命令行工具中輸入gem install jekyll來安裝Jekyll。輸入Jekyll -v檢查是否安裝成功。如果成功會返回版本號。

④同時(shí)，需要安裝python環(huán)境，下載2版本或者3版本都可以。Python安裝地址
.之后就可以安裝博客所需要的工具了。

　　4.1需要安裝一個easy_install插件

　　4.2安裝自己喜歡的高亮工具（highlight），例如pygments、rouge。在你的工程目錄的_config.yml里面需要設(shè)置：highlighter:rough或者h(yuǎn)ighlighter:pygments,不然會在生成項(xiàng)目是出錯。

easy_install Pygments

⑤創(chuàng)建一個簡單的默認(rèn)博客命令：

jekyll new Blog
 cd Blog      //cd是一個常用命令，到達(dá)相應(yīng)的文件夾
 jekyll serve  //使用serve和server是一樣的效果

在你的localhost:4000就會有一個默認(rèn)的博客模板產(chǎn)生。

期間會遇到一些錯誤：

1.配置文件報(bào)錯

D:/Ruby200-x64/lib/ruby/gems/2.0.0/gems/posix-spawn-0.3.9/lib/posix/spawn.rb:164
: warning: cannot close fd before spawn
'which' is not recognized as an internal or external command,
operable program or batch file.
 Liquid Exception: undefined method `[]' for nil:NilClass in _posts/2014-08-01-
welcome-to-jekyll.markdown
jekyll 2.2.0 | Error: undefined method `[]' for nil:NilClass

解決辦法：在項(xiàng)目的配置文件里面需要設(shè)置highlighter:rouge/pygments，傳送門

2.下載RubyGems問題

ERROR: Could not find a valid gem 'jekyll' (>= 0), here is why:
      Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read server ce
 rtificate B: certificate verify failed (https://rubygems.global.ssl.fastly.net/quick/Marshal.4.8/jekyll-1.3.0.gemspec.rz
 )

解決辦法：下載安全證書文件，在命令行運(yùn)行下面的命令，如果提示curl不是外部或內(nèi)部指定命令，則是你的電腦沒有安裝curl插件，需要下載該插件安裝，很棒的一個教程，傳送門

 curl http://curl.haxx.se/ca/cacert.pem -o cacert.pem

3.安裝Ruby不成功，提示錯誤，可以試試淘寶提供的國內(nèi)鏡像傳送門

 那么怎么通過github創(chuàng)建自己獨(dú)有的個人網(wǎng)站呢？

1.下載git客戶端，下載地址，下載后會有g(shù)ithub圖形界面客戶端和git shell命令行工具兩個，咱們使用git shell。

2.在git shell客戶端輸入

git init

來初始化項(xiàng)目；

git checkout --orphan gh-pages

創(chuàng)建一個gh-pages分支，該分支用來存放你的博客的所有文件，并且只能為該名稱，因?yàn)間ithub.com默認(rèn)創(chuàng)建分支就是該名稱;

git add .
git commit -a -m'just a test'

開始準(zhǔn)備發(fā)布項(xiàng)目，記住，不要漏掉后面的英文小數(shù)點(diǎn)；

git remote add origin https://github.com/username/projectName.git
git push origin gh-pages

這樣的話你的項(xiàng)目就創(chuàng)建成功。