记录在构建和使用过程中遇到的有一些常见问题.

原始输出

有时需要展示一些与Liquid产生冲突的内容时（如，我们需要展示liquid语句），我们需要暂时性的禁用标签的解析，这时就需要Raw标签了。

1
2
3
4
5
6

{% raw %}
    In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not. {% if aaa %}
{ % endraw %}  
  
// 在使用过程中注意去掉`{`和`%`之间的空格，因为我不这样写，我也没有办法输出它...很无奈。

注释

注释是最简单的标签，它只是把内容包含起来。

1
2
3

{% comment %} 注释内容 {% endcomment %}

Liquid 没有被解析

项目中要被 Liquid 解析的文档头部必须以两行 --- 三横线开头, 否则将不会被解析。

Liquid 默认值

1
2
3

{{ varA | default: aa}}

liquid 语法中使用上述结构获取变量值，和设置默认值。

但是 liquid 认为 当varA 的值为 nil, false 或 empty 时，会设置默认值。

所以，当变量为 bool 类型时， true获取到的值永远为 true

可参见 http://dfolio.free.fr/articles/2018/12/liquid-assign-boolean/

参考文献

guide