Jekyll/Liquid API 语法文档

前言

如果你只想快速搭建一个GitHub的静态网站，而暂时没有时间来研究 Jekyll 语法的话，建议直接 Fork 别人的主题源码。

当然，阅读一下之前我记录的一些笔记也可以增长一些知识：

• 建立 GitHub Pages 静态博客网站 介绍了使用 Jekyll 搭建的 GitHub Pages 操作
• GitHub Pages Issue 介绍博主在使用 GitHub Pages 的过程中遇到的问题及解决方法
• 讲解 Markdown 介绍了标准的 Markdown 语法及相关的扩展语法

现在博主想要整理一份相对完整的Jekyll语法，方便以后查阅参考。

具体官方文档地址请参考 Jekyll Documentation
这里主要介绍关于 Jekyll 的 API 语法，不是翻译官网内容。

开始

Jekyll is a parsing engine bundled as a ruby gem used to build static websites from dynamic components such as templates, partials, liquid code, markdown, etc.
Jekyll is known as “a simple, blog aware, static site generator”.

Jekyll 是什么？

Jekyll 是一个静态网站生成器。
Jekyll 通过标记语言 markdown 或 textile 和模板引擎 liquid 转换生成网页。
GitHub Pages 后台运行 Jekyll，为我们提供了一个地方贮存管理博客网页，我们可以使用 Jekyll 做一个自己的网站。

这里不介绍如何在本地安装使用 Jekyll，如果想本地使用，请参考官方文档：安装教程和使用教程
不过这里可以透漏一下，Jekyll 依赖于 ruby 开发平台。

目录结构

Jekyll 的标准目录结构如下：

.
├── _config.yml
├── _includes/
|   ├── footer.html
|   └── header.html
├── _layouts/
├── _posts/
|   ├── 2007-10-29-why-every-programmer-should-play-nethack.md
|   └── 2014-04-26-what-is-Jekyll.md
├── _drafts/
|   └── begin-with-the-crazy-ideas.md
├── _data/
|   └── members.yml # yaml files(end with ".yml" or ".yaml")
├── _site/
└── index.html      # => http://alfred-sun.github.com/

顺便提一下，执行 jekyll new SITENAME 可以快速的生成一个基础的 Jekyll site 网站示例。

文件介绍

_config.yml

Jekyll 的全局配置文件。
比如网站的名字，网站的域名，网站的链接格式等等。

_drafts

未发布的 posts 存放的地方，这里的 post 文件名不需要加日期标记。

_includes

该目录下的文件内容是最终要放进模版文件中的一些代码片段。
对于网站的头部，底部，侧栏等公共部分，为了维护方便，我们可能想提取出来单独编写，然后使用的时候包含进去即可。
这时我们可以把那些公共部分放在这个目录下，使用时只需要引入即可。

{ % include filename % }

_layouts

存放的一些模版文件，模版是用来包含并装饰 page 或 post 内容的。Jekyll的模版使用 HTML 语法来写，并包含 YAML Front Matter。
所有的模版都可用Liquid来与网站进行交互，都可以使用全局变量 site 和 page 。

site 变量: 包含该网站所有可以接触得到的内容和元数据(meta-data)
page 变量: 包含的是当前渲染的page或post的所有可以接触得到的数据

对于网站的布局，一般会写成模板的形式，这样对于写实质性的内容时，比如文章，只需要专心写文章的内容，然后加个标签指定用哪个模板即可。
对于内容，指定模板了模板后,我们可以称内容是模板的儿子。
为什么这样说呢？ 因为这个模板时可以多层嵌套的，内容实际上模板，只不过是叶子节点而已。

在模板中，引入儿子的内容：

{ { content } }

在儿子中，指定父节点模板：

注意，必须在子节点的顶部。

---
layout: post
---

_posts

发布的内容，比如博客文章，常放在这里面，而且一般作为叶子节点。
文件的命名必须遵循：YEAR-MONTH-DAY-title.MARKUP。

