【一】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也解决