fix: throw an error if : omitted unintentionally, #212, #208

docs/source/zh-cn/tutorials/differences.md

@@ -0,0 +1,21 @@
+---
+title: 和 Shopify/liquid 的区别
+---
+
+[Shopify/liquid](https://github.com/Shopify/liquid) 中的所有标签和过滤器 LiquidJS 都支持，但不包括 Shopify 主题中业务逻辑相关的标签和过滤器（如果你在找这些标签可以参考 [插件列表][plugins]，也欢迎把你的插件添加到列表中）。尽管原则上我们尽力兼容于 Shopify/liquid，但仍然存在一些区别：
+
+* 真和假。在 LiquidJS 中 `undefined`, `null`, `false` 是假，之外的都是真；在 Ruby 中 `nil` 和 `false` 是假，其他都是真。见 [#26][#26]。
+* 数字。JavaScript 不区分浮点数和整数，因此缺失一部分整数算术，见 [#59][#59]。此外 `size` 过滤器作用于数字时总是返回零，而不是 Ruby 中的浮点数或整数的内存大小。
+* Drop 中的 [.to_liquid()](https://github.com/Shopify/liquid/wiki/Introduction-to-Drops) 替换为 `.toLiquid()`。
+* 数据的 [.to_s()](https://www.rubydoc.info/gems/liquid/Liquid/Drop) 替换为 `.toString()`。
+* 对象的迭代顺序。JavaScript 对象的迭代顺序是插入顺序和数字键递增顺序的组合，但 Ruby Hash 中只是插入顺序（JavaScript 字面量 Object 和 Ruby 字面量 Hash 的插入顺序解释也不同）。
+* 排序稳定性。shopify/liquid 和 LiquidJS 都没有定义 [sort][sort] 过滤器的稳定性在，它取决于 Ruby/JavaScript 内置的排序算法，在 Node.js 12+ 和 Google Chrome 70+ LiquidJS 的排序是 [稳定的][stable-sort]。
+* shopify/liquid 允许过滤器尾部的未匹配字符，但 LiquidJS 不允许。这就是说如果过滤器参数前忘记写冒号比如 `{%raw%}{{ "a b" | split " "}}{%endraw%}` LiquidJS 会抛出异常。这是为了提升 Liquid 模板的易用性，参考 [#208][#208] 和 [#212][#212]。
+
+[#26]: https://github.com/harttle/liquidjs/pull/26
+[#59]: https://github.com/harttle/liquidjs/issues/59
+[#208]: https://github.com/harttle/liquidjs/issues/208
+[#212]: https://github.com/harttle/liquidjs/issues/212
+[sort]: https://liquidjs.com/filters/sort.html
+[stable-sort]: https://v8.dev/features/stable-sort
+[plugins]: ./plugins.html#插件列表

docs/source/zh-cn/tutorials/intro-to-liquid.md

@@ -1,7 +1,9 @@
 ---
-title: 基本语法
+title: Liquid 模板语言简介
 ---
 
+LiquidJS 是一个简单的、安全的、兼容 Shopify 的、纯 JavaScript 编写的模板引擎。这个项目的目的是为 JavaScript 社区提供一个 Liquid 模板引擎的实现。Liquid 最初用 Ruby 实现并用于 Github Pages, Jekyll 和 Shopify，参考 [和 Shopify/liquid 的区别][diff]。
+
 LiquidJS 语法相对简单。LiquidJS 中有两种标记：
 
 - **标签**。标签由标签名和参数构成，由 `{%raw%}{%{%endraw%}` 和 `%}` 包裹。
@@ -50,3 +52,4 @@ LiquidJS 语法相对简单。LiquidJS 中有两种标记：
 [这里](../tags/overview.html) 是 LiquidJS 支持的完整的标签列表。
 
 [shopify/liquid]: https://github.com/Shopify/liquid
+[diff]: ./differences.html

docs/source/zh-cn/tutorials/setup.md

@@ -2,7 +2,7 @@
 title: 安装和使用
 ---
 
-LiquidJS 是一个简单的、安全的、兼容 Shopify 的、纯 JavaScript 编写的模板引擎。这个项目的目的是为 JavaScript 社区提供一个 Liquid 模板引擎的实现。
+如果你还不了解 Liquid 模板语言，请参考 [Liquid 模板语言简介][intro]。
 
 ## 在 Node.js 里使用
 
@@ -65,4 +65,6 @@ echo 'Hello, {{ name }}.' | npx liquidjs '{"name": "Snake"}'
 
 ## 其他
 
-[@stevenanthonyrevo](https://github.com/stevenanthonyrevo) 还提供了一个 ReactJS demo，请参考 [liquidjs/demo/reactjs/](https://github.com/harttle/liquidjs/blob/master/demo/reactjs/)。
+[@stevenanthonyrevo](https://github.com/stevenanthonyrevo) 还提供了一个 ReactJS demo，请参考 [liquidjs/demo/reactjs/](https://github.com/harttle/liquidjs/blob/master/demo/reactjs/)。
+
+[intro]: ./intro-to-liquid.html