另外，所有放在根目录下并且不以下划线开头的文件夹中有格式的文件都会被 Jekyll 处理成 page。
这里说的有格式是指含有 YAML Front Matter 头部的文件。

所有的 post 和 page 都要用 markdown 或者 texile 或者 HTML 语法来写，可以包含 Liquid 模版的语法。而且必须要有 YAML Front Matter 头部( Jekyll 只处理具有 YAML Front Matter 的文件)。

YAML Front Matter 必须放在文件的开头，一对 --- 之间，用户可在这一对 --- 间设置预先定义的变量或用户自己的数据。具体看下面的说明。

_data

Jekyll 支持从该目录中加载 YAML、 JSON、 和 CSV 格式（.yml、yaml、json 或 csv 扩展名）的文件数据。用于配置一些全局变量，不过数据比较多，所以放在这里。
比如，多人参与网站开发，我们通常会在这里面定义一个 members.yml 文件。

例如文件内容为：

- name: Tom Preston-Werner
  github: mojombo

- name: Parker Moore
  github: parkr

然后在模板中我们就可以通过 site.data.members (注意：文件名决定变量名)使用这些数据。

<ul>
{ % for member in site.data.members % }
  <li>
    <a href="https://github.com/{ { member.github } }">
      { { member.name } }
    </a>
  </li>
{ % endfor % }
</ul>

_site

Jekyll 生成的网页默认输出的地方，一般需要在 .gitignore 中屏蔽掉这个目录。

index.html

主页文件，后缀有时也用 index.md 等。
这个需要根据自己的需要来写，因为不同的格式之间在某些情况下还是有一些细微的差别的。

其他静态资源

对于其他静态资源，可以直接放在根目录或任何其他目录，然后路径和平常的网站一样，按路径来找链接中的文件。

配置全局变量

虽然全局变量都有自己的默认配置，但是我们往往会手动配置为自己心中最好的效果。
另外，一些全局变量既可以在配置文件中设置，也可以在命令行选项参数里指定。

注意，配置不用使用 tab，否则可能会忽略那条命令。

源代码的位置

这个一般不配置，默认即可。

source: DIR

当然编译的时候也可以指定，但是使用 github 我们是不能指定参数的。

-s, --source DIR

输出网站位置

这个一般也是默认。

# 编译参数 -d, --destination DIR
destination: DIR #配置语法

Safe 开关

官方文档上就一句话：

Disable custom plugins, and ignore symbolic links.

大概意思是禁用常用的插件，忽略符号链接。

# 编译参数  --safe
safe: BOOL

Base URL

将 Jekyll 生成的网站内容放置在域名的子路径下面。

我们经常需要在多个地方运行 Jekyll，如发布到 GitHub Pages 前在本地预览下网站。--baseurl 标记就是为此而生的。

首先在 _config.yml 文件添加 baseurl，然后在网站各个链接的地方加前缀 {{site.baseurl}}。
当 jekyll serve 预览本地网站时，在本地域名后追加 --baseurl 的值（类似 / 这样的路径）。

# baseurl: "/blog"  编译参数: --baseurl URL
baseurl: URL

注意：所有的 page 和 post 的 URL 都是以斜线 / 领头，那么当 site.baseurl=/ 时，连接的 URL 会出现两个重复的 / 而破坏超链接。因此，建议只在 baseurl 有具体值时才使用 site.baseurl 给 URL 加前缀。

忽略文件

这个很有用，有时候你写了一个文件，里面的一个东西可能会被 Jekyll 处理，但是你不想让 Jekyll 处理的话，就使用这个语法忽略那些文件。

exclude: [DIR, FILE, ...]

强制处理文件

有时候我们的一些文件的名字由于不在 Jekyll 处理的文件名字范围内，这时候就需要强制处理这些文件了。比如 .htaccess 文件。

# include: [".htaccess"]
include: [DIR, FILE, ...]

