网站最近更新

© 乙回庐 2017. All rights reserved.

Jekyll和Liquid的作弊纸

以下内容间接翻译自smutnyleszek的Gist页面

以下是大部分Jekyll(Liquid)的常用功能。您可以在GitHub Pages使用Jekyll,但是请确认您使用的软件版本是正确的。

运行

运行一个测试用的本地服务器

jekyll serve
jekyll serve --watch --baseurl ''

产生静态网页的输出:

jekyll build
jekyll build -w

-w--watch 会激活自动重输出,--baseurl '' 对于服务器测试是有用的。

调试

在Windows上如果你返回如下错误:

Liquid Exception: incompatible character encodings: UTF-8 and IBM437 in index.html

你需要修改code page:

chcp 65001

Liquid

输出

简单的输出样例:

Hello {{name}}
Hello {{user.name}}
Hello {{ 'leszek' }}

过滤输出

Word hello has {{ 'hello' | size }} letters!
Todat is {{ 'now' | date: "%Y %h" }}

有用的 where 过滤器的例子:用于获取 _data 的一个条目:

{% assign currentItem = site.data.foo | where:"slug","bar" %}
{{ newArray[0].name }}

常见的过滤器:

  • where – 从数组中选择属性为特定值的元素: {{ site.posts | where:"category","foo" }}
  • group_by – 按照某属性分组数组: {{ site.posts | group_by:"category" }}
  • markdownify – 转换Markdown为HTMl
  • jsonify – 转换数据为JSON: {{ site.data.dinosaurs | jsonify }}
  • date – 格式化日期 (syntax reference)
  • capitalize – 转换成首字母大写
  • downcase – 转换成小写字母
  • upcase – 转换成大写字母
  • first – 获取数组的第一个元素
  • last – 获取数组的最后一个元素
  • join – 使用特定的字符链接数组元素
  • sort – 按照属性排序数组的元素: {{ site.posts | sort: 'author' }}
  • size – 返回数组或字符串的大小
  • strip_newlines – 删除字符串中的所有换行符 (\n)
  • replace – 替换所有的子字符串: {{ 'foofoo' | replace:'foo','bar' }}
  • replace_first – 替换第一次出现的子字符串: {{ 'barbar' | replace_first:'bar','foo' }}
  • remove – 删除所有子字符串: {{ 'foobarfoobar' | remove:'foo' }}
  • remove_first – 删除第一个子字符串: {{ 'barbar' | remove_first:'bar' }}
  • truncate – 截断字符串至x个字符
  • truncatewords – 截断字符串至x个词
  • prepend – 在字符串前添加: {{ 'bar' | prepend:'foo' }}
  • append – 在字符串后添加: {{ 'foo' | append:'bar' }}
  • minus, plus, times, divided_by, modulo – 处理数字: {{ 4 | plus:2 }}
  • split – 按照模板分割字符串: {{ "a~b" | split:~ }}

标签

标签用来控制你的模板的逻辑。

注释

用来删除内容

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

If / Else

简单的选择表达式 ,if/unless, elsif [sic!] and else.

{% if user %}
    Hello {{ user.name }}
{% elsif user.name == "The Dude" %}
    Are you employed, sir?
{% else %}
    Who are you?
{% endif %}
{% unless user.name == "leszek" and user.race == "human" %}
    Hello non-human non-leszek
{% endunless %}
# array: [1,2,3]
{% if array contains 2 %}
    array includes 2
{% endif %}

Case

简单的多分枝选择表达式:

{% case condition %}
    {% when 1 %}
        hit 1
    {% when 2 or 3 %}
        hit 2 or 3
    {% else %}
        don't hit
{% endcase %}

For loop

简单的对于集合的循环:

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

简单的迭代型循环:

{% for i in (1..10) %}
    {{ i }}
{% endfor %}

一些辅助变量用来处理循环特殊情况:

  • forloop.length – 整个循环的循环次数
  • forloop.index – 当前循环的次数
  • forloop.index0 – 当前循环的次数 (从零开始)
  • forloop.rindex – 剩余的循环次数
  • forloop.rindex0 – 剩余的循环次数 (从零开始)
  • forloop.first – 第一次循环
  • forloop.last – 最后一次循环

限制与偏移集合:

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

反向循环(注:集合是有序的)

{% for item in array reversed %}
...

储存变量

储存数据在变量中:

{% assign name = 'leszek' %}

合并多个字符串到一个变量

{% capture full-name %}{{ name }} {{ surname }}{% endcapture %}

永久链接

永久链接由一个模板生成:

/:categories/:year/:month/:day/:title.html

以下是可用的变量:

  • year – 文件名的年份
  • short_year – 文件名的年份后两位
  • month – 文件名的月份
  • i_month – 文件名的月份(去除开头的0)
  • day – 文件名的日期
  • i_day – 文件名的日期(去除开头的0)
  • title – 文件名的标题
  • categories– 文章的分类
此文文长3061字,君不评论一二?
亲,给点评论吧!

展开本分类索引