Jekyll靜態(tài)網(wǎng)站后臺(tái)引擎使用教程
以前總想搭建一個(gè)自己的個(gè)人網(wǎng)站,由于不懂php后臺(tái),所以在點(diǎn)點(diǎn)網(wǎng)開(kāi)過(guò)自己的博客,后來(lái)慢慢向程序員轉(zhuǎn)變,點(diǎn)點(diǎn)網(wǎng)的博客已經(jīng)不能滿足這個(gè)職業(yè)特定的需求,于是用worldpress搭建了自己的第一個(gè)網(wǎng)站,鼓搗過(guò)幾天worldpress,從購(gòu)買(mǎi)域名空間,修改空間域名解析,添加模板,修改模板,了解了worldpress的強(qiáng)大之處,但是鼓搗玩了worldpress之后,沒(méi)有了寫(xiě)文章的動(dòng)力,也沒(méi)有用足夠的時(shí)間來(lái)管理,以至于這個(gè)網(wǎng)站夭折。直到現(xiàn)在又開(kāi)始鼓搗Jekyll靜態(tài)網(wǎng)站后臺(tái)引擎,下面就講講Jekyll的學(xué)習(xí),以及在用Jekyll創(chuàng)建網(wǎng)站的時(shí)候遇到的問(wèn)題。
1.Jekyll基于github.com或者bitbucket.org,后者我沒(méi)有驗(yàn)證,應(yīng)該也是支持的。不需要數(shù)據(jù)庫(kù),不需要后臺(tái)知識(shí),用Jekyll搭建個(gè)人中小型網(wǎng)站就是這么簡(jiǎn)單。
2.搭建流程(因?yàn)槲沂窃趙indows上安裝Jekyll,所以會(huì)比較麻煩):
注冊(cè)一個(gè)github.com賬號(hào),記住自己的用戶名和注冊(cè)時(shí)的郵箱,會(huì)在git shell驗(yàn)證時(shí)用到。
因?yàn)镴ekyll是基于Ruby寫(xiě)的,所以首先安裝Ruby環(huán)境,和Ruby包管理工具gem
①Ruby安裝地址,根據(jù)自己的系統(tǒng)選擇32和64bit,在鏈接的頁(yè)面同時(shí)安裝DEVELOPMENT Kit
下載安裝后需要配置Ruby的環(huán)境變量,在系統(tǒng)的高級(jí)屬性里面設(shè)置系統(tǒng)的Path,之后,可以在控制臺(tái)檢查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來(lái)安裝Jekyll。輸入Jekyll -v檢查是否安裝成功。如果成功會(huì)返回版本號(hào)。
④同時(shí),需要安裝python環(huán)境,下載2版本或者3版本都可以。Python安裝地址
.之后就可以安裝博客所需要的工具了。
4.1需要安裝一個(gè)easy_install插件
4.2安裝自己喜歡的高亮工具(highlight),例如pygments、rouge。在你的工程目錄的_config.yml里面需要設(shè)置:highlighter:rough或者h(yuǎn)ighlighter:pygments,不然會(huì)在生成項(xiàng)目是出錯(cuò)。
easy_install Pygments
⑤創(chuàng)建一個(gè)簡(jiǎn)單的默認(rèn)博客命令:
jekyll new Blog cd Blog //cd是一個(gè)常用命令,到達(dá)相應(yīng)的文件夾 jekyll serve //使用serve和server是一樣的效果
在你的localhost:4000就會(huì)有一個(gè)默認(rèn)的博客模板產(chǎn)生。
期間會(huì)遇到一些錯(cuò)誤:
1.配置文件報(bào)錯(cuò)
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,傳送門(mén)
2.下載RubyGems問(wèn)題
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 )
解決辦法:下載安全證書(shū)文件,在命令行運(yùn)行下面的命令,如果提示curl不是外部或內(nèi)部指定命令,則是你的電腦沒(méi)有安裝curl插件,需要下載該插件安裝,很棒的一個(gè)教程,傳送門(mén)
curl http://curl.haxx.se/ca/cacert.pem -o cacert.pem
3.安裝Ruby不成功,提示錯(cuò)誤,可以試試淘寶提供的國(guó)內(nèi)鏡像傳送門(mén)
那么怎么通過(guò)github創(chuàng)建自己獨(dú)有的個(gè)人網(wǎng)站呢?
1.下載git客戶端,下載地址,下載后會(huì)有g(shù)ithub圖形界面客戶端和git shell命令行工具兩個(gè),咱們使用git shell。
2.在git shell客戶端輸入
git init
來(lái)初始化項(xiàng)目;
git checkout --orphan gh-pages
創(chuàng)建一個(gè)gh-pages分支,該分支用來(lái)存放你的博客的所有文件,并且只能為該名稱(chēng),因?yàn)間ithub.com默認(rèn)創(chuàng)建分支就是該名稱(chēng);
git add . git commit -a -m'just a test'
開(kāi)始準(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)建成功。
相關(guān)文章
Ruby簡(jiǎn)潔學(xué)習(xí)筆記(一):字符串、數(shù)字、類(lèi)和對(duì)象
這篇文章主要介紹了Ruby簡(jiǎn)潔學(xué)習(xí)筆記(一):字符串、數(shù)字、類(lèi)和對(duì)象,本文是學(xué)習(xí)筆記第一篇,需要的朋友可以參考下2015-01-01Ruby實(shí)現(xiàn)命令行中查看函數(shù)源碼的方法
這篇文章主要介紹了Ruby實(shí)現(xiàn)命令行中查看函數(shù)源碼的方法,,需要的朋友可以參考下2014-07-07Ruby配置rspec和RestClient來(lái)檢測(cè)服務(wù)器
這篇文章主要介紹了Ruby配置rspec和RestClient來(lái)檢測(cè)服務(wù)器的方法,包括JSON文件的相關(guān)配置,需要的朋友可以參考下2015-07-07Ruby中的Hash哈希類(lèi)型基本操作方法小結(jié)
Hash類(lèi)型在Ruby中就相當(dāng)于Python的字典,是一個(gè)鍵值對(duì)應(yīng)的集合類(lèi)型,這里就來(lái)整理一下Ruby中的Hash哈希類(lèi)型基本操作方法小結(jié):2016-06-06Ubuntu系統(tǒng)安裝Ruby語(yǔ)言的三種方法
這篇文章主要介紹了Ubuntu系統(tǒng)安裝Ruby語(yǔ)言的三種方法,本文講解了使用apt-get安裝、使用brightbox ppa倉(cāng)庫(kù)安裝、使用RVM安裝3種方法,需要的朋友可以參考下2015-01-01