时区

模板中经常会对时间进行转换，这个时候如果至指定时区的话，可能得到的时间会和我们想要的时间错几个小时。在这里能查看到可用的值。

# timezone: Asia/Shanghai
timezone: TIMEZONE

编码

大家都是程序员，就不用多说了。
执行 ruby -e 'puts Encoding::list.join("\n")' 可列出本地 Ruby 可用的编码。

# encoding : utf-8
encoding: ENCODING

文章链接格式

我们可以自定义 Post 的 URL 格式，通过 permalink 来配置。比如：

# 设定 permalink 取值
permalink: /:year/:month/:day/:title.html
# 那么 post: 2014-10-19-slap-chop.md 最终输出的路径 URL 变成
# /2014/10/19/slap-chop.html

permalink: /:month-:day-:year/:title  # => /04-29-2009/slap-chop/index.html

permalink: pretty    # => /2009/04/29/slap-chop/index.html

另外，还有3种内置的链接格式可以使用：

分页

通常我们都不想把所有的 Post 都放在一页显示，而是要分成多页显示。好在 Jekyll 支持分页显示，通过 paginate 和 paginate_path 两个变量来设置每页显示的数量和分页 HTML 的 URL 路径。

paginate: 5
paginate_path: "blog/page:num/"

根据上面的配置，Jekyll 会读取 blog/index.html 文件，把每页赋值给全局变量 paginator，并输出 HTML 分页文件，如：第2页为 blog/page2/index.html。其中，“page” 是字符常量，变量 :num 是分页的页码，自动从 2 开始编码，因此在罗列所有页面页码及它们的超链接时要注意一下，首页链接没有中间的 “page1” 路径。
通过 paginator 的相关属性我们可以实现在不同页间切换。

<!-- This loops through the paginated posts -->
{% for post in paginator.posts %}
  <h1><a href="{{ post.url }}">{{ post.title }}</a></h1>
  <p><span class="date">{{ post.date }}</span></p>
  <div class="content">
    {{ post.content }}
  </div>
{% endfor %}

<!-- Pagination links -->
<div class="pagination">
  {% if paginator.previous_page %}
    <a href="{{ paginator.previous_page_path }}" class="previous">Previous</a>
  {% else %}
    <span class="previous">Previous</span>
  {% endif %}
  <span class="page_number ">Page: {{ paginator.page }} of {{ paginator.total_pages }}</span>
  {% if paginator.next_page %}
    <a href="{{ paginator.next_page_path }}" class="next">Next</a>
  {% else %}
    <span class="next ">Next</span>
  {% endif %}
</div>

默认值设定

设置 YAML Front Matter 变量的默认值。
写 post 时，经常需要在每篇文章的 YAML 头部设定一些相同的变量使用，比如：author、layout等。为了避免这些不必要的重复性操作，我们可以在配置文件中设定他们的默认值；
同时在必要的时候，还可以对具体文件设定头部变量，覆盖其默认值。下面很快就会说这点。

# In _config.yml, set the layout and author for files where the type is "posts".
# And any html files that exist in the "projects/" folder will use the "project" layout, if it exists.
...
defaults:
  -
    scope:
      path: ""      # an empty string here means all files in the project
      type: "posts" # previously `post` in Jekyll 2.2.
    values:
      layout: "post"
      author: "Alfred Sun"
  -
    scope:
      path: "projects"
      type: "pages"     # previously `page` in Jekyll 2.2.
    values:
      layout: "project" # overrides previous default layout

Jekyll 模板、变量

Jekyll 模板实际上分两部分：一部分是头部定义，另一部分是 Liquid 语法。

头部定义

主要用于指定模板(layout)和定义一些变量，比如：标题(title)、描述(description)、标签(tags)、分类(category/categories)、是否发布(published)，以及其他自定义的变量。

