From 117eaf57c32ed757769135dcd63b8d8094e81bbe Mon Sep 17 00:00:00 2001 From: Harttle Date: Sat, 22 Jan 2022 23:24:06 +0800 Subject: [PATCH] docs: add additional filters/tags as differences, closes #331 --- dist/.gitignore | 0 docs/source/tutorials/differences.md | 4 ++++ docs/source/zh-cn/tutorials/differences.md | 4 ++++ 3 files changed, 8 insertions(+) delete mode 100644 dist/.gitignore diff --git a/dist/.gitignore b/dist/.gitignore deleted file mode 100644 index e69de29bb..000000000 diff --git a/docs/source/tutorials/differences.md b/docs/source/tutorials/differences.md index 421042ae9..97832656a 100644 --- a/docs/source/tutorials/differences.md +++ b/docs/source/tutorials/differences.md @@ -11,7 +11,11 @@ All filters and tags in [shopify/liquid](https://github.com/Shopify/liquid) are * Iteration order for objects. The iteration order of JavaScript objects, and thus LiquidJS objects, is a combination of the insertion order for string keys, and ascending order for number-like keys, while the iteration order of Ruby Hash is simply the insertion order. * Sort stability. The [sort][sort] stability is also not defined in both shopify/liquid and LiquidJS, but it's [considered stable][stable-sort] for LiquidJS in Node.js 12+ and Google Chrome 70+. * Trailing unmatched characters inside filters are allowed in shopify/liquid but not in LiquidJS. It means filter arguments without a colon like `{%raw%}{{ "a b" | split " "}}{%endraw%}` will throw an error in LiquidJS. This is intended to improve Liquid usability, see [#208][#208] and [#212][#212]. +* LiquidJS has additional tags: [layout][layout] and corresponding `block` tag. +* LiquidJS has additional filters: [json][json]. +[layout]: https://liquidjs.com/tags/layout.html +[json]: https://liquidjs.com/filters/json.html [#26]: https://github.com/harttle/liquidjs/pull/26 [#59]: https://github.com/harttle/liquidjs/issues/59 [#208]: https://github.com/harttle/liquidjs/issues/208 diff --git a/docs/source/zh-cn/tutorials/differences.md b/docs/source/zh-cn/tutorials/differences.md index 296b9c109..22a7d133b 100644 --- a/docs/source/zh-cn/tutorials/differences.md +++ b/docs/source/zh-cn/tutorials/differences.md @@ -11,7 +11,11 @@ title: 和 Shopify/liquid 的区别 * 对象的迭代顺序。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]。 +* LiquidJS 有额外的标签：[layout][layout] 和相应的 `block`。 +* LiquidJS 有额外的过滤器：[json][json]。 +[layout]: https://liquidjs.com/tags/layout.html +[json]: https://liquidjs.com/filters/json.html [#26]: https://github.com/harttle/liquidjs/pull/26 [#59]: https://github.com/harttle/liquidjs/issues/59 [#208]: https://github.com/harttle/liquidjs/issues/208