共计 3484 个字符，预计需要花费 9 分钟才能阅读完成。
提前声明：Jekyll 并不简单，必须要正确的看待它。把它和 PHP，JSP 和 Django 等放在一起讨论会减少很多失落感。它的学习曲线几乎相当于 Wordpress，工作流程和结构也几乎一样。
Jekyll 与 Wordpress 最大不同的就是，没有数据库。但是体验上来说也算不上什么大差别。彻底摒弃数据库，这算是一种 Jekyll 式的新思路。因为你需要的只是定期更新一些 Markdown 格式的文章，然后让它显示成网页，并放在一起成为网站而已。没必要大动干戈的设计数据库什么的。
简单的说，Jekyll 是一个基于 Ruby 语言的静态博客网站制作工具，它可以把 Markdown 转换成 HTML 网页。
不过对于一个 HTML 网页来说，它得有标题、样式、日期什么的，甚至一些根据文章的不同而动态改变的内容等。这些就不仅是把 Markdown 转换成 HTML 而已了。很多内容需要你在 Markdown 文件里面就写明指定。
另注：Jekyll 虽然和 Github Pages 搭配免费，但其实是完全独立的产品。可以在任何地方使用，像 Wordpress 一样。
安装 Jekyll
安装 Jekyll 需要用 Ruby 的包管理器 gem 下载，像 Python 的 pip 一样：
$ gem install jekyll
但是如果本机的 gem 版本不够新，是装不了 jekyll 的，所以就依照官网从 ruby 从头开始安装：
sudo apt-get install ruby ruby-dev build-essential
echo ‘# Install Ruby Gems to ~/gems’ >> ~/.bashrc
echo ‘export GEM_HOME=$HOME/gems’ >> ~/.bashrc
echo ‘export PATH=$HOME/gems/bin:$PATH’ >> ~/.bashrc
source ~/.bashrc
gem install jekyll bundler
用 Jekyll 创建一个网站（自动生成名为 test_blog 的文件夹和一个完整的 Demo 网站）：
$ jekyll new test_blog
目录里面内容如下：这里面是完整的一个网站，可以直接运行浏览。然后你就可以根据自己的主页、其它网页什么的，在这个基础上修改了。
Jekyll new 时发送错误：Bundler: ruby: No such file or directory
我的 Mac 机上从来没做过任何 Ruby 项目，也不懂 gem 使用方法。全部原始配置后，使用 gem install jekyll 没问题，但是在 jekyll new .. 时，就发送这个错误：
Bundler: ruby: No such file or directory — /usr/local/lib/ruby/gems/2.5.0/gems/bundler-1.16.1/exe/bundle (LoadError)
发生错误后，项目文件夹是生成了，但是不完整，也不能执行。
问题在于本机的 gem 和 bundler 都不是很新，需要更新一下。参考：https://github.com/rubygems/r…
更新如下：
# Install latest version of Rubygems
gem update –system
# Install latest version of bundler system-wide
gem install bundler
更新时间会很长，等全部安装好后，就可以正常的使用 jekyll 了。
生成网站
渲染网站
$ cd test_blog
$ jekyll serve
或实时渲染网站：
$ jekyll server –watch
如果加上了 –watch 参数，jekyll 就会实时监控你的文件，只要那个文件有变动了，比如新增了 markdown 文件，或修改了 layout 模板，它都会即时渲染生成网站，总保持更新。
运行渲染的命令后，jekyll 就会把你的 Markdown 根据指定的模板渲染为静态网站，同时还会把网站映射到本机的一个端口，你可以打开命令行里提示的 url 链接察看网站效果。
允许公网访问
如果 jekyll 部署在了公网上的服务器上，那么很轻松就可以公开给所有人访问了。语法如下：
$ jekyll serve –detach –host 0.0.0.0
# 或
$ jekyll serve –force_polling -H 0.0.0.0 -P 4000
然后就会显示如下：
也就是说公网运行 jekyll 的话，程序就转到后台了，需要退出的话需要手动关闭进程。
然后根据网站设计时候指定的端口，相应的在服务器防火墙上开放这个端口，比如 4000。然后用 http:// 服务器 IP:4000 这样的就能访问了。如果要不带端口号访问，就在_config.yml 中把端口号设计为 80。（但是经常有冲突，需要解决）
Jekyll Workflow 工作流程
使用 Jekyll，主要难就在一开始，需要设计网页样式，设置全站的规则等等。但是一旦这些基本设置都完成了，以后更新就只需要专注的写 Markdown 文件即可。
Jekyll 自定义网站
Jekyll new 命令新建一个网站结构后，文件夹里面有很多文件。这些文件结构都是什么作用，是我们必须要学习的。
Jekyll 文件夹结构
_config.yml 文件：这是你第一个需要修改的东西。全网站的通用设置都保存在这里，比如网站主题，名称，介绍，域名，Github 用户名等。.yml 是像.ini 一样的配置文件类型。
_site 文件夹：这个存放你的完整静态网站的文件夹，但是这是不需要你去碰的文件夹，它是 Jekyll 根据你的设置和模板之类的内容，自动生成的静态网站。
_layout 文件夹：是存放各种网页模板的地方，主页什么样子，列表页什么样子，博客内容页面什么样子，这些分别的页面模板都是放在这里的。
_includes 文件夹：存放所有重复使用的、比较固定的页面模块。比如每个网页都一样的页头、页脚，导航栏，侧边栏等等。这里面的 HTML 文件，都不是完整的 HTML 网页，都只是模块，可能只是一个 <div> 标签。
_posts 文件夹：存放所有的 Markdown 格式文件。你所有的 Markdown 博客内容，都放在这里。文件命名也是有规定的，比如必须是 data-filename.markdown 这种。
注意：
_site 文件夹需要你在.gitignore 中加入屏蔽，因为这个动态生成的东西，完全不需要在 git 里面进行追踪。而且放在 Github Pages 上的话，Github 引擎也不会在你的目录里面生成这个文件夹，而是在后台直接给你生成页面。之所以会有它，主要是本地设计时候用。
Front-Matter 文件头信息
文件头信息在这里被叫做 front-matter, 或 yml-header，它是写在每个 Markdown 文件头部的设置信息。主要是指明这篇文章标题、日期、使用的模板、样式、标签、分类等，这样 Jekyll 就可以根据这些设置把 markdown 文件转换成你想要的最终 HTML 网页了。
头信息的常用参数如下：
layout: 指明模板名称，即指定使用_layout 文件夹中哪个 HTML 网页做为模板。
title: 这篇文章的标题。
data: 这篇文章的日期。
categories: 这篇文章的分类。
“真正的”拿到 Jekyll 生成的静态网站
Jekyll 的最终目标和整个存在意义都是生成静态网站。但是，默认情况下，所谓生成出来的静态 HTML 页面，你也不能直接打开看到效果！必须要运行 jekyll serve 才行，或者把它放到 Github 的 Repo 里。那还叫什么静态网站？！真正的静态网站不是生成 HTML 就行了，而是让你双击打开 HTML 就能在浏览器看到效果。
避开这个有点矛盾的逻辑不说了，我们有比较方便的外部工具来做到这点。那就是最常用的 wget 下载命令。wget 可以把网页或整个网站下载下来，并且能自动转换各种文件里的路径。命令如下：
$ wget -r –convert-links <URL>
所以当你运行 Jekyll serve 成功编译生成_site 目录后，就可以用 wget 下载本地的这个网站了。
Jekyll 的体验
目前体验极其糟糕：
不能真正生成静态网站，必须开着 Jekyll 服务才能展示出网页
Macbook air 上运行 jekyll 服务器不到一会儿，CPU 温度就极速增高
大概几十篇文章，就需要 10s+ 的生成时间
各个主题安装极其不同，每个主题都需要单独学习其内在逻辑、变量、结构、生成方法，学习成本非常高
依赖性极高，很容易导致 gem 或 nodejs 依赖过期无效或出错
Jekyll 对配置文件的 tokens（比如指定变量名）经常改变和更新，很快你写的配置文件就不管用老报错了。