---
layout:     post   # 指定使用的模板文件，“_layout” 目录下的模板文件名决定变量名
title:      title  # 文章的标题
date:       date   # 覆盖文章名中的日期
category:   blog   # 文章的类别
description: description
published:  true   # default true 设置 “false” 后，文章不会显示
permalink:  /:categories/:year/:month/:day/:title.html  # 覆盖全局变量设定的文章发布格式
---

注意：如果文本文件使用的是 utf-8 编码，那么必须确保文件中不存在 BOM 头部字符，尤其是当 Jekyll 运行在 Windows 平台上。

使用变量

关于 Jekyll 的变量，可以参考官方说明
上面文章页面中定义的头部变量，需要使用下面的语法获得：

page.title

这些自定义的变量将会被传递给 Liquid 模板引擎用于转换文本文件，例如，你可以用上面定义的 “title” 变量在 layout 中设置页面的标题：

<!DOCTYPE HTML>
<html>
  <head>
    <title>{{ page.title }}</title>
  </head>
  <body>
   ...
  </body>
</html>

所有的变量都是一个树节点，比如：page 就是当前页面的根节点。

其中全局根结点有：

• site： _config.yml 中配置的信息
• page： 页面的配置信息，包括 YAML 中定义的变量
• content： 用在模板文件中，该变量包含页面的子视图，用于引入子节点的内容；不能在 post 和 page 文件中使用
• paginator： 分页信息，需要事先设定 site 中的 paginate 值，参考 Pagination

注意：post 变量仅作用于 for 循环内部，如 { % for post in site.posts % } 。假如需要访问当前正在渲染的文章页面的变量，就要用 page 变量代替 post 对象。比如，post 的 title 变量，要通过 page.title 来访问。

site 下的变量

page 下的变量

paginator 下的变量

分页只在 index 页面中有效，index 页面可以在子目录里，比如：主页在 /blog/index.html，那么通过配置 paginate_path: "blog/page:num/"，主页里面放不下的其他内容就可以设定在第 2 页 blog/page2/index.html 以及后面的页面中。

Liquid 语法

Liquid 是 Ruby 的一个模版引擎库，Jekyll中用到的Liquid标记有两种：输出和标签。

• Output 标记：变成文本输出，被2层成对的花括号包住，如：{{ content }}
• Tag 标记：执行命令，被成对的花括号和百分号包住，如：{% command %}

Jekyll 输出 Output

示例：

Hello {{name}}
Hello {{user.name}}
Hello {{ 'tobi' }}

Output 标记可以使用过滤器 Filters 对输出内容作简单处理。
多个 Filters 间用竖线隔开，从左到右依次执行，Filter 左边总是输入，返回值为下一个 Filter 的输入或最终结果。

Hello {{ 'tobi' | upcase }}  # 转换大写输出
Hello tobi has {{ 'tobi' | size }} letters!  # 字符串长度
Hello {{ '*tobi*' | markdownify | upcase }}  # 将Markdown字符串转成HTML大写文本输出
Hello {{ 'now' | date: "%Y %h" }}  # 按指定日期格式输出当前时间

标准过滤器 Filters

下面是常用的过滤器方法，更多的API需要查阅源代码（有注释）才能看到。

源码主要看两个 Ruby Plugin 文件：filters.rb(Jekyll) 和 standardfilters.rb(Liquid)。

（这也是博主刚开始使用Jekyll的时候，比较头疼的问题。由于官方没有给出详细API的说明，只能去源代码那里看啦，好在代码的注释比较详细）

