【一】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及其解决)

image

  • 安装完成后,在终端中输入ruby -v,出现如下结果,则说明安装成功:
ruby 1.9.3p484 (2013-11-22 revision 43786) [x86_64-linux]

image

3.2 安装nodejs环境(貌似不安装也是可以,gem是ruby的包管理器,我们下面会通过这个管理器安装Jekyll)

image

如果出现错误,可参考下面

  • 之所以要安装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
image
  • nodejs安装完成后,重新在终端中输入gem -v,出现如下结果,表明安装成功:
1.8.23
3.3 安装Jekyll环境
  • 在终端中输入如下命令安装Jekyll,这个过程比较慢,和源有关:
sudo gem install jekyll
(运行出现异常2,修改为以下命令即可: sudo gem install jekyll -v 2.5.3)

image

  • 安装完成后,在终端中输入如下命令,验证jekyll安装是否成功:
jekyll new ttestblog
  • 如果成功创建目录,则说明jekyll安装成功,可以进行之后的工作了。

image

_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

image

  • 在本地运行

image

-Jekyll安装详情

3.4 安装git
  • 既然要将网站部署在Github Page上,那自然少不了使用git,可以使用如下命令安装git:
sudo apt-get install git
  • 在终端中输入git –version,出现如下结果,则说明git安装成功:
git version 1.9.1 
3.5 在github上创建一个新的仓库
4. jekyll基本用法:

image

5. 参考
6. 异常及其解决方法

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

QQ截图20160109002642

问题就是由于前面使用了 安装的ruby 而不是ruby-dev版本,故会报错(直接调用ruby -v不会报错,但是使用gem install时会报错)

1

image

解决方法就是:使用以下命令:
sudo apt-get install ruby1.9.1-dev
或者sudo apt-get install ruby-dev

image

异常2:Ubuntu 上的ruby版本比较低,限制安装jekyll的dev版本即可解决

image

解决方法1:(参考【Error installing Jekyll, requires Ruby >= 2.0.0】)

sudo gem install jekyll -v 2.5.3

image

解决方法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:

image

解决方法:是由于异常2导致的,解决异常2,则异常3也解决

原文地址:https://www.cnblogs.com/mo-wang/p/5115266.html