基础知识
入门
Liquid是安全、面向客户的模板语言，用于构建灵活的 web 应用。
由 Shopify 创造并用 Ruby 实现。它是 Shopify主题的骨骼，并且被用于加载店铺系统的动态内容。
GitHub:https://github.com/Shopify/liquid
对象（Object）
告诉 Liquid 在页面的哪个位置展示内容，对象和变量使用{{ }}标识。
标记（Tag）
标记创建模板的逻辑和控制流，使用{% %}标识。
过滤器（Filter)
改变Liquid对象的输出，通过|分隔。
{% comment %}对象{% endcomment %}
{{ page.Title }}
{% comment %}标记{% endcomment %}
{% if page %}
Hello {{ page.Title }} ！
{% endif %}
{% comment %}过滤器{% endcomment %}
{{ "adam!" | capitalize | prepend: "Hello " }}
操作符
== 相等 != 不相等 > 大于 < 小于 >= 大于或等于 <= 小于或等于 or 逻辑或 and 逻辑与
真值（Truthy）与假值（falsy）
- 除nil和false之外的值都是真值
- 字符串即使为空字符也是真值
数据类型
- String（字符串）Number（数字）Boolean（布尔）Nil（空）Array（数组）
- 通过assign或 capture对变量进行初始化
{% assign my_string = "Hello World!" %}
{% assign my_int = 25 %}
{% assign my_float = 39.756 %}
{% assign foo = true %}
控制输出的空行
使用{{- -}}、{%- -%}，删除空行
Tags
判断语句
- if、unless、elsif\else
- case\when
{% if page.Title=="1" %}
//条件成立输出内容
{% elsif page.Title="2" %}
//输出内容
{% else %}
//输出内容
{% endif %}
{% unless page.Title=="1"%}
//条件不成立输出内容
{% endunless %}
{% assign handle = 'cake' %}
{% case handle %}
{% when 'cake' %}
This is a cake
{% when 'cookie' %}
This is a cookie
{% else %}
This is not a cake nor a cookie
{% endcase %}
循环
- for循环/break停止循环/continue跳出当前循环
- ==limit== 限定循环执行的次数
- ==offset== 从指定索引号开始执行循环。
- ==range== 定义循环执行的范围。可利用数字或变量来定义此执行范围。
- ==reversed== 反转循环的执行顺序。注意和 reverse 过滤器（filter）的拼写是不同的。
- ==cycle== 循环一组字符串并按照它们传入的顺序将其输出。每次调用 cycle时，传入的参数中的下一个字符串将被输出。
- ==tablerow== 生成一个 HTML 表格。必须用 <table> 和 </table> 这两个 HTML 标签将其包裹起来。
{% for product in collection.products %}
{{ product.title }}
{% endfor %}
{% for i in (1..5) %}
{% if i == 4 %}
{% break %}
{% else %}
{{ i }}
{% endif %}
{% endfor %}
{% for i in (1..5) %}
{% if i == 4 %}
{% continue %}
{% else %}
{{ i }}
{% endif %}
{% endfor %}
//cols指定列数
{% tablerow product in collection.products cols:2 %}
{{ product.title }}
{% endtablerow %}
禁止处理内容
raw 标记临时禁止处理其所包围的代码。如果输出的内容与 Liquid 模板语言有冲突时，可以避免冲突。
{% raw %}
In Handlebars, {{ this }} will be HTML-escaped, but
{{{ that }}} will not.
{% endraw %}
变量
- assign
- capture
- increment 创建一个全新的数值变量，每次调用时值 +1。初始值是 0。
- decrement 创建一个全新的数值变量，每次调用时值 -1。初始值是 -1。
{% assign my_variable = false %}
{% capture about_me %}
I am {{ age }} and my favorite food is {{ favorite_food }}.
{% endcapture %}
{% increment my_counter %}
{% increment my_counter %}
{% increment my_counter %}
Filter速查
abs
- 返回一个数字的绝对值。
- {{ -17 | abs }}
append
- 将两个字符串拼接起来并返回拼接之后的值。
- {{ "/my/fancy/url" | append: ".html" }}
at_least
- 将数字限制在最小值。数字不能小于取小值，否则返回最小值
- {{ 4 | at_least: 5 }}
at_most
- 将数字限制在最大值。
capitalize
- 将字符串首字母转为大写。
- {{ "title" | capitalize }} output:Title
ceil
- 将一个浮点数向上取整并返回一个最接近的整数。在 ceil 过滤器执行之前 Liquid 会先尝试将输入转换为数字格式。
- {{ 1.2 | ceil }} output:2
compact
- 删除数组中的所有 nil 值。
- {% assign site_categories = site.pages | map: 'category' | compact %}
concat
- 连接数组
{% assign furniture = "chairs, tables, shelves" | split: ", " %}
{% assign everything = fruits | concat: vegetables | concat: furniture %}
{% for item in everything %}
- {{ item }}
{% endfor %}
date
- 将时间戳（timestamp）转换为另一种日期格式。格式化语法与 strftime 一致。输入格式与 Ruby 中的 Time.parse 一致。
- {{ article.published_at | date: "%a, %b %d, %y" }}
default
- 指定一个默认值，以防预期的值不存在。如果左侧的值为 nil、false 或空，default 将输出此默认值。
- {{ product_price | default: 2.99 }}
divided_by
- 将两个数相除。如果除数（divisor）为整数，则将相除之后得到的结果向下取整得到最接近的整数（也就是对应 floor 的功能）。
- {{ 5 | divided_by: 3 }} output:1
- {{ 20 | divided_by: 7.0 }} output:2.857142857142857
downcase
- 用于将字符串中的各个字符转换为小写形式。对于已经是小写形式的字符串没有任何影响。
escape
- 对字符串转义操作就是将字符串中的某些字符替换为转义序列（escape sequence），这样整个字符串就能够用于 URL了。如果字符串不需要转义则不会对字符串做任何操作。
escape_once
- 转义一个字符串并且不修改已经转义过的实体（entities)。对于无须转义的字符串不做任何修改。
first
- 返回数组的第一项。
floor
- 将一个浮点数通过舍弃小数部分得到最近的整数。在 floor 过滤器执行之前 Liquid 会先尝试将输入转换为数字格式。
join
- 将数组中的各个字符串合并为一个字符串，并将 split 参数作为字符串之间的分隔符。
- {% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
- {{ beatles | join: " and " }}
last
- 返回数组中的最后一项。
lstrip
- 删除字符串左侧的所有空白符（制表符、空格和换行符）。字符串中间的所有空白符不受影响。
map
- 从对象（object）中提取指定名称的属性的值，并用这些值构建一个数组。
- {% assign all_categories = site.pages | map: "category" %}
minus
- 从一个数中减去另一个数。
modulo
- 返回除法运算的余数。
newline_to_br
- 将所有换行符(\n) 替换为 HTML 的 (
) 标签。
plus
- 两个数相加。
prepend
- 在一个字符串前面附加另一个字符串。
remove
- 从一个字符串中删除所有出现的另一个子字符串。
remove_first
- 从一个字符串中仅仅删除第一次出现的另一个子字符串。
replace
- 将参数中给出的第一个参数全部替换为第二个参数。
- {{ "Take my protein " | replace: "my", "your" }}
replace_first
- 将字符串中出现的第一个参数替换为第二个参数。
reverse
- 将数组中的所有项的顺序反转。reverse 不能操作字符串。
- reverse 不能直接应用到字符串上，但是你可以先将字符串分割成字符数组，然后再将数组反转，最后将反转之后的数组合并。
- {{ "Ground control to Major Tom." | split: "" | reverse | join: "" }}
round
- 将浮点数舍入到最近的整数，或者，如果传入的参数是一个数值的话，将浮点数舍入到参数指定的小数位。四舍五入
rstrip
- 将字符串右侧的所有空白字符（制表符 - tab、空格符 - space 和 回车符 - newline）删除。
size
- 返回字符串中所包含的字符数或者数组中所包含的条目数量。size 还支持“点标记”（例如 {{ my_string.size }}）。这种用法便于你在标签（tag）中使用 size 过滤器，例如条件判断标签（tag）。
{{ "Ground control to Major Tom." | size }}
//输出28
{% assign my_array = "apples, oranges, peaches, plums" | split: ", " %}
{{ my_array | size }}
//输出4
//使用“点标记”：
{% if site.pages.size > 10 %}
This is a big website!
{% endif %}
slice
- 字符串剪切，只传入一个参数时将返回此参数作为下标所对应的单个字符。第二个参数是可选的，用于指定返回的子字符串的长度。
sort
- 对数组中的所有进行排序。排序后的数组是按照区分大小写的顺序排列的。
sort_natural
- 对数组进行排序，并且大小写无关。
split
- 根据参数传入的分隔符将字符串分解为数组。split通常被用于将以逗号为分隔符的字符串转换为数组。
- {% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
strip
- 删除字符串左右两侧的所有空白符号（包括制表符、空格、换行符）。对于字符串中间的空白符不做任何处理。
strip_html
- 从字符串中删除所有 HTML 标签。
strip_newlines
- 从字符串中删除所有换行字符（newline character）。
times
- 将一个数乘以另一个数。
truncate
- truncate 将字符串截短为指定的字符个数。如果指定的字符数量小于字符串的长度，则会在字符串末尾添加一个省略号(…) 并将此省略号计入字符个数中。
- 自定义省略号
truncatewords
- 将字符串截短为指定的单词个数。如果指定的单词数量小于字符串中包含的单词个数，则会在字符串末尾添加一个省略号(…)。
- 自定义省略号 {{ "Ground control to Major Tom." | truncatewords: 3, "--" }}
uniq
- 删除数组中的所有重复项。
upcase
- 将字符串中的每个字符都转换为大写形式。对于已经全是大写的字符串不做任何操作。
url_decode
- 对于作为 URL 进行编码或通过 url_encode 编码的字符串进行解码。
url_encode
- 将字符串中非 URL 安全的字符转换为百分号编码（percent-encoded）的字符。
where
- 创建一个数组，仅包含具有给定属性值的对象，或默认情况下的任何truthy值。
All products:
{% for product in products %}
- {{ product.title }}
{% endfor %}
{% assign kitchen_products = products | where: "type", "kitchen" %}
Kitchen products:
{% for product in kitchen_products %}
- {{ product.title }}
{% endfor %}