• date - 将时间戳转化为另一种格式 (syntax reference)
• capitalize - 输入字符串首字母大写 e.g. {{ 'capitalize me' | capitalize }} # => 'Capitalize me'
• downcase - 输入字符串转换为小写
• upcase - 输入字符串转换为大写
• first - 返回数组中第一个元素
• last - 返回数组数组中最后一个元素
• join - 用特定的字符将数组连接成字符串输出
• sort - 对数组元素排序
• map - 输入数组元素的一个属性作为参数，将每个元素的属性值映射为字符串
• size - 返回数组或字符串的长度 e.g. {{ array | size }}
• escape - 将字符串转义输出 e.g. {{ "<p>test</p>" | escape }} # => <p>test</p>
• escape_once - 返回转义后的HTML文本，不影响已经转义的HTML实体
• strip_html - 删除 HTML 标签
• strip_newlines - 删除字符串中的换行符(\n)
• newline_to_br - 用HTML <br/> 替换换行符 \n
• replace - 替换字符串中的指定内容 e.g. {{ 'foofoo' | replace:'foo','bar' }} # => 'barbar'
• replace_first - 查找并替换字符串中第一处找到的目标子串 e.g. {{ 'barbar' | replace_first:'bar','foo' }} # => 'foobar'
• remove - 删除字符串中的指定内容 e.g. {{ 'foobarfoobar' | remove:'foo' }} # => 'barbar'
• remove_first - 查找并删除字符串中第一处找到的目标子串 e.g. {{ 'barbar' | remove_first:'bar' }} # => 'bar'
• truncate - 截取指定长度的字符串，第2个参数追加到字符串的尾部 e.g. {{ 'foobarfoobar' | truncate: 5, '.' }} # => 'foob.'
• truncatewords - 截取指定单词数量的字符串
• prepend - 在字符串前面添加字符串 e.g. {{ 'bar' | prepend:'foo' }} # => 'foobar'
• append - 在字符串后面追加字符串 e.g. {{ 'foo' | append:'bar' }} # => 'foobar'
• slice - 返回字符子串指定位置开始、指定长度的子串 e.g. {{ "hello" | slice: -4, 3 }} # => ell
• minus - 减法运算 e.g. {{ 4 | minus:2 }} # => 2
• plus - 加法运算 e.g. {{ '1' | plus:'1' }} #=> '11', {{ 1 | plus:1 }} # => 2
• times - 乘法运算 e.g {{ 5 | times:4 }} # => 20
• divided_by - 除法运算 e.g. {{ 10 | divided_by:2 }} # => 5
• split - 根据匹配的表达式将字符串切成数组 e.g. {{ "a~b" | split:"~" }} # => ['a','b']
• modulo - 求模运算 e.g. {{ 7 | modulo:4 }} # => 3

Jekyll 标签 Tag

标签用于模板中的执行语句。目前 Jekyll/Liquid 支持的标准标签库有：

1. Comments

仅起到注释 Liquid 代码的作用。

We made 1 million dollars {% comment %} in losses {% endcomment %} this year.

2. Raw

临时禁止执行 Jekyll Tag 命令，在生成的内容里存在冲突的语法片段的情况下很有用。

{% raw % }
  In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not.
{% endraw % }

3. If / Else

条件语句，可以使用关键字有：if、unless、elsif、else。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
{% if user %}
  Hello {{ user.name }}
{% endif %}

# Same as above
{% if user != null %}
  Hello {{ user.name }}
{% endif %}

{% if user.name == 'tobi' %}
  Hello tobi
{% elsif user.name == 'bob' %}
  Hello bob
{% endif %}

{% if user.name == 'tobi' or user.name == 'bob' %}
  Hello tobi or bob
{% endif %}

{% if user.name == 'bob' and user.age > 45 %}
  Hello old bob
{% endif %}

{% if user.name != 'tobi' %}
  Hello non-tobi
{% endif %}

# Same as above
{% unless user.name == 'tobi' %}
  Hello non-tobi
{% endunless %}

# Check for the size of an array
{% if user.payments == empty %}
   you never paid !
{% endif %}

{% if user.payments.size > 0  %}
   you paid !
{% endif %}

{% if user.age > 18 %}
   Login here
{% else %}
   Sorry, you are too young
{% endif %}

# array = 1,2,3
{% if array contains 2 %}
   array includes 2
{% endif %}

