Jekyll教程——精心收藏


以前總想搭建一個自己的個人網站,由於不懂php后台,所以在點點網開過自己的博客,后來慢慢向程序員轉變,點點網的博客已經不能滿足這個職業特定的需求,於是用worldpress搭建了自己的第一個網站,鼓搗過幾天worldpress,從購買域名空間,修改空間域名解析,添加模板,修改模板,了解了worldpress的強大之處,但是鼓搗玩了worldpress之后,沒有了寫文章的動力,也沒有用足夠的時間來管理,以至於這個網站夭折。直到現在又開始鼓搗Jekyll靜態網站后台引擎,下面就講講Jekyll的學習,以及在用Jekyll創建網站的時候遇到的問題。

 

1.Jekyll基於github.com或者bitbucket.org,后者我沒有驗證,應該也是支持的。不需要數據庫,不需要后台知識,用Jekyll搭建個人中小型網站就是這么簡單。

2.搭建流程(因為我是在windows上安裝Jekyll,所以會比較麻煩):

注冊一個github.com賬號,記住自己的用戶名和注冊時的郵箱,會在git shell驗證時用到。

因為Jekyll是基於Ruby寫的,所以首先安裝Ruby環境,和Ruby包管理工具gem

Ruby安裝地址,根據自己的系統選擇32和64bit,在鏈接的頁面同時安裝DEVELOPMENT Kit

下載安裝后需要配置Ruby的環境變量,在系統的高級屬性里面設置系統的Path,之后,可以在控制台檢查Ruby是否安裝成功。輸入Ruby -v即可。

1 ruby dk.rb init//初始化Ruby

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

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

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

1 ruby dk.rb install

 

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

 

同時,需要安裝python環境,下載2版本或者3版本都可以。Python安裝地址

之后就可以安裝博客所需要的工具了。

  4.1需要安裝一個easy_install插件

  4.2安裝自己喜歡的高亮工具(highlight),例如pygments、rouge。在你的工程目錄的_config.yml里面需要設置:highlighter:rough或者highlighter:pygments,不然會在生成項目是出錯。

1 easy_install Pygments

創建一個簡單的默認博客命令:

1 jekyll new Blog
2 cd Blog           //cd是一個常用命令,到達相應的文件夾
3 jekyll serve    //使用serve和server是一樣的效果

在你的localhost:4000就會有一個默認的博客模板產生。

 

期間會遇到一些錯誤:

1.配置文件報錯

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

解決辦法:在項目的配置文件里面需要設置highlighter:rouge/pygments,傳送門

2.下載RubyGems問題

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

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

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

 3.安裝Ruby不成功,提示錯誤,可以試試淘寶提供的國內鏡像傳送門

 

 那么怎么通過github創建自己獨有的個人網站呢?

1.下載git客戶端下載地址,下載后會有github圖形界面客戶端和git shell命令行工具兩個,咱們使用git shell。

2.在git shell客戶端輸入

git init

初始化項目;

git checkout --orphan gh-pages

創建一個gh-pages分支,該分支用來存放你的博客的所有文件,並且只能為該名稱,因為github.com默認創建分支就是該名稱;

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

開始准備發布項目,記住,不要漏掉后面的英文小數點;

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

這樣的話你的項目就創建成功。

 

注意:

如果在這句執行時報錯git remote add origin https://github.com/username/projectName.git,請執行git remote rm origin來解決。

在創建博客之前不要創建github.com上同名repo下的gh-pages分支,或者同名repo(倉庫)下的github Pages,如圖:

 

可以借鑒的Link(都是樓主遇到問題時找到的很贊的東東)

 一篇不錯的Jekyll教程

最新的windows Jekyll安裝英文教程

一個老外寫的不錯的教程

同樣是一篇高質量的分階段的教程

segmentFault的一篇教程

Jekyllcn.com中文網教程

炫酷網站分享

需要尋找自己喜歡的主題請戳

阮一峰教程

32bit cURL下載地址

 

Ps題外話:周六參加了北京國際會議中心HTML5峰會,聽了大城小胖的演講,見了些牛人,挺nice。了解了HTML5游戲的利弊;以及HTML5游戲引擎(cocos2D-Js,EGret);虛擬搖桿技術,ps配合imgMagic,webAudio;2D游戲優化技巧;softgames的商業模式。


免責聲明!

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



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