Jekyll Configuration On Ubuntu

Jekyll 是一个静态网页生成器,Github Pages 支持以 Jekyll 来组织你的博客。

首先,你无需本地安装 Jekyll,就可以直接在 Github 编辑你的博客仓库。

但是,当你想要对博客进行大量改动时,本地修改通过后再推送到 Github 是更好的方式。

此篇博客是在 Ubuntu 上使用 Jekyll 的一个记录。

1 Installation

1.1 安装 Ruby2.3

在安装 Jekyll 前,需要先解决 Ruby 依赖。

Ruby 2.3 安装命令如下:

sudo apt-add-repository ppa:brightbox/ruby-ng
sudo apt-get update
sudo apt-get install ruby2.3 ruby2.3-dev

验证 Ruby 版本

ruby -v
# ruby 2.3.8p459 (2018-10-18 revision 65136) [x86_64-linux-gnu]

1.2 安装 Jekyll & Bundler

命令如下:

sudo gem install jekyll bundler

OK,完了。

2 Starts

2.1 新建 Jekyll 项目

jekyll new myblog

2.2 启动服务

cd myblog
bundle exec jekyll serve

然后就可以访问 Jekyll 项目网页了,http://localhost:4000

3 Conect with Github Pages

3.1 克隆仓库到本地

git clone https://github.com/Amoko/amoko.github.io

3.2 新建Gemfile文件,文件内容如下

source 'https://rubygems.org'

gem 'github-pages', group: :jekyll_plugins

3.3 运行命令

bundle install

然后我在这里遇到一个问题,nokogiri 依赖安装失败;

查看日志发现缺少”zlib.h”文件,需要安装 zlib1g-dev

sudo apt-get install zlib1g-dev

然而又遇到如下问题,“zlib1g-dev : 依赖: zlib1g (= 1:1.2.3.4.dfsg-3ubuntu4) 但是 1:1.2.8.dfsg-1ubuntu1 已安装”,解决方法是将 zlib1g 降级;

sudo apt install zlib1g=1:1.2.3.4.dfsg-3ubuntu4

问题解决,不过第二个问题仅在 Ubuntu 14.04上出现过,切换到 Ubuntu 16.04没有出现该问题。

3.4 启动服务

同じ

bundle exec jekyll serve

4 Liquid语法

待补充

5 TBC

では、十分近づくがよい!

Reference

[1] Quickstart Jekyll

[2] Ruby 2.3 Ubuntu packages

[3] Setting up your GitHub Pages site locally with Jekyll