# string = 'hello world'
{% if string contains 'hello' %}
   string includes 'hello'
{% endif %}

4. Case 语句

适用于当条件实例很多的情况。

{% case template %}
{% when 'label' %}
     // {{ label.title }}
{% when 'product' %}
     // {{ product.vendor | link_to_vendor }} / {{ product.title }}
{% else %}
     // {{page_title}}
{% endcase %}

5. Cycle

经常需要在相似的任务间选择时，可以使用 cycle 标签。

{% cycle 'one', 'two', 'three' %}
{% cycle 'one', 'two', 'three' %}
{% cycle 'one', 'two', 'three' %}
{% cycle 'one', 'two', 'three' %}

# =>

one
two
three
one

如果要对循环作分组处理，可以指定分组的名字：

{% cycle 'group 1': 'one', 'two', 'three' %}
{% cycle 'group 1': 'one', 'two', 'three' %}
{% cycle 'group 2': 'one', 'two', 'three' %}
{% cycle 'group 2': 'one', 'two', 'three' %}

# =>
one
two
one
two

6. For loops

循环遍历数组：

{% for item in array %}
  {{ item }}
{% endfor %}

循环迭代 Hash散列，item[0] 是键，item[1] 是值：

{% for item in hash %}
  {{ item[0] }}: {{ item[1] }}
{% endfor %}

每个循环周期，提供下面几个可用的变量：

forloop.length      # => length of the entire for loop
forloop.index       # => index of the current iteration
forloop.index0      # => index of the current iteration (zero based)
forloop.rindex      # => how many items are still left ?
forloop.rindex0     # => how many items are still left ? (zero based)
forloop.first       # => is this the first iteration ?
forloop.last        # => is this the last iteration ?

还有几个属性用来限定循环过程：

limit:int： 限制循环迭代次数
offset:int： 从第n个item开始迭代
reversed： 反转循环顺序

# array = [1,2,3,4,5,6]
{% for item in array limit:2 offset:2 %}
  {{ item }}
{% endfor %}
# results in 3,4

{% for item in collection reversed %}
  {{item}}
{% endfor %}

{% for post in site.posts limit:20 %}
  {{ post.title }}
{% endfor %}

允许自定义循环迭代次数，迭代次数可以用常数或者变量说明：

# if item.quantity is 4...
{% for i in (1..item.quantity) %}
  {{ i }}
{% endfor %}
# results in 1,2,3,4

7. Variable Assignment

为变量赋值，用于输出或者其他 Tag：

{% assign index = 1 %}
{% assign name = 'freestyle' %}

{% for t in collections.tags %}{% if t == name %}
  <p>Freestyle!</p>
{% endif %}{% endfor %}


# 变量是布尔类型
{% assign freestyle = false %}

{% for t in collections.tags %}{% if t == 'freestyle' %}
  {% assign freestyle = true %}
{% endif %}{% endfor %}

{% if freestyle %}
  <p>Freestyle!</p>
{% endif %}

capture 允许将大量字符串合并为单个字符串并赋值给变量，而不会输出显示。

{% capture attribute_name %}{{ item.title | handleize }}-{{ i }}-color{% endcapture %}

<label for="{{ attribute_name }}">Color:</label>
<select name="attributes[{{ attribute_name }}]" id="{{ attribute_name }}">
  <option value="red">Red</option>
  <option value="green">Green</option>
  <option value="blue">Blue</option>
</select>

其他模板语句

字符转义

