【一】Ubuntu14.04+Jekyll+Github Pages搭建靜態博客

本系列有五篇：分別是 
【一】Ubuntu14.04+Jekyll+Github Pages搭建靜態博客：主要是安裝方面 
【二】jekyll 的使用 ：主要是jekyll的配置 
【三】Markdown+jekyll在Gitpages上寫blog的經常使用操做 ：主要Markdown的使用

【四】搭建Markdown的編輯器 

【五】將博客從jekyll遷移到了hexo

 

 

---

 

官方教程http://jekyllrb.com/docs/installation/

1. Jekyll簡介

• 簡單: 無需數據庫、無需評論功能，不須要不斷更新版本，只須要關心博客內容。
• 靜態: 只用 Markdown (或 Textile)、Liquid、HTML & CSS 就能夠構建可部署的靜態網站。
• 博客形態: 自定義地址、分類、頁面、博客內容 以及 自定義的佈局設計 都是系統中的一等公民.
• Jekyll詳細介紹

2. Github Pages簡介

• Github Pages是Github提供給每一個用戶的，用來介紹和展現本身的項目。咱們可使用Jekyll生成靜態網站，而後部署到Github pages上，利用Github的服務器，運行本身的網站。
• Github Pages詳細狀況

3. 安裝環境

3.1 安裝ruby環境

• 之因此要安裝ruby，是由於jekyll是用ruby開發的。ubuntu14.04 LTS上默認是沒有安裝ruby環境的，須要本身安裝。安裝命令以下：

sudo apt-get install ruby1.9.1-dev

或者sudo apt-get install ruby-dev

（必定要用這個dev版本，否則用其餘版本會出錯，詳細可查看最後面的異常1及其解決）

• 安裝完成後，在終端中輸入ruby -v，出現以下結果，則說明安裝成功：

ruby 1.9.3p484 (2013-11-22 revision 43786) [x86_64-linux]

3.2 安裝nodejs環境（貌似不安裝也是能夠，gem是ruby的包管理器，咱們下面會經過這個管理器安裝Jekyll）

若是出現錯誤，可參考下面

• 之因此要安裝nodejs是由於ruby的gem管理須要用到nodejs環境，在完成ruby環境後，在終端中輸入gem -v，會出現如下結果：

var/lib/gems/1.9.1/gems/execjs-2.5.2/lib/execjs/runtimes.rb:48:in `autodetect': Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes. (ExecJS::RuntimeUnavailable) 

 

• 錯誤信息提示：找不到一個JavaScript環境，只要在終端中輸入以下命令便可：

sudo apt-get install nodejs

• nodejs安裝完成後，從新在終端中輸入gem -v，出現以下結果，代表安裝成功：

1.8.23

3.3 安裝Jekyll環境

• 在終端中輸入以下命令安裝Jekyll，這個過程比較慢，和源有關：

sudo gem install jekyll

（運行出現異常2，修改成如下命令便可： sudo gem install jekyll -v 2.5.3）

• 安裝完成後，在終端中輸入以下命令，驗證jekyll安裝是否成功：

jekyll new ttestblog

• 若是成功建立目錄，則說明jekyll安裝成功，能夠進行以後的工做了。

 

_config.yml :存儲配置數據。把配置寫在這個文件裏面，可讓你不用在命令行中寫。

_drafts:草稿，可手動建立，格式是:沒有日期.md _includes:包含一些模板，能夠重複利用。你能夠用經過{% include file.ext %}包含

_includes/file.ext文件{這種方式是liquid語法} _layouts:裏面的文件經過{{ content }}包含_posts裏面的文章。

_posts:存放你要發表的文章。格式YEAR-MONTH-DAY-title.markdown。文件名肯定了發表的日期和標記語言。
博客的日期格式經過_config.yml的permalink字段設置或者經過YAML FRONT Matter設置

_data:保存數據的。jekyll會自動加載這裏的全部.jml或者.yaml結尾的文件。好比你有一個members.yml。那麼你能夠經過site.data.members訪問該文件裏的數據。
_site：jekyll生成的網站會放在該文件夾下。最好把它放到.gitignore文件裏面，這樣git就不會管理它了。
index.html:該文件裏面有一個YAML FRONT Matter。大概就長下面這樣：
---
layout: index
title: FEX
page_id: index
---
jekyll會轉換它。包括全部的根目錄下面的，或者不是以上提到的，目錄。
裏的.html,.markdown,.md,和.textile文件。

除了上面提到的其餘文件或者文件夾，會被自動拷貝到_site文件夾裏面。包括css和圖片文件夾，favicon.icon文件。

 

jekyll serve

• 在本地運行

-Jekyll安裝詳情

3.4 安裝git

• 既然要將網站部署在Github Page上，那天然少不了使用git，可使用以下命令安裝git：

sudo apt-get install git

• 在終端中輸入git –version，出現以下結果，則說明git安裝成功：

git version 1.9.1 

• git安裝詳細步驟

3.5 在github上建立一個新的倉庫

• 在github上建立一個新的倉庫，創庫名稱爲：username.github.io,這個倉庫用來保存博客的內容。
• 詳細狀況（步驟參考官網）

4. jekyll基本用法：

5. 參考

• linux下安裝git
• github pages配置
• jekyll配置

6. 異常及其解決方法

異常1：參考【How to install jekyll?】或者【`require': no such file to load — mkmf (LoadError)】

問題就是因爲前面使用了 安裝的ruby 而不是ruby-dev版本，故會報錯（直接調用ruby -v不會報錯，可是使用gem install時會報錯）

解決方法就是：使用如下命令：

sudo apt-get install ruby1.9.1-dev

或者sudo apt-get install ruby-dev

異常2：Ubuntu 上的ruby版本比較低，限制安裝jekyll的dev版本便可解決

解決方法1：（參考【Error installing Jekyll, requires Ruby >= 2.0.0】）

sudo gem install jekyll -v 2.5.3

解決方法2：（參考【How to install Ruby 2 on Ubuntu without RVM】）升級ruby

sudo apt-get -y update
sudo apt-get -y install build-essential zlib1g-dev libssl-dev libreadline6-dev libyaml-dev
cd /tmp
wget http://ftp.ruby-lang.org/pub/ruby/2.1/ruby-2.1.5.tar.gz 
tar -xvzf ruby-2.1.5.tar.gz
cd ruby-2.1.5/
./configure --prefix=/usr/local
make
sudo make install

 

異常3：

解決方法：是因爲異常2致使的，解決異常2，則異常3也解決