有时候想输出 { 了，怎么办？ 使用反斜线 \\ 转义即可

\{ => {

格式化时间

{{ site.time | date_to_xmlschema }}		# => 2008-11-07T13:07:54-08:00
{{ site.time | date_to_rfc822 }}		# => Mon, 07 Nov 2008 13:07:54 -0800
{{ site.time | date_to_string }}		# => 07 Nov 2008
{{ site.time | date_to_long_string }}	# => 07 November 2008

代码语法高亮

安装好 pygments.rb 的 gem 组件和 Python 2.x 后，配置文件添加：highlighter: pygments，就可以使用语法高亮命令了，支持语言多达 100 种以上。

{% highlight ruby linenos %}
# some ruby code
{% endhighlight %}

上面的示例中，使用 highlight 语句来处理代码块；并设定第一个参数 ruby 来指定高亮的语言 Ruby，第二个参数 linenos 来开启显示代码行号的功能。

为了给代码着色，需要配置相应的样式文件，参考 syntax.css；
为了更好的显示行号，可以在上面的 CSS 文件添加 .lineno 样式类。

可用的语言识别符缩写，从 Pygments’ Lexers Page 查阅。
如果从 Pygments 的 Supported Languages 清單，能發現明明有列出該語言名稱，而 pygments.rb 确无法识别该语言，這時候必須到 Available Lexers 查詢；如果在程序語言的說明中有一行“ New in version 1.5. ”，那就表示只要將 Pygments 更新到 1.5 版， 即可支持该程序语言。

链接同域内的 post

使用 post_url Tag 可以自动生成网站内的某个 post 超链接。
这个命令语句以相关 post 的文件名为参数，在引入同域的 post 链接时，非常有用。

# 自动生成某篇文章的链接地址
{% post_url 2010-07-21-name-of-post %}

# 引入该文章的链接
[Name of Link]({% post_url 2010-07-21-name-of-post %})

Gist 命令

嵌入 GitHub Gist，也可以指定要显示的 gist 的文件名。

{% gist parkr/931c1c8d465a04042403 %}
{% gist parkr/931c1c8d465a04042403 jekyll-private-gist.markdown %}

生成摘要

配置文件中设定 excerpt_separator 取值，每篇 post 都会自动截取从开始到这个值间的内容作为这篇文章的摘要 post.excerpt 使用。
如果要禁用某篇文章的摘要，可以在该篇文章的 YAML 头部设定 excerpt_separator: "" 。

{ % for post in site.posts % }
  <a href="{ { post.url } }">{ { post.title } }</a>
  { { post.excerpt | remove: 'test' } }
{ % endfor % }

删除 HTML 标签

这个在摘要作为 head 标签里的 meta="description" 内容输出时很有用

{ { post.excerpt | strip_html } }

删除指定文本

过滤器 remove 可以删除变量中的指定内容

{ { post.url | remove: 'http' } }

CGI Escape

通常用于将 URL 中的特殊字符转义为 %xx 形式

{ { "foo,bar;baz?" | cgi_escape } }  # => foo%2Cbar%3Bbaz%3F

排序

# Sort an array. Optional arguments for hashes:
#   1. property name
#   2. nils order ('first' or 'last')

{ { site.pages | sort: 'title', 'last' } }

搜索指定 Key

# Select all the objects in an array where the key has the given value.
{ { site.members | where:"graduation_year","2014" } } 

To JSON 格式

将 Hash 散列或数组转换为 JSON 格式

{ { site.data.projects | jsonify } }

序列化

把一个数组变成一个字符串

{ { page.tags | array_to_sentence_string } }  # => foo, bar, and baz

单词的个数

{ { page.content | number_of_words } }

内容名字规范

对于博客 post，文件命名规则必须是 YEAR-MONTH-DAY-title.MARKUP 的格式。
使用 rake post 会自动将 post 文件合适命名。

比如：

2014-11-06-memcached-code.md
2014-11-06-memcached-lib.md
2014-11-06-sphinx-config-and-use.md
2014-11-07-memcached-hash-table.md
2014-11-07-memcached-string-hash.md

Assets 样式文件

Jekyll 支持 Sass 和 CoffeeScript，通过新建 .sass、.scss 或 .coffee 格式的文件，并在开头添加一对 --- 来使用这个功能。

关于详细的使用，请参看官方说明，这里就不再做介绍了。