chore(release): 9.28.0 [skip ci]

# [9.28.0](https://github.com/harttle/liquidjs/compare/v9.27.1...v9.28.0) (2021-10-06) ### Bug Fixes * skip root check for renderFile() ([822ba0b](https://github.com/harttle/liquidjs/commit/822ba0be0f1cfbedd50376aff8ac49eee71bd48c)) * support timezoneOffset for date from scope, [#401](https://github.com/harttle/liquidjs/issues/401) ([fd5ef47](https://github.com/harttle/liquidjs/commit/fd5ef474c36212e6a2446012dcd26bca93f84c7b)) ### Features * `relativeReference` for render/include/layout, [#395](https://github.com/harttle/liquidjs/issues/395) ([a3455eb](https://github.com/harttle/liquidjs/commit/a3455ebd0b207141c34630c0af44d917db2ca1dd)) * implement `forloop.name` as found in ruby shopify/liquid ([6dc7fad](https://github.com/harttle/liquidjs/commit/6dc7fada72467418806c1ee4bd7eaf3003690fe6))
fix: skip root check for renderFile()
2026-09-15 04:10:40 -07:00 · 2021-10-06 10:45:13 +00:00 · 2021-10-06 18:38:58 +08:00 · 2021-10-06 17:36:37 +08:00 · 2021-10-06 16:10:09 +08:00 · 2021-10-06 15:45:41 +08:00
348 changed files with 43457 additions and 9083 deletions
@@ -7,8 +7,8 @@
    "README.md"
  ],
  "imageSize": 100,
-  "commit": true,
-  "commitConvention": "eslint",
+  "commit": false,
+  "commitConvention": "angular",
  "contributors": [
    {
      "login": "harttle",
@@ -269,6 +269,160 @@
      "contributions": [
        "doc"
      ]
+    },
+    {
+      "login": "stedman",
+      "name": "Steve Stedman",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/183122?v=4",
+      "profile": "https://stedman.dev",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "aciccarello",
+      "name": "Anthony Ciccarello",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/11273838?v=4",
+      "profile": "https://ciccarello.me",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "TrySound",
+      "name": "Bogdan Chadkin",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5635476?v=4",
+      "profile": "https://twitter.com/IAmTrySound",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "tejasmanohar",
+      "name": "Tejas Manohar",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5959235?v=4",
+      "profile": "https://hightouch.io",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "pdehaan",
+      "name": "Peter deHaan",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/557895?v=4",
+      "profile": "http://about.me/peterdehaan",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "amit777",
+      "name": "amit777",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2703309?v=4",
+      "profile": "https://github.com/amit777",
+      "contributions": [
+        "code",
+        "financial"
+      ]
+    },
+    {
+      "login": "sschuldenzucker",
+      "name": "Steffen Schuldenzucker",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1100776?v=4",
+      "profile": "http://www.ifi.uzh.ch/en/ce/people/schuldenzucker.html",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "Pixcell",
+      "name": "Pixcell",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/4005291?v=4",
+      "profile": "https://github.com/Pixcell",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "JasonEtco",
+      "name": "Jason Etcovitch",
+      "avatar_url": "https://avatars.githubusercontent.com/u/10660468?v=4",
+      "profile": "https://jasonet.co",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "kayuapi",
+      "name": "ZC",
+      "avatar_url": "https://avatars.githubusercontent.com/u/10304328?v=4",
+      "profile": "https://github.com/kayuapi",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "mems",
+      "name": "Memmie Lenglet",
+      "avatar_url": "https://avatars.githubusercontent.com/u/729275?v=4",
+      "profile": "https://memmie.lenglet.name",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "ilhamdev0",
+      "name": "ilhamdev0",
+      "avatar_url": "https://avatars.githubusercontent.com/u/57636145?v=4",
+      "profile": "https://github.com/ilhamdev0",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "c412216887",
+      "name": "一饮一啄皆是人生",
+      "avatar_url": "https://avatars.githubusercontent.com/u/29691650?v=4",
+      "profile": "https://github.com/c412216887",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "labnol",
+      "name": "Amit Agarwal",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1344071?v=4",
+      "profile": "https://digitalinspiration.com/",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "n1ru4l",
+      "name": "Laurin Quast",
+      "avatar_url": "https://avatars.githubusercontent.com/u/14338007?v=4",
+      "profile": "https://n1ru4l.cloud/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "mattvague",
+      "name": "Matt Vague",
+      "avatar_url": "https://avatars.githubusercontent.com/u/64985?v=4",
+      "profile": "https://github.com/mattvague",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "bglw",
+      "name": "Liam Bigelow",
+      "avatar_url": "https://avatars.githubusercontent.com/u/40188355?v=4",
+      "profile": "https://github.com/bglw",
+      "contributions": [
+        "code"
+      ]
    }
  ],
  "contributorsPerLine": 7,
@@ -0,0 +1,30 @@
+name: Check
+on: [push, pull_request]
+jobs:
+  release:
+    name: Check
+    runs-on: ubuntu-18.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v1
+        with:
+          node-version: 10
+      - name: Build
+        run: |
+          npm ci
+          npm run build
+      - name: Test
+        run: |
+          npm run lint
+          npm run test
+      - name: Coverage
+        uses: coverallsapp/[email protected]
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Performance
+        run: |
+          npm run perf:diff
@@ -0,0 +1,37 @@
+name: Release
+on: workflow_dispatch
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-18.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v1
+        with:
+          node-version: 12
+      - name: Build
+        run: |
+          npm ci
+          npm run build
+      - name: Test
+        run: |
+          npm run lint
+          npm run test
+      - name: Coverage
+        uses: coverallsapp/[email protected]
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release
+      - name: Publish Docs
+        uses: JamesIves/[email protected]
+        with: 
+          branch: gh-pages
+          folder: docs/public
@@ -0,0 +1,4 @@
+module.exports = {
+  require: "ts-node/register/transpile-only",
+  reporter: "spec"
+}
@@ -0,0 +1,4 @@
+{
+  "exclude": ["dist", "test"],
+  "reporter": ["html", "lcov"]
+}
@@ -1,29 +0,0 @@
-language: node_js
-node_js:
-    - "10"
-    - "8"
-jobs:
-  include:
-    - stage: test
-      name: 'Linting'
-      script:
-        - npm run lint
-        - commitlint-travis
-    - name: 'Coverage'
-      script: npm run coverage-coveralls
-    - stage: release
-      name: 'Publish'
-      if: branch = master
-      script: npm run build
-      deploy:
-        provider: script
-        skip_cleanup: true
-        script: npx semantic-release
-    - name: 'Document'
-      if: branch = master
-      script: npm run build-docs
-      deploy:
-        skip_cleanup: true
-        provider: pages
-        github_token: $GH_TOKEN
-        local_dir: docs/public
@@ -1,3 +1,294 @@
+# [9.28.0](https://github.com/harttle/liquidjs/compare/v9.27.1...v9.28.0) (2021-10-06)
+
+
+### Bug Fixes
+
+* skip root check for renderFile() ([822ba0b](https://github.com/harttle/liquidjs/commit/822ba0be0f1cfbedd50376aff8ac49eee71bd48c))
+* support timezoneOffset for date from scope, [#401](https://github.com/harttle/liquidjs/issues/401) ([fd5ef47](https://github.com/harttle/liquidjs/commit/fd5ef474c36212e6a2446012dcd26bca93f84c7b))
+
+
+### Features
+
+* `relativeReference` for render/include/layout, [#395](https://github.com/harttle/liquidjs/issues/395) ([a3455eb](https://github.com/harttle/liquidjs/commit/a3455ebd0b207141c34630c0af44d917db2ca1dd))
+* implement `forloop.name` as found in ruby shopify/liquid ([6dc7fad](https://github.com/harttle/liquidjs/commit/6dc7fada72467418806c1ee4bd7eaf3003690fe6))
+
+## [9.27.1](https://github.com/harttle/liquidjs/compare/v9.27.0...v9.27.1) (2021-10-04)
+
+
+### Bug Fixes
+
+* directory info in lookupError message, [#395](https://github.com/harttle/liquidjs/issues/395) ([92bfc65](https://github.com/harttle/liquidjs/commit/92bfc65e0b1d937c00a8368b272223c702132d23))
+
+# [9.27.0](https://github.com/harttle/liquidjs/compare/v9.26.0...v9.27.0) (2021-10-03)
+
+
+### Bug Fixes
+
+* remove "stream" dependency in browser bundles, [#396](https://github.com/harttle/liquidjs/issues/396) ([3b5eb66](https://github.com/harttle/liquidjs/commit/3b5eb6664f673c29d74cb7645e01dcbdf43c8343))
+* renderToNodeStream() now emit 'error' event instead of throw ([afeef1d](https://github.com/harttle/liquidjs/commit/afeef1d7450b2799b3441b0241d2466b892a27ff))
+
+
+### Features
+
+* add `layouts`, `partials` apart from `root`, [#395](https://github.com/harttle/liquidjs/issues/395) ([b9ae479](https://github.com/harttle/liquidjs/commit/b9ae479b653a34fadb98c324c4683dd1fdd31af1))
+* renderFileToNodeStream(filepath, scope) ([68c4cfc](https://github.com/harttle/liquidjs/commit/68c4cfcfb647c22225dd6edede53ad7a5d7c4485))
+
+
+### Performance Improvements
+
+* make the most of streamed rendering ([aea3441](https://github.com/harttle/liquidjs/commit/aea34418de24cb85ea1acddf68c3683ce7fc9fa8))
+
+# [9.26.0](https://github.com/harttle/liquidjs/compare/v9.25.1...v9.26.0) (2021-09-30)
+
+
+### Features
+
+* orderedFilterParameters, closes [#312](https://github.com/harttle/liquidjs/issues/312) ([10e8c8f](https://github.com/harttle/liquidjs/commit/10e8c8ff7e1cca6df43087953cd8daf4bd618563))
+* stream rendering, closed [#361](https://github.com/harttle/liquidjs/issues/361) fixes [#360](https://github.com/harttle/liquidjs/issues/360) ([9012133](https://github.com/harttle/liquidjs/commit/9012133e0717b1813c6a74a6a282f43ba14d0ada))
+* timezoneOffset option to specify output timezone, see [#375](https://github.com/harttle/liquidjs/issues/375) ([6b9f872](https://github.com/harttle/liquidjs/commit/6b9f872bccb4b0c636dc7be2088cafa9bc6c900a))
+
+
+### Performance Improvements
+
+* improve performance by 4x by simplified parseFile ([24f5346](https://github.com/harttle/liquidjs/commit/24f534608489fccc155f30bbaf37397c46278da6))
+* parse filenames in parse() insteadof render() ([8273c17](https://github.com/harttle/liquidjs/commit/8273c17dab3dc09858330ce45e3617a650e7fcaa))
+
+## [9.25.1](https://github.com/harttle/liquidjs/compare/v9.25.0...v9.25.1) (2021-06-20)
+
+
+### Performance Improvements
+
+* add cross-engines benchmark ([cdceb25](https://github.com/harttle/liquidjs/commit/cdceb25d007b3d30a85e51ac538e12297c73bfcf))
+
+# [9.25.0](https://github.com/harttle/liquidjs/compare/v9.24.2...v9.25.0) (2021-05-07)
+
+
+### Features
+
+* when tag with multiple values ([8f9639f](https://github.com/harttle/liquidjs/commit/8f9639f))
+
+## [9.24.2](https://github.com/harttle/liquidjs/compare/v9.24.1...v9.24.2) (2021-05-04)
+
+
+### Bug Fixes
+
+* operator boundary not correctly recognized, fixes [#342](https://github.com/harttle/liquidjs/issues/342) ([3e3d84a](https://github.com/harttle/liquidjs/commit/3e3d84a))
+
+## [9.24.1](https://github.com/harttle/liquidjs/compare/v9.24.0...v9.24.1) (2021-05-01)
+
+
+### Bug Fixes
+
+* make LiquidError context property public ([1fd76ac](https://github.com/harttle/liquidjs/commit/1fd76ac))
+
+# [9.24.0](https://github.com/harttle/liquidjs/compare/v9.23.4...v9.24.0) (2021-05-01)
+
+
+### Features
+
+* add context as a property on the LiquidError error ([9c7cb57](https://github.com/harttle/liquidjs/commit/9c7cb57))
+* export errors for better error handling in user-land ([4e394b9](https://github.com/harttle/liquidjs/commit/4e394b9))
+
+## [9.23.4](https://github.com/harttle/liquidjs/compare/v9.23.3...v9.23.4) (2021-04-17)
+
+
+### Bug Fixes
+
+* capitalize filter not lower case trailing string, fixes [#326](https://github.com/harttle/liquidjs/issues/326) ([6548765](https://github.com/harttle/liquidjs/commit/6548765))
+
+## [9.23.3](https://github.com/harttle/liquidjs/compare/v9.23.2...v9.23.3) (2021-03-21)
+
+
+### Bug Fixes
+
+* expose TokenKind ([dbc23e8](https://github.com/harttle/liquidjs/commit/dbc23e8))
+
+## [9.23.2](https://github.com/harttle/liquidjs/compare/v9.23.1...v9.23.2) (2021-03-13)
+
+
+### Bug Fixes
+
+* comparison for empty/nil, fixes [#321](https://github.com/harttle/liquidjs/issues/321) ([99d14e7](https://github.com/harttle/liquidjs/commit/99d14e7))
+* newline_to_br filter should output <br /> instead of <br/>, fixes [#320](https://github.com/harttle/liquidjs/issues/320) ([9a9b792](https://github.com/harttle/liquidjs/commit/9a9b792))
+
+## [9.23.1](https://github.com/harttle/liquidjs/compare/v9.23.0...v9.23.1) (2021-02-19)
+
+
+### Bug Fixes
+
+* lenientIf not working for the umd bundle, closes [#313](https://github.com/harttle/liquidjs/issues/313) ([2e66e8b](https://github.com/harttle/liquidjs/commit/2e66e8b))
+
+# [9.23.0](https://github.com/harttle/liquidjs/compare/v9.22.1...v9.23.0) (2021-02-12)
+
+
+### Bug Fixes
+
+* respect `fs` in parser options, for [#233](https://github.com/harttle/liquidjs/issues/233) ([4e82da6](https://github.com/harttle/liquidjs/commit/4e82da6))
+
+
+### Features
+
+* support filters in if/unless/case, see [#287](https://github.com/harttle/liquidjs/issues/287) ([2f059f6](https://github.com/harttle/liquidjs/commit/2f059f6))
+* support function calls, closes [#222](https://github.com/harttle/liquidjs/issues/222) ([e37824f](https://github.com/harttle/liquidjs/commit/e37824f))
+* support layout none, closes [#299](https://github.com/harttle/liquidjs/issues/299) ([81e11bb](https://github.com/harttle/liquidjs/commit/81e11bb))
+
+## [9.22.1](https://github.com/harttle/liquidjs/compare/v9.22.0...v9.22.1) (2021-02-05)
+
+
+### Bug Fixes
+
+* default to precedence 1 for custom operators ([20f559e](https://github.com/harttle/liquidjs/commit/20f559e))
+
+# [9.22.0](https://github.com/harttle/liquidjs/compare/v9.21.0...v9.22.0) (2021-02-04)
+
+
+### Features
+
+* compact filter ([f42c217](https://github.com/harttle/liquidjs/commit/f42c217))
+
+# [9.21.0](https://github.com/harttle/liquidjs/compare/v9.20.1...v9.21.0) (2021-02-04)
+
+
+### Features
+
+* add `operators` option for custom operators ([75591cd](https://github.com/harttle/liquidjs/commit/75591cd))
+* create trie programmatically in options ([befc33c](https://github.com/harttle/liquidjs/commit/befc33c))
+* export OperatorMap type ([bc87e19](https://github.com/harttle/liquidjs/commit/bc87e19))
+* export Operators from operator.ts ([6a7c280](https://github.com/harttle/liquidjs/commit/6a7c280))
+* rename to defaultOperators and Operators ([8734e2e](https://github.com/harttle/liquidjs/commit/8734e2e))
+
+## [9.20.1](https://github.com/harttle/liquidjs/compare/v9.20.0...v9.20.1) (2021-01-24)
+
+
+### Bug Fixes
+
+* allow string literals contain delimiters, fixes [#288](https://github.com/harttle/liquidjs/issues/288) ([9c40da7](https://github.com/harttle/liquidjs/commit/9c40da7))
+
+# [9.20.0](https://github.com/harttle/liquidjs/compare/v9.19.0...v9.20.0) (2021-01-23)
+
+
+### Features
+
+* support `{{block.super}}`, see [#38](https://github.com/harttle/liquidjs/issues/38) ([a3af44d](https://github.com/harttle/liquidjs/commit/a3af44d))
+
+# [9.19.0](https://github.com/harttle/liquidjs/compare/v9.18.0...v9.19.0) (2020-12-18)
+
+
+### Bug Fixes
+
+* lint ([de32259](https://github.com/harttle/liquidjs/commit/de32259))
+* move offset adding complexity inside TimezoneDate ([26b2175](https://github.com/harttle/liquidjs/commit/26b2175))
+* simpler timezone regex and non-null offset ([e3ecfe3](https://github.com/harttle/liquidjs/commit/e3ecfe3))
+
+
+### Features
+
+* add preserveTimezones option ([d70cd2a](https://github.com/harttle/liquidjs/commit/d70cd2a))
+* parse and handle date timezone offsets ([c16c787](https://github.com/harttle/liquidjs/commit/c16c787))
+
+# [9.18.0](https://github.com/harttle/liquidjs/compare/v9.17.0...v9.18.0) (2020-12-17)
+
+
+### Bug Fixes
+
+* address refactor comments ([6a0ad10](https://github.com/harttle/liquidjs/commit/6a0ad10))
+
+
+### Features
+
+* add option for keeping variable type in output ([cd92e77](https://github.com/harttle/liquidjs/commit/cd92e77))
+
+# [9.17.0](https://github.com/harttle/liquidjs/compare/v9.16.1...v9.17.0) (2020-12-07)
+
+
+### Bug Fixes
+
+* elsif is not supported for unless, fixes [#268](https://github.com/harttle/liquidjs/issues/268) ([2bbf501](https://github.com/harttle/liquidjs/commit/2bbf501))
+* enforce string-type pattern in `replace`, fixes [#243](https://github.com/harttle/liquidjs/issues/243) ([c8afa39](https://github.com/harttle/liquidjs/commit/c8afa39))
+* raw block not ignoring {% characters, fixes [#263](https://github.com/harttle/liquidjs/issues/263) ([a492d8e](https://github.com/harttle/liquidjs/commit/a492d8e))
+
+
+### Features
+
+* passing liquid to FilterImpl, closes [#277](https://github.com/harttle/liquidjs/issues/277) ([f9f595f](https://github.com/harttle/liquidjs/commit/f9f595f))
+
+## [9.16.1](https://github.com/harttle/liquidjs/compare/v9.16.0...v9.16.1) (2020-10-09)
+
+
+### Bug Fixes
+
+* braced property access ([18a807e](https://github.com/harttle/liquidjs/commit/18a807e))
+
+# [9.16.0](https://github.com/harttle/liquidjs/compare/v9.15.1...v9.16.0) (2020-10-08)
+
+
+### Features
+
+* support jsTruthy, [#255](https://github.com/harttle/liquidjs/issues/255) [#257](https://github.com/harttle/liquidjs/issues/257) ([72ee7b4](https://github.com/harttle/liquidjs/commit/72ee7b4))
+
+## [9.15.1](https://github.com/harttle/liquidjs/compare/v9.15.0...v9.15.1) (2020-10-03)
+
+
+### Bug Fixes
+
+* allow quoted variable name in capture, fixes [#252](https://github.com/harttle/liquidjs/issues/252) ([5b3f419](https://github.com/harttle/liquidjs/commit/5b3f419))
+
+# [9.15.0](https://github.com/harttle/liquidjs/compare/v9.14.1...v9.15.0) (2020-08-04)
+
+
+### Features
+
+* export toPromise and toValue, see [#158](https://github.com/harttle/liquidjs/issues/158) ([2e5ab98](https://github.com/harttle/liquidjs/commit/2e5ab98))
+
+## [9.14.1](https://github.com/harttle/liquidjs/compare/v9.14.0...v9.14.1) (2020-07-08)
+
+
+### Bug Fixes
+
+* enumerate Promises (e.g. in for & tablerow) ([#237](https://github.com/harttle/liquidjs/issues/237)) ([941dd66](https://github.com/harttle/liquidjs/commit/941dd66))
+
+# [9.14.0](https://github.com/harttle/liquidjs/compare/v9.13.0...v9.14.0) (2020-06-25)
+
+
+### Features
+
+* setup universal browser and node builds ([6cf6ffa](https://github.com/harttle/liquidjs/commit/6cf6ffa))
+
+# [9.13.0](https://github.com/harttle/liquidjs/compare/v9.12.0...v9.13.0) (2020-06-25)
+
+
+### Features
+
+* async filters, closes [#232](https://github.com/harttle/liquidjs/issues/232) ([e36f3ff](https://github.com/harttle/liquidjs/commit/e36f3ff))
+
+# [9.12.0](https://github.com/harttle/liquidjs/compare/v9.11.11...v9.12.0) (2020-05-15)
+
+
+### Features
+
+* sort by key, see [#227](https://github.com/harttle/liquidjs/issues/227) ([4f17c94](https://github.com/harttle/liquidjs/commit/4f17c94))
+
+## [9.11.11](https://github.com/harttle/liquidjs/compare/v9.11.10...v9.11.11) (2020-05-01)
+
+
+### Bug Fixes
+
+* properly treat unicode blanks, fixes [#221](https://github.com/harttle/liquidjs/issues/221) ([673b015](https://github.com/harttle/liquidjs/commit/673b015))
+
+## [9.11.10](https://github.com/harttle/liquidjs/compare/v9.11.9...v9.11.10) (2020-04-03)
+
+
+### Bug Fixes
+
+* respect cache render options ([a93f11d](https://github.com/harttle/liquidjs/commit/a93f11d))
+
+## [9.11.9](https://github.com/harttle/liquidjs/compare/v9.11.8...v9.11.9) (2020-03-31)
+
+
+### Bug Fixes
+
+* coerce to Array in `map` and `where` filter ([c923598](https://github.com/harttle/liquidjs/commit/c923598))
+
 ## [9.11.8](https://github.com/harttle/liquidjs/compare/v9.11.7...v9.11.8) (2020-03-31)


@@ -1,18 +1,13 @@
 # liquidjs
-[![npm version](https://img.shields.io/npm/v/liquidjs.svg)](https://www.npmjs.org/package/liquidjs)
-[![npm downloads](https://img.shields.io/npm/dm/liquidjs.svg)](https://www.npmjs.org/package/liquidjs)
-[![coveralls coverage](https://img.shields.io/coveralls/harttle/liquidjs.svg)](https://coveralls.io/github/harttle/liquidjs?branch=master)
-[![travis Build Status](https://travis-ci.org/harttle/liquidjs.svg?branch=master)](https://travis-ci.org/harttle/liquidjs)
-[![GitHub issues](https://img.shields.io/github/issues-closed/harttle/liquidjs.svg)](https://github.com/harttle/liquidjs/issues)
-[![GitHub contributors](https://img.shields.io/github/contributors/harttle/liquidjs.svg)](https://github.com/harttle/liquidjs/graphs/contributors)
-[![Open Collective contributors](https://img.shields.io/opencollective/all/liquidjs)](https://opencollective.com/liquidjs)
-[![David dependencies](https://img.shields.io/david/harttle/liquidjs.svg)](https://david-dm.org/harttle/liquidjs)
-[![David devDependencies](https://img.shields.io/david/dev/harttle/liquidjs.svg)](https://david-dm.org/harttle/liquidjs?type=dev)
-[![DUB license](https://img.shields.io/dub/l/vibe-d.svg)](https://github.com/harttle/liquidjs/blob/master/LICENSE)
-[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits)
-[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/harttle/liquidjs)
+[![npm version](https://img.shields.io/npm/v/liquidjs.svg?logo=npm&style=flat-square)](https://www.npmjs.org/package/liquidjs)
+[![npm downloads](https://img.shields.io/npm/dm/liquidjs.svg?style=flat-square)](https://www.npmjs.org/package/liquidjs)
+[![Coverage](https://img.shields.io/coveralls/harttle/liquidjs.svg?style=flat-square)](https://coveralls.io/github/harttle/liquidjs?branch=master)
+[![Build Status](https://img.shields.io/github/workflow/status/harttle/liquidjs/Check/master.svg?style=flat-square)](https://github.com/harttle/liquidjs/actions/workflows/check.yml?query=branch%3Amaster)
+[![David dependencies](https://img.shields.io/david/harttle/liquidjs.svg?style=flat-square)](https://david-dm.org/harttle/liquidjs)
+[![DUB license](https://img.shields.io/dub/l/vibe-d.svg?style=flat-square)](https://github.com/harttle/liquidjs/blob/master/LICENSE)
+[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square)](https://github.com/harttle/liquidjs)

-A simple, expressive, safe and [Shopify][shopify/liquid] compatible template engine in pure JavaScript.
+A simple, expressive and safe [Shopify][shopify/liquid] / Github Pages compatible template engine in pure JavaScript.
 **The purpose of this repo** is to provide a standard Liquid implementation for the JavaScript community so that [Jekyll sites](https://jekyllrb.com), [Github Pages](https://pages.github.com/) and [Shopify templates](https://themes.shopify.com/) can be ported to Node.js without pain.

 * [Documentation][doc]
@@ -32,7 +27,7 @@ npm install --save liquidjs
 Or use the UMD bundle from jsDelivr:

 ```html
-<script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.browser.min.js"></script>
 ```

 More details, refer to [The Setup Guide][setup].
@@ -59,45 +54,69 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
 <!-- markdownlint-disable -->
 <table>
  <tr>
-    <td align="center"><a href="https://harttle.land"><img src="https://avatars3.githubusercontent.com/u/4427974?v=4" width="100px;" alt="Jun Yang"/><br /><sub><b>Jun Yang</b></sub></a><br /><a href="#maintenance-harttle" title="Maintenance">🚧</a> <a href="https://github.com/harttle/liquidjs/commits?author=harttle" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/chenos"><img src="https://avatars0.githubusercontent.com/u/2993310?v=4" width="100px;" alt="chenos"/><br /><sub><b>chenos</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=chenos" title="Code">💻</a></td>
-    <td align="center"><a href="https://zachleat.com/"><img src="https://avatars2.githubusercontent.com/u/39355?v=4" width="100px;" alt="Zach Leatherman"/><br /><sub><b>Zach Leatherman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/issues?q=author%3Azachleat" title="Bug reports">🐛</a></td>
-    <td align="center"><a href="https://github.com/thardy"><img src="https://avatars3.githubusercontent.com/u/120636?v=4" width="100px;" alt="Tim Hardy"/><br /><sub><b>Tim Hardy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thardy" title="Code">💻</a></td>
-    <td align="center"><a href="https://paulrobertlloyd.com/"><img src="https://avatars3.githubusercontent.com/u/813383?v=4" width="100px;" alt="Paul Robert Lloyd"/><br /><sub><b>Paul Robert Lloyd</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=paulrobertlloyd" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/issues?q=author%3Apaulrobertlloyd" title="Bug reports">🐛</a></td>
-    <td align="center"><a href="https://twitter.com/alecdotbiz"><img src="https://avatars2.githubusercontent.com/u/1925840?v=4" width="100px;" alt="Alec Larson"/><br /><sub><b>Alec Larson</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=aleclarson" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/pmalouin"><img src="https://avatars1.githubusercontent.com/u/1411117?v=4" width="100px;" alt="Patrick Malouin"/><br /><sub><b>Patrick Malouin</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=pmalouin" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/commits?author=pmalouin" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://harttle.land"><img src="https://avatars3.githubusercontent.com/u/4427974?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jun Yang</b></sub></a><br /><a href="#maintenance-harttle" title="Maintenance">🚧</a> <a href="https://github.com/harttle/liquidjs/commits?author=harttle" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/chenos"><img src="https://avatars0.githubusercontent.com/u/2993310?v=4?s=100" width="100px;" alt=""/><br /><sub><b>chenos</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=chenos" title="Code">💻</a></td>
+    <td align="center"><a href="https://zachleat.com/"><img src="https://avatars2.githubusercontent.com/u/39355?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Zach Leatherman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/issues?q=author%3Azachleat" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="https://github.com/thardy"><img src="https://avatars3.githubusercontent.com/u/120636?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tim Hardy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thardy" title="Code">💻</a></td>
+    <td align="center"><a href="https://paulrobertlloyd.com/"><img src="https://avatars3.githubusercontent.com/u/813383?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Paul Robert Lloyd</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=paulrobertlloyd" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/issues?q=author%3Apaulrobertlloyd" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="https://twitter.com/alecdotbiz"><img src="https://avatars2.githubusercontent.com/u/1925840?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Alec Larson</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=aleclarson" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/pmalouin"><img src="https://avatars1.githubusercontent.com/u/1411117?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Patrick Malouin</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=pmalouin" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/commits?author=pmalouin" title="Documentation">📖</a></td>
  </tr>
  <tr>
-    <td align="center"><a href="https://jaswrks.com"><img src="https://avatars3.githubusercontent.com/u/1563559?v=4" width="100px;" alt="jaswrks"/><br /><sub><b>jaswrks</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=jaswrks" title="Code">💻</a></td>
-    <td align="center"><a href="https://oott123.com"><img src="https://avatars2.githubusercontent.com/u/905663?v=4" width="100px;" alt="三三"/><br /><sub><b>三三</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=oott123" title="Code">💻</a> <a href="#ideas-oott123" title="Ideas, Planning, & Feedback">🤔</a></td>
-    <td align="center"><a href="https://github.com/ssendev"><img src="https://avatars0.githubusercontent.com/u/450793?v=4" width="100px;" alt="ssendev"/><br /><sub><b>ssendev</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ssendev" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/commits?author=ssendev" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/wojtask9"><img src="https://avatars3.githubusercontent.com/u/6099236?v=4" width="100px;" alt="wojtask9"/><br /><sub><b>wojtask9</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=wojtask9" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/thelornenelson"><img src="https://avatars3.githubusercontent.com/u/24596583?v=4" width="100px;" alt="Andrew Barclay"/><br /><sub><b>Andrew Barclay</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thelornenelson" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.stam.pr/"><img src="https://avatars2.githubusercontent.com/u/142338?v=4" width="100px;" alt="Cory Mawhorter"/><br /><sub><b>Cory Mawhorter</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=cmawhorter" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/thehappybug"><img src="https://avatars0.githubusercontent.com/u/3393530?v=4" width="100px;" alt="Mehdi Jaffery"/><br /><sub><b>Mehdi Jaffery</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thehappybug" title="Code">💻</a></td>
+    <td align="center"><a href="https://jaswrks.com"><img src="https://avatars3.githubusercontent.com/u/1563559?v=4?s=100" width="100px;" alt=""/><br /><sub><b>jaswrks</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=jaswrks" title="Code">💻</a></td>
+    <td align="center"><a href="https://oott123.com"><img src="https://avatars2.githubusercontent.com/u/905663?v=4?s=100" width="100px;" alt=""/><br /><sub><b>三三</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=oott123" title="Code">💻</a> <a href="#ideas-oott123" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="https://github.com/ssendev"><img src="https://avatars0.githubusercontent.com/u/450793?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ssendev</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ssendev" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/commits?author=ssendev" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/wojtask9"><img src="https://avatars3.githubusercontent.com/u/6099236?v=4?s=100" width="100px;" alt=""/><br /><sub><b>wojtask9</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=wojtask9" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/thelornenelson"><img src="https://avatars3.githubusercontent.com/u/24596583?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Andrew Barclay</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thelornenelson" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.stam.pr/"><img src="https://avatars2.githubusercontent.com/u/142338?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Cory Mawhorter</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=cmawhorter" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/thehappybug"><img src="https://avatars0.githubusercontent.com/u/3393530?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mehdi Jaffery</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thehappybug" title="Code">💻</a></td>
  </tr>
  <tr>
-    <td align="center"><a href="https://github.com/robinbijlani"><img src="https://avatars0.githubusercontent.com/u/2503108?v=4" width="100px;" alt="Robin Bijlani"/><br /><sub><b>Robin Bijlani</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=robinbijlani" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/issues?q=author%3Arobinbijlani" title="Bug reports">🐛</a></td>
-    <td align="center"><a href="https://www.rmkennedy.com"><img src="https://avatars3.githubusercontent.com/u/8356669?v=4" width="100px;" alt="Ryan Kennedy"/><br /><sub><b>Ryan Kennedy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ryaninvents" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/strax"><img src="https://avatars2.githubusercontent.com/u/587213?v=4" width="100px;" alt="Sami Kukkonen"/><br /><sub><b>Sami Kukkonen</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=strax" title="Code">💻</a></td>
-    <td align="center"><a href="https://ScottFreeCode.github.io/"><img src="https://avatars3.githubusercontent.com/u/16506071?v=4" width="100px;" alt="Scott Santucci"/><br /><sub><b>Scott Santucci</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ScottFreeCode" title="Code">💻</a></td>
-    <td align="center"><a href="http://stevenrescigno.com"><img src="https://avatars3.githubusercontent.com/u/8505293?v=4" width="100px;" alt="Steven "/><br /><sub><b>Steven </b></sub></a><br /><a href="#example-stevenanthonyrevo" title="Examples">💡</a> <a href="https://github.com/harttle/liquidjs/commits?author=stevenanthonyrevo" title="Code">💻</a></td>
-    <td align="center"><a href="https://efcl.info/"><img src="https://avatars1.githubusercontent.com/u/19714?v=4" width="100px;" alt="azu"/><br /><sub><b>azu</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=azu" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/wyozi"><img src="https://avatars3.githubusercontent.com/u/4894573?v=4" width="100px;" alt="Joonas"/><br /><sub><b>Joonas</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=wyozi" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/robinbijlani"><img src="https://avatars0.githubusercontent.com/u/2503108?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Robin Bijlani</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=robinbijlani" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/issues?q=author%3Arobinbijlani" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="https://www.rmkennedy.com"><img src="https://avatars3.githubusercontent.com/u/8356669?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ryan Kennedy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ryaninvents" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/strax"><img src="https://avatars2.githubusercontent.com/u/587213?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sami Kukkonen</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=strax" title="Code">💻</a></td>
+    <td align="center"><a href="https://ScottFreeCode.github.io/"><img src="https://avatars3.githubusercontent.com/u/16506071?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Scott Santucci</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ScottFreeCode" title="Code">💻</a></td>
+    <td align="center"><a href="http://stevenrescigno.com"><img src="https://avatars3.githubusercontent.com/u/8505293?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Steven </b></sub></a><br /><a href="#example-stevenanthonyrevo" title="Examples">💡</a> <a href="https://github.com/harttle/liquidjs/commits?author=stevenanthonyrevo" title="Code">💻</a></td>
+    <td align="center"><a href="https://efcl.info/"><img src="https://avatars1.githubusercontent.com/u/19714?v=4?s=100" width="100px;" alt=""/><br /><sub><b>azu</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=azu" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/wyozi"><img src="https://avatars3.githubusercontent.com/u/4894573?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Joonas</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=wyozi" title="Code">💻</a></td>
  </tr>
  <tr>
-    <td align="center"><a href="https://github.com/jamelait"><img src="https://avatars1.githubusercontent.com/u/14369255?v=4" width="100px;" alt="Jamel A."/><br /><sub><b>Jamel A.</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=jamelait" title="Code">💻</a></td>
-    <td align="center"><a href="https://brandonpittman.net"><img src="https://avatars0.githubusercontent.com/u/967145?v=4" width="100px;" alt="Brandon Pittman"/><br /><sub><b>Brandon Pittman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=brandonpittman" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/tgrandgent"><img src="https://avatars3.githubusercontent.com/u/17069042?v=4" width="100px;" alt="tgrandgent"/><br /><sub><b>tgrandgent</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=tgrandgent" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/mastodon0"><img src="https://avatars1.githubusercontent.com/u/7924332?v=4" width="100px;" alt="Martin Schuster"/><br /><sub><b>Martin Schuster</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=mastodon0" title="Code">💻</a></td>
-    <td align="center"><a href="http://js.chenlei.me"><img src="https://avatars0.githubusercontent.com/u/6339390?v=4" width="100px;" alt="Ray"/><br /><sub><b>Ray</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=richardo2016" title="Tests">⚠️</a> <a href="https://github.com/harttle/liquidjs/commits?author=richardo2016" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/CriGoT"><img src="https://avatars0.githubusercontent.com/u/1936786?v=4" width="100px;" alt="Cristofer Gonzales"/><br /><sub><b>Cristofer Gonzales</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=CriGoT" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.raymondcamden.com"><img src="https://avatars3.githubusercontent.com/u/393660?v=4" width="100px;" alt="Raymond Camden"/><br /><sub><b>Raymond Camden</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=cfjedimaster" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/jamelait"><img src="https://avatars1.githubusercontent.com/u/14369255?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jamel A.</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=jamelait" title="Code">💻</a></td>
+    <td align="center"><a href="https://brandonpittman.net"><img src="https://avatars0.githubusercontent.com/u/967145?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Brandon Pittman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=brandonpittman" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/tgrandgent"><img src="https://avatars3.githubusercontent.com/u/17069042?v=4?s=100" width="100px;" alt=""/><br /><sub><b>tgrandgent</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=tgrandgent" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/mastodon0"><img src="https://avatars1.githubusercontent.com/u/7924332?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Martin Schuster</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=mastodon0" title="Code">💻</a></td>
+    <td align="center"><a href="http://js.chenlei.me"><img src="https://avatars0.githubusercontent.com/u/6339390?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ray</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=richardo2016" title="Tests">⚠️</a> <a href="https://github.com/harttle/liquidjs/commits?author=richardo2016" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/CriGoT"><img src="https://avatars0.githubusercontent.com/u/1936786?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Cristofer Gonzales</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=CriGoT" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.raymondcamden.com"><img src="https://avatars3.githubusercontent.com/u/393660?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Raymond Camden</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=cfjedimaster" title="Documentation">📖</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://stedman.dev"><img src="https://avatars1.githubusercontent.com/u/183122?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Steve Stedman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=stedman" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://ciccarello.me"><img src="https://avatars0.githubusercontent.com/u/11273838?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Anthony Ciccarello</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=aciccarello" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://twitter.com/IAmTrySound"><img src="https://avatars0.githubusercontent.com/u/5635476?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Bogdan Chadkin</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=TrySound" title="Code">💻</a></td>
+    <td align="center"><a href="https://hightouch.io"><img src="https://avatars0.githubusercontent.com/u/5959235?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tejas Manohar</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=tejasmanohar" title="Code">💻</a></td>
+    <td align="center"><a href="http://about.me/peterdehaan"><img src="https://avatars2.githubusercontent.com/u/557895?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Peter deHaan</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=pdehaan" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/amit777"><img src="https://avatars0.githubusercontent.com/u/2703309?v=4?s=100" width="100px;" alt=""/><br /><sub><b>amit777</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=amit777" title="Code">💻</a> <a href="#financial-amit777" title="Financial">💵</a></td>
+    <td align="center"><a href="http://www.ifi.uzh.ch/en/ce/people/schuldenzucker.html"><img src="https://avatars3.githubusercontent.com/u/1100776?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Steffen Schuldenzucker</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=sschuldenzucker" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/Pixcell"><img src="https://avatars0.githubusercontent.com/u/4005291?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Pixcell</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=Pixcell" title="Code">💻</a></td>
+    <td align="center"><a href="https://jasonet.co"><img src="https://avatars.githubusercontent.com/u/10660468?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jason Etcovitch</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=JasonEtco" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/kayuapi"><img src="https://avatars.githubusercontent.com/u/10304328?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ZC</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=kayuapi" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://memmie.lenglet.name"><img src="https://avatars.githubusercontent.com/u/729275?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Memmie Lenglet</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=mems" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ilhamdev0"><img src="https://avatars.githubusercontent.com/u/57636145?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ilhamdev0</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ilhamdev0" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/c412216887"><img src="https://avatars.githubusercontent.com/u/29691650?v=4?s=100" width="100px;" alt=""/><br /><sub><b>一饮一啄皆是人生</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=c412216887" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://digitalinspiration.com/"><img src="https://avatars.githubusercontent.com/u/1344071?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Amit Agarwal</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=labnol" title="Documentation">📖</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://n1ru4l.cloud/"><img src="https://avatars.githubusercontent.com/u/14338007?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Laurin Quast</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=n1ru4l" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/mattvague"><img src="https://avatars.githubusercontent.com/u/64985?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Matt Vague</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=mattvague" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/bglw"><img src="https://avatars.githubusercontent.com/u/40188355?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Liam Bigelow</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=bglw" title="Code">💻</a></td>
  </tr>
 </table>

-<!-- markdownlint-enable -->
+<!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
+
 <!-- ALL-CONTRIBUTORS-LIST:END -->

 [shopify/liquid]: https://shopify.github.io/liquid/
@@ -0,0 +1,13 @@
+# Security Policy
+
+## Supported Versions
+
+Only the latest major version is supported with security updates. It can be changed if many people are relying on a specific version for some reason. If this is the case, welcome to file an issue.
+
+## Reporting a Vulnerability
+
+Please contact yangjvn@126.com to report a vulnerability.
+
+- It will be fixed very soon (maybe within 1 week or couple of days) if that vulnerability obviously affects common use cases.
+- Otherwise, it'll be scheduled with a priority just like requested features (which is lower than bugs).
+- If it's declined, you'll receive an email (more oftenly there will be a discuss).
@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+const Benchmark = require('benchmark')
+const data = require('./data/todolist.json')
+const path = require('path')
+
+const engines = {
+  handlebars: require('./engines/handlebars'),
+  liquid: require('./engines/liquid'),
+  react: require('./engines/react'),
+  swig: require('./engines/swig')
+}
+
+function crossEngines () {
+  console.log('     cross engines')
+  console.log('------------------------')
+  return new Promise(resolve => {
+    const suit = new Benchmark.Suite('cross engines')
+
+    for (const [name, { load, render }] of Object.entries(engines)) {
+      const tpl = load(path.resolve(__dirname, `templates/todolist`))
+      suit.add(name, () => render(tpl, data))
+    }
+
+    suit.on('cycle', event => console.log(String(event.target)))
+    suit.on('complete', resolve)
+    suit.run({ async: true })
+  })
+}
+
+module.exports = { crossEngines }
@@ -0,0 +1,28 @@
+{
+  "categories": [{
+    "color": "red",
+    "id": "CAT1",
+    "title": "work"
+  }, {
+    "color": "red",
+    "id": "CAT2",
+    "title": "emergency"
+  }, {
+    "color": "green",
+    "id": "CAT3",
+    "title": "sport"
+  }],
+  "todos": [{
+    "title": "fork and clone",
+    "id": "TODO1",
+    "category": "work"
+  }, {
+    "title": "make it better",
+    "id": "TODO2",
+    "category": "sport"
+  }, {
+    "title": "make a pull request",
+    "id": "TODO3",
+    "category": "work"
+  }]
+}
@@ -1,8 +1,10 @@
 const Benchmark = require('benchmark')
 const { Liquid } = require('..')
+const ctx = require('./data/todolist.json')
+const { resolve } = require('path')

 const engine = new Liquid({
-  root: __dirname,
+  root: resolve(__dirname, 'templates'),
  extname: '.liquid'
 })

@@ -17,28 +19,14 @@ engine.registerTag('header', {
  }
 })

-const ctx = {
-  todos: ['fork and clone', 'make it better', 'make a pull request'],
-  title: 'Welcome to liquidjs!'
-}
-
-const template = `
-{%header content: "welcome to liquid" | capitalize%}
-
-<ul>
-  {% for todo in todos %}
-  <li>{{forloop.index}} - {{todo}}</li>
-  {% endfor %}
-</ul>
-`
-
 function demo () {
-  console.log('--- demo ---')
+  console.log('         demo')
+  console.log('------------------------')
  return new Promise(resolve => {
    new Benchmark.Suite('demo')
      .add('demo', {
        defer: true,
-        fn: d => engine.parseAndRender(template, ctx).then(x => d.resolve(x))
+        fn: d => engine.renderFile('todolist', ctx).then(x => d.resolve(x))
      })
      .on('cycle', event => console.log(String(event.target)))
      .on('complete', resolve)
@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+const { performance } = require('perf_hooks')
+const path = require('path')
+
+const FILE_LOCAL = process.argv[2]
+const FILE_LATEST = process.argv[3]
+console.log(`Local:  ${FILE_LOCAL}`)
+console.log(`Latest: ${FILE_LATEST}`)
+
+const { createEngine } = require('./engines/create-liquid')
+const local = createEngine(require(path.resolve(__dirname, '..', FILE_LOCAL)))
+const latest = createEngine(require(path.resolve(__dirname, '..', FILE_LOCAL)))
+const data = require('./data/todolist.json')
+const tpl = path.resolve(__dirname, `templates/todolist`)
+
+const begin = performance.now()
+const tplLocal = local.load(tpl)
+const tplLatest = latest.load(tpl)
+const tasks = [
+  {
+    cycles: 0,
+    time: 0,
+    fn: () => latest.render(tplLatest, data)
+  },
+  {
+    cycles: 0,
+    time: 0,
+    fn: () => local.render(tplLocal, data)
+  }
+]
+while (performance.now() - begin < 20e3) {
+  const task = tasks[Math.floor(Math.random() * 2)]
+  task.time -= performance.now()
+  task.fn()
+  task.time += performance.now()
+  task.cycles++
+}
+
+const [ latestResult, localResult ] = tasks.map(task => {
+  task.perf = task.cycles * 1000 / task.time
+  return task
+})
+const diff = (localResult.perf - latestResult.perf) / latestResult.perf
+
+console.log(`Local: ${localResult.perf.toFixed(3)} ops/s (${localResult.cycles} cycles)`)
+console.log(`Latest: ${latestResult.perf.toFixed(3)} ops/s (${latestResult.cycles} cycles)`)
+console.log(`Diff: ${(diff * 100).toFixed(3)}%`)
+
+const THRESHOLD_PERCENT = -3
+process.exit(diff * 100 < THRESHOLD_PERCENT ? 1 : 0)
@@ -0,0 +1,17 @@
+const { readFileSync } = require('fs')
+const { join } = require('path')
+
+function createEngine (pkg) {
+  const liquid = new pkg.Liquid({
+    root: join(__dirname, '../templates'),
+    cache: true,
+    extname: '.liquid'
+  })
+  liquid.registerFilter('url', path => `http://example.com${path}`)
+  return {
+    load: path => liquid.parse(readFileSync(path + '.liquid', 'utf8')),
+    render: (tpl, data) => liquid.renderSync(tpl, data)
+  }
+}
+
+module.exports = { createEngine }
@@ -0,0 +1,33 @@
+const handlebars = require('handlebars')
+const { readFileSync } = require('fs')
+const { join } = require('path')
+
+handlebars.registerPartial(
+  'todo-icon',
+  readFileSync(join(__dirname, '../templates/todo-icon.hbs'), 'utf8')
+)
+
+handlebars.registerHelper('concat', function (...args) {
+  return args.filter(x => typeof x === 'string').join('')
+})
+
+handlebars.registerHelper('url', function (path) {
+  return `http://example.com${path}`
+})
+
+handlebars.registerHelper('inc', function (num) {
+  return Number(num) + 1
+})
+
+handlebars.registerHelper('capitalize', function (str) {
+  return str[0].toUpperCase() + str.slice(1).toLowerCase()
+})
+
+handlebars.registerHelper('upcase', function (str) {
+  return str.toUpperCase()
+})
+
+module.exports = {
+  load: path => handlebars.compile(readFileSync(path + '.hbs', 'utf8')),
+  render: (tpl, data) => tpl(data)
+}
@@ -0,0 +1,3 @@
+const { createEngine } = require('./create-liquid')
+
+module.exports = createEngine(require('../../dist/liquid.node.cjs'))
@@ -0,0 +1,20 @@
+const { readFileSync } = require('fs')
+const React = require('react')
+const ReactDOMServer = require('react-dom/server')
+const babel = require('@babel/core')
+const requireFromString = require('require-from-string')
+
+const babelConfig = {
+  presets: ['@babel/preset-react', '@babel/preset-env']
+}
+
+module.exports = {
+  load: path => {
+    const src = readFileSync(path + '.jsx', 'utf8')
+    const transformed = babel.transform(src, babelConfig)
+    return requireFromString(transformed.code)
+  },
+  render: (Component, data) => {
+    return ReactDOMServer.renderToString(React.createElement(Component, data))
+  }
+}
@@ -0,0 +1,30 @@
+const swig = require('swig')
+
+swig.setFilter('url', function (path) {
+  return `http://example.com${path}`
+})
+
+swig.setFilter('prepend', function (input, arg) {
+  return arg + input
+})
+
+swig.setFilter('append', function (input, arg) {
+  return input + arg
+})
+
+swig.setFilter('inc', function (num) {
+  return Number(num) + 1
+})
+
+swig.setFilter('capitalize', function (str) {
+  return str[0].toUpperCase() + str.slice(1).toLowerCase()
+})
+
+swig.setFilter('upcase', function (str) {
+  return str.toUpperCase()
+})
+
+module.exports = {
+  load: path => swig.compileFile(path + '.swig'),
+  render: (tpl, data) => tpl(data)
+}
@@ -3,6 +3,7 @@ const { tag } = require('./tag')
 const { demo } = require('./demo')
 const { layout } = require('./layout')
 const { memory } = require('./memory')
+const { crossEngines } = require('./cross-engines')

 async function main () {
  await output()
@@ -10,6 +11,7 @@ async function main () {
  await demo()
  await layout()
  await memory()
+  await crossEngines()
 }

 main()
@@ -18,7 +18,8 @@ const template = `
 `

 function layout () {
-  console.log('--- layout ---')
+  console.log('         layout')
+  console.log('------------------------')
  return new Promise(resolve => {
    new Benchmark.Suite('layout')
      .add('cache=false', {
@@ -13,7 +13,8 @@ const engine = new Liquid(engineOptions)
 const SAMPLE_COUNT = 1024

 function memory () {
-  console.log('--- memory ---')
+  console.log('         memory')
+  console.log('------------------------')
  html()
  todolist()
 }
@@ -29,11 +30,11 @@ function html () {
    templates.push(engine.parse(str))
  }
  const diff1 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
-  console.log(`${h(str.length)} lorem-html before GC x ${h(diff1)}/tpl (${SAMPLE_COUNT} instances sampled)`)
+  console.log(`[lorem-html ${h(str.length)}][before GC] ${h(diff1)}/tpl (${SAMPLE_COUNT} runs sampled)`)

  global.gc()
  const diff2 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
-  console.log(`${h(str.length)} lorem-html after GC x ${h(diff2)}/tpl (${SAMPLE_COUNT} instances sampled)`)
+  console.log(`[lorem-html ${h(str.length)}][after GC] ${h(diff2)}/tpl (${SAMPLE_COUNT} runs sampled)`)
 }

 function todolist () {
@@ -47,15 +48,15 @@ function todolist () {
    templates.push(engine.parse(str))
  }
  const diff1 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
-  console.log(`${h(str.length)} todolist before GC x ${h(diff1)}/tpl (${SAMPLE_COUNT} instances sampled)`)
+  console.log(`[todolist ${h(str.length)}][before GC] ${h(diff1)}/tpl (${SAMPLE_COUNT} runs sampled)`)

  global.gc()
  const diff2 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
-  console.log(`${h(str.length)} todolist after GC x ${h(diff2)}/tpl (${SAMPLE_COUNT} instances sampled)`)
+  console.log(`[todolist ${h(str.length)}][after GC] ${h(diff2)}/tpl (${SAMPLE_COUNT} runs sampled)`)
 }

 function h (size) {
-  return (size / 1024).toFixed(3) + ' kB'
+  return (size / 1024).toFixed(3) + ' KB'
 }

 module.exports = { memory }
@@ -4,7 +4,8 @@ const { Liquid } = require('..')
 const liquid = new Liquid()

 function output () {
-  console.log('--- output ---')
+  console.log('         output')
+  console.log('------------------------')
  return new Promise(resolve => {
    new Benchmark.Suite('output')
      .add('literal', test('{{false}}{{"foo"}}{{32.322}}'))
@@ -0,0 +1,23 @@
+{
+  "name": "benchmark",
+  "private": true,
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "start": "node --expose-gc index",
+    "engines": "node -e 'require(\"./cross-engines\").crossEngines()'"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@babel/core": "^7.13.14",
+    "@babel/preset-env": "^7.13.12",
+    "@babel/preset-react": "^7.13.13",
+    "handlebars": "^4.7.7",
+    "react": "^17.0.2",
+    "react-dom": "^17.0.2",
+    "require-from-string": "^2.0.2",
+    "swig": "^1.4.2"
+  }
+}
@@ -4,7 +4,8 @@ const { Liquid } = require('..')
 const liquid = new Liquid()

 function tag () {
-  console.log('--- tag ---')
+  console.log('         tag')
+  console.log('------------------------')
  return new Promise(resolve => {
    new Benchmark.Suite('tag')
      .add('if', test('{% if "foobar" %}foo{% endif %}'))
@@ -0,0 +1 @@
+<img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{{id}}.png">
@@ -0,0 +1 @@
+<img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{{id}}.png">
@@ -0,0 +1 @@
+<img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{{todo.id}}.png">
@@ -0,0 +1,44 @@
+<section class="todo-list">
+    <h1>
+        posuere cubilia Curae; Vestibulum hendrerit malesuada odio. Fusce ut elit
+        ut augue sollicitudin blandit. Phasellus volutpat lorem. Duis non pede et
+        neque luctus tincidunt. Duis interdum tempus elit.
+        <small>Aenean metus. Vestibulum ac lacus. Vivamus porttitor, massa ut.</small>
+    </h1>
+    <a href={{url "/add"}} class="todo-add"><i class="fa fa-plus-square"></i>Add Todo</a>
+    <ul class="filter-category">
+        {{#each categories }}
+        <li style="background: {{ color }}">
+            <a href="/todos/category/{{ id }}">{{ title }}</a>
+        </li>
+        {{/each}}
+    </ul>
+    {{#each todos }}
+    <div>
+        <h2>
+            Todo {{inc @index}}:
+            <span class="todo-item content" data-todo-index="{{@index}}">
+                {{ upcase (concat 'TODO: ' title) }}
+            </span>
+        </h2>
+        {{> todo-icon id=id }}
+
+        <p class="description">
+            Purus eu mi. Proin commodo, massa commodo dapibus elementum,
+            libero lacus pulvinar eros, ut tincidunt nisl elit ut velit. Cras rutrum
+            porta purus. Vivamus lorem. Sed turpis enim, faucibus quis, pharetra in,
+            sagittis sed, magna. Curabitur ultricies felis ut libero. Nullam tincidunt
+            enim eu nibh. Nunc eget ipsum in sem facilisis convallis. Proin fermentum
+        </p>
+
+        <div class="todo-meta">
+            {{# if category }}
+                <span>{{ capitalize category }}</span>
+            {{/if}}
+        </div>
+        <a class="btn btn-primary" href={{ url (concat "/edit/" id) }}><i class="fa fa-pencil"></i> Edit</a>
+        <a class="btn btn-default"><i class="fa fa-check"></i> Check</a>
+        <a class="btn ben-danger" href={{ url (concat "/delete/" id) }}><i class="fa fa-trash-o"</i> Trash</a>
+    </div>
+    {{/each}}
+</section>
@@ -0,0 +1,57 @@
+// eslint-disable-next-line
+const React = require('react')
+
+function capitalize (str) {
+  return str[0].toUpperCase() + str.slice(1).toLowerCase()
+}
+function url (path) {
+  return `http://example.com${path}`
+}
+function renderTodoIcon (id) {
+  return <img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{id}.png"/>
+}
+
+module.exports = ({ categories, todos }) => {
+  return <section className="todo-list">
+    <h1>
+            posuere cubilia Curae; Vestibulum hendrerit malesuada odio. Fusce ut elit
+            ut augue sollicitudin blandit. Phasellus volutpat lorem. Duis non pede et
+            neque luctus tincidunt. Duis interdum tempus elit.
+      <small>Aenean metus. Vestibulum ac lacus. Vivamus porttitor, massa ut.</small>
+    </h1>
+    <a href={url('/add')} className="todo-add"><i className="fa fa-plus-square"></i>Add Todo</a>
+    <ul className="filter-category">
+      {categories.map((item, i) => {
+        return <li key={i} style={{ background: item.color }}>
+          <a href={'/todos/category/' + item.id }>{ item.title }</a>
+        </li>
+      })}
+    </ul>
+    {todos.map((todo, index0) => {
+      return <div key={index0}>
+        <h2>
+                    Todo { index0 + 1 }:
+          <span className="todo-item content" data-todo-index="{{ forloop.index0 }}">
+            { ('TODO: ' + todo.title).toUpperCase() }
+          </span>
+        </h2>
+        { renderTodoIcon(todo.id) }
+
+        <p className="description">
+                    Purus eu mi. Proin commodo, massa commodo dapibus elementum,
+                    libero lacus pulvinar eros, ut tincidunt nisl elit ut velit. Cras rutrum
+                    porta purus. Vivamus lorem. Sed turpis enim, faucibus quis, pharetra in,
+                    sagittis sed, magna. Curabitur ultricies felis ut libero. Nullam tincidunt
+                    enim eu nibh. Nunc eget ipsum in sem facilisis convallis. Proin fermentum
+        </p>
+
+        <div className="todo-meta">
+          { todo.category ? <span>{capitalize(todo.category)}</span> : '' }
+        </div>
+        <a className="btn btn-primary" href={url('/edit/' + todo.id)}><i className="fa fa-pencil"></i> Edit</a>
+        <a className="btn btn-default"><i className="fa fa-check"></i> Check</a>
+        <a className="btn ben-danger" href={url('/delete/' + todo.id)}><i className="fa fa-trash-o"></i> Trash</a>
+      </div>
+    })}
+  </section>
+}
@@ -7,8 +7,7 @@
    </h1>
    <a href={{"/add" | url}} class="todo-add"><i class="fa fa-plus-square"></i>Add Todo</a>
    <ul class="filter-category">
-        {% for i in (0..categories.length) %}
-        {% assign item=categories[i] %}
+        {% for item in categories %}
        <li style="background: {{ item.color }}">
            <a href="/todos/category/{{ item.id }}">{{ item.title }}</a>
        </li>
@@ -22,11 +21,7 @@
                {{ todo.title | prepend: 'TODO: ' | upcase }}
            </span>
        </h2>
-    
-        <img
-            title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices"
-            src="{% include "todo-icon", id=todo.id }} %}"
-        >
+        {% render "todo-icon", id:todo.id %}

        <p class="description">
            Purus eu mi. Proin commodo, massa commodo dapibus elementum,
@@ -38,12 +33,12 @@

        <div class="todo-meta">
            {% if todo.category %}
-                <span>{{  todo.category.title | capitalize }}</span>
+                <span>{{  todo.category | capitalize }}</span>
            {% endif %}
        </div>
-        <a class="btn btn-primary" href={{"/edit/" | append todo.id | url }}><i class="fa fa-pencil"></i> Edit</a>
+        <a class="btn btn-primary" href={{"/edit/" | append: todo.id | url }}><i class="fa fa-pencil"></i> Edit</a>
        <a class="btn btn-default"><i class="fa fa-check"></i> Check</a>
-        <a class="btn ben-danger" href={{"/delete/" | append todo.id | url }}><i class="fa fa-trash-o"</i> Trash</a>
+        <a class="btn ben-danger" href={{"/delete/" | append: todo.id | url }}><i class="fa fa-trash-o"</i> Trash</a>
    </div>
    {% endfor %}
 </section>
@@ -0,0 +1,44 @@
+<section class="todo-list">
+    <h1>
+        posuere cubilia Curae; Vestibulum hendrerit malesuada odio. Fusce ut elit
+        ut augue sollicitudin blandit. Phasellus volutpat lorem. Duis non pede et
+        neque luctus tincidunt. Duis interdum tempus elit.
+        <small>Aenean metus. Vestibulum ac lacus. Vivamus porttitor, massa ut.</small>
+    </h1>
+    <a href={{"/add" | url}} class="todo-add"><i class="fa fa-plus-square"></i>Add Todo</a>
+    <ul class="filter-category">
+        {% for item in categories %}
+        <li style="background: {{ item.color }}">
+            <a href="/todos/category/{{ item.id }}">{{ item.title }}</a>
+        </li>
+        {% endfor %}
+    </ul>
+    {% for todo in todos %}
+    <div>
+        <h2>
+            Todo {{ loop.index }}:
+            <span class="todo-item content" data-todo-index="{{ loop.index0 }}">
+                {{ todo.title | prepend('TODO: ') | upcase }}
+            </span>
+        </h2>
+        {% include "todo-icon.swig" %}
+
+        <p class="description">
+            Purus eu mi. Proin commodo, massa commodo dapibus elementum,
+            libero lacus pulvinar eros, ut tincidunt nisl elit ut velit. Cras rutrum
+            porta purus. Vivamus lorem. Sed turpis enim, faucibus quis, pharetra in,
+            sagittis sed, magna. Curabitur ultricies felis ut libero. Nullam tincidunt
+            enim eu nibh. Nunc eget ipsum in sem facilisis convallis. Proin fermentum
+        </p>
+
+        <div class="todo-meta">
+            {% if todo.category %}
+                <span>{{ todo.category | capitalize }}</span>
+            {% endif %}
+        </div>
+        <a class="btn btn-primary" href={{"/edit/" | append(todo.id) | url }}><i class="fa fa-pencil"></i> Edit</a>
+        <a class="btn btn-default"><i class="fa fa-check"></i> Check</a>
+        <a class="btn ben-danger" href={{"/delete/" | append(todo.id) | url }}><i class="fa fa-trash-o"</i> Trash</a>
+    </div>
+    {% endfor %}
+</section>
@@ -23,4 +23,4 @@ for file in $(find docs/source/api -name "*.md"); do
    fi
 done

-cp -r docs/source/api docs/source/zh-cn/api
+cp -r docs/source/api docs/source/zh-cn/api
@@ -9,8 +9,16 @@ npm run build
 cp CNAME public/

 cp ../CHANGELOG.md source/tutorials/changelog.md
+sed -i \
+  -e 's/{%/{% raw %}{%{% endraw %}/g' \
+  -e 's/{{/{% raw %}{{{% endraw %}/g' \
+  -e '1 s/"/\&quot;/g' \
+  -e '1 s/</\&lt;/g' \
+  -e '1 s/>/\&gt;/g' \
+  source/tutorials/changelog.md
+cp source/tutorials/changelog.md source/zh-cn/tutorials/changelog.md
+
 sed -i '1i ---\ntitle: Changelog\nauto: true\n---\n' source/tutorials/changelog.md
-cp ../CHANGELOG.md source/zh-cn/tutorials/changelog.md
 sed -i '1i ---\ntitle: 更新日志\nauto: true\n---\n' source/zh-cn/tutorials/changelog.md

 if [ "$HEXO_ALGOLIA_INDEXING_KEY" != "" ]; then
@@ -13,7 +13,7 @@ for size in "${apple[@]}"; do
 done
 cp logo.png apple-touch-icon.png
 convert logo.png \
-     \( +clone  -alpha extract \
+     \( +clone -alpha extract \
        -draw 'fill black polygon 0,0 0,80 80,0 fill white circle 80,80 80,0' \
        \( +clone -flip \) -compose Multiply -composite \
        \( +clone -flop \) -compose Multiply -composite \
@@ -4,16 +4,18 @@ const isQuote = c => c === '"' || c === "'"
 const isOperator = c => '!=<>'.includes(c)
 const isNumber = c => c >= '0' && c <= '9'
 const isCharacter = c => (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')
-const isVariable = c => '_-?'.includes(c) || isCharacter(c) || isNumber(c)
-const isBlank = c => c === '\n' || c === '\t' || c === ' ' || c === '\r'
+const isIdentifier = c => '_-?'.includes(c) || isCharacter(c) || isNumber(c)
+const isBlank = c => c === '\n' || c === '\t' || c === ' ' || c === '\r' || c === '\v' || c === '\f'
 const isInlineBlank = c => c === '\t' || c === ' ' || c === '\r'
 const isSign = c => c === '-' || c === '+'
+// See https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/RegExp
+const unicodeBlanks = '\u00a0\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000'

 const types = []
 for (let i = 0; i < 128; i++) {
  const c = String.fromCharCode(i)
  let n = 0
-  if (isVariable(c)) n |= 1
+  if (isIdentifier(c)) n |= 1
  if (isOperator(c)) n |= 2
  if (isBlank(c)) n |= 4
  if (isQuote(c)) n |= 8
@@ -22,11 +24,14 @@ for (let i = 0; i < 128; i++) {
  if (isSign(c)) n |= 64
  types.push(n)
 }
+
 console.log(`
+// **DO NOT CHANGE THIS FILE**
+//
+// This file is generated by bin/character-gen.js
 // bitmask character types to boost performance
-// generated by bin/character-gen.js
 export const TYPES = [${types.join(', ')}]
-export const VARIABLE = 1
+export const IDENTIFIER = 1
 export const OPERATOR = 2
 export const BLANK = 4
 export const QUOTE = 8
@@ -34,3 +39,5 @@ export const INLINE_BLANK = 16
 export const NUMBER = 32
 export const SIGN = 64
 `.trim())
+
+console.log([...unicodeBlanks].map(char => `TYPES[${char.charCodeAt(0)}]`).join(' = ') + ' = BLANK')
@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+
+VERSION_LATEST=$(cat package.json | grep '"version":' | awk -F'"' '{print $4}')
+FILE_LOCAL=dist/liquid.node.cjs.js
+FILE_LATEST=dist/liquid.node.cjs.$VERSION_LATEST.js
+URL_LATEST=https://unpkg.com/liquidjs@$VERSION_LATEST/dist/liquid.node.cjs.js
+
+if [ ! -f $FILE_LATEST ]; then
+    curl $URL_LATEST > $FILE_LATEST
+fi
+
+if [ ! -f $FILE_LOCAL ]; then
+    BUNDLES=cjs npm run build:dist
+fi
+
+exec node benchmark/diff.js $FILE_LOCAL $FILE_LATEST
@@ -3,7 +3,7 @@

 <head>
  <title>liquidjs for the browser</title>
-  <script src="node_modules/liquidjs/dist/liquid.min.js"></script>
+  <script src="node_modules/liquidjs/dist/liquid.browser.min.js"></script>
 </head>

 <body>
@@ -1,8 +1,14 @@
 const { Liquid } = require('liquidjs')

 const engine = new Liquid({
+  extname: '.liquid',
+  globals: { title: 'LiquidJS Demo' },
+  // root files for `.render()` and `.parse()`
  root: __dirname,
-  extname: '.liquid'
+  // layout files for `{% layout %}`
+  layouts: './layouts',
+  // partial files for `{% include %}` and `{% render %}`
+  partials: './partials'
 })

 engine.registerTag('header', {
@@ -17,10 +23,19 @@ engine.registerTag('header', {
 })

 const ctx = {
-  todos: ['fork and clone', 'make it better', 'make a pull request'],
-  title: 'Welcome to liquidjs!'
+  todos: ['fork and clone', 'make it better', 'make a pull request']
 }

-engine.renderFile('todolist', ctx)
-  .then(console.log)
-  .catch(err => console.error(err.stack))
+async function main () {
+  console.log('==========renderFile===========')
+  const html = await engine.renderFile('todolist', ctx)
+  console.log(html)
+
+  console.log('===========Streamed===========')
+  const tpls = await engine.parseFile('todolist')
+  engine.renderToNodeStream(tpls, ctx)
+    .on('data', data => process.stdout.write(data))
+    .on('end', () => console.log(''))
+}
+
+main()
@@ -0,0 +1,7 @@
+<html>
+  <head><meta name="title" content="{{title}}"></head>
+  <body>
+    {% block %}{% endblock %}
+    {% render "footer.liquid" %}
+  </body>
+</html>
@@ -7,6 +7,6 @@
    "start": "node index.js"
  },
  "dependencies": {
-    "liquidjs": "*"
+    "liquidjs": "^9.27.0"
  }
 }
@@ -0,0 +1 @@
+<small>{{title}}</small>
@@ -0,0 +1 @@
+<li>{{index}} - {{todo}}</li>
@@ -1,7 +1,7 @@
-{%header content: "welcome to liquid" | capitalize%}
-
+{% layout 'html.liquid' %}
+{%header content: title | capitalize%}
 <ul>
  {% for todo in todos %}
-  <li>{{forloop.index}} - {{todo}}</li>
+    {% render 'todo.liquid' with todo, index: forloop.index%}
  {% endfor %}
-</ul>
+</ul>
@@ -7,7 +7,11 @@
    "start": "ts-node index.ts"
  },
  "dependencies": {
-    "ts-node": "^8.0.2",
-    "liquidjs": "*"
+    "liquidjs": "*",
+    "ts-node": "^8.10.2",
+    "typescript": "^4.2.4"
+  },
+  "devDependencies": {
+    "@types/node": "^14.14.37"
  }
 }
@@ -1,4 +1,4 @@
-{%header content: "welcome to liquid" | capitalize%}
+{%header content: title | capitalize%}

 <ul>
  {% for todo in todos %}
@@ -0,0 +1,7 @@
+{
+  "compilerOptions": {
+      "types": [
+        "node"
+      ]
+  }
+}
@@ -1,6 +1,6 @@
 title: LiquidJS
 subtitle: "A simple, expressive and safe template engine."
-description: "LiquidJS is a simple, expressive and safe template engine."
+description: "LiquidJS is a simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript."
 author: Harttle
 language: en
 timezone: UTC
@@ -8,8 +8,6 @@ timezone: UTC
 url: https://liquidjs.com
 root: /
 permalink: news/:year/:month/:day/:title/
-archive_dir: news
-code_dir: downloads/code
 relative_link: true
 new_post_name: :year-:month-:day-:title.md # File name of new posts
 post_asset_folder: true
@@ -3,7 +3,7 @@
  "version": "0.0.0",
  "private": true,
  "hexo": {
-    "version": "4.2.0"
+    "version": "5.4.0"
  },
  "scripts": {
    "build": "hexo generate",
@@ -13,7 +13,7 @@
  },
  "dependencies": {
    "cheerio": "^0.22.0",
-    "hexo": "^4.2.0",
+    "hexo": "^5.4.0",
    "hexo-algolia": "^1.3.1",
    "hexo-clean-css": "^1.0.0",
    "hexo-filter-nofollow": "^2.0.2",
@@ -21,15 +21,16 @@
    "hexo-generator-feed": "^2.0.0",
    "hexo-generator-sitemap": "^2.0.0",
    "hexo-renderer-marked": "^2.0.0",
-    "hexo-renderer-pug": "^1.0.0",
+    "hexo-renderer-pug": "^2.0.0",
    "hexo-renderer-stylus": "^1.0.0",
+    "hexo-renderer-swig": "^1.1.0",
    "hexo-server": "^1.0.0",
    "hexo-uglify": "^1.0.0"
  },
  "devDependencies": {
+    "all-contributors-cli": "^6.8.1",
    "eslint": "^6.0.1",
-    "eslint-config-hexo": "^4.0.0",
-    "all-contributors-cli": "^6.8.1"
+    "eslint-config-hexo": "^4.0.0"
  },
  "engines": {
    "node": ">=8.10.0"
@@ -37,7 +37,12 @@ hexo.extend.helper.register('page_nav', function () {
 })

 hexo.extend.helper.register('raw', function (filepath) {
-  const content = readFileSync(resolve(this.view_dir, filepath))
+  const content = readFileSync(resolve(this.view_dir, filepath), 'utf8')
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;')
  return content
 })

@@ -2,7 +2,7 @@

 'use strict'

-hexo.extend.tag.register('note', (args, content) => {
+hexo.extend.tag.register('note', (args, text) => {
  const className = args.shift()
  let header = ''
  let result = ''
@@ -12,8 +12,12 @@ hexo.extend.tag.register('note', (args, content) => {
  }

  result += `<blockquote class="note ${className}">${header}`
-  result += hexo.render.renderSync({ text: content, engine: 'markdown' })
+  result += hexo.render.renderSync({ text, engine: 'markdown' })
  result += '</blockquote>'

  return result
 }, true)
+
+hexo.extend.tag.register('since', (args, text) => {
+  return `<p class="since">${text.trim()}</p>`
+}, true)
@@ -1,9 +1,3 @@
-
-  url: https://github.com/harttle/liquidjs/pull/5
-  date: '2016-09-12'
-  title:
-    zh-cn: '异步化：重写了解析器和渲染器，使 LiquidJS 可以提供 Promise API 并支持异步的自定义 Tag 实现。'
-    en: 'Async spike: rewrite the parser and render to support Promise, which enables async tags.'
 -
  url: https://opencollective.com/liquidjs/#section-contribute
  date: '2020-02-26'
@@ -18,7 +12,13 @@
    en: 'Memory Optimization: a more elaborate parser reducing the memory footprint by 57.7%.'
 -
  url: https://github.com/harttle/liquidjs/pull/205
-  date: '2020-09-15'
+  date: '2020-03-15'
  title:
    zh-cn: '性能提升：引入 AST 并重新设计 Token 类型系统，使渲染性能平均提升 100.3%。'
    en: 'Performance Boost: a simple AST to improve render performance by 100.3%.'
+-
+  url: https://github.com/harttle/liquidjs/milestone/3?closed=1
+  date: '2021-09-30'
+  title:
+    zh-cn: '流式渲染：4 倍渲染速度，并增加了对流式渲染的支持。'
+    en: 'Streamed Rendering: now render is 4x faster and support streamed rendering.'
@@ -27,6 +27,7 @@ filters:
  at_most: at_most.html
  capitalize: capitalize.html
  ceil: ceil.html
+  compact: compact.html
  date: date.html
  default: default.html
  divided_by: divided_by.html
@@ -64,6 +65,7 @@ filters:
  truncate: truncate.html
  truncatewords: truncatewords.html
  uniq: uniq.html
+  concat: concat.html
  upcase: upcase.html
  url_decode: url_decode.html
  url_encode: url_encode.html
@@ -135,4 +137,4 @@ api:
    LiquidOptions: "../interfaces/liquid_options_.liquidoptions.html"
    NormalizedFullOptions: "../interfaces/liquid_options_.normalizedfulloptions.html"
    PlainObject: "../interfaces/context_scope_.plainobject.html"
-    TagImplOptions: "../interfaces/template_tag_tag_impl_options_.tagimploptions.html"
+    TagImplOptions: "../interfaces/template_tag_tag_impl_options_.tagimploptions.html"
@@ -2,6 +2,8 @@
 title: abs
 ---

+{% since %}v1.9.1{% endsince %}
+
 Liquid filter that returns the absolute value of a number.

 Input
@@ -2,6 +2,8 @@
 title: append
 ---

+{% since %}v1.9.1{% endsince %}
+
 Concatenates two strings and returns the concatenated value.

 Input
@@ -2,6 +2,8 @@
 title: at_least
 ---

+{% since %}v8.4.0{% endsince %}
+
 Limits a number to a minimum value.

 Input
@@ -2,6 +2,8 @@
 title: at_most
 ---

+{% since %}v8.4.0{% endsince %}
+
 Limits a number to a maximum value.

 Input
@@ -2,6 +2,8 @@
 title: capitalize
 ---

+{% since %}v1.9.1{% endsince %}
+
 Makes the first character of a string capitalized.

 Input
@@ -2,6 +2,8 @@
 title: ceil
 ---

+{% since %}v1.9.1{% endsince %}
+
 Rounds the input up to the nearest whole number. LiquidJS tries to convert the input to a number before the filter is applied.

 Input
@@ -2,6 +2,8 @@
 title: compact
 ---

+{% since %}v9.22.0{% endsince %}
+
 Removes any `nil` values from an array.

 For this example, assume `site.pages` is an array of content pages for a website, and some of these pages have an attribute called `category` that specifies their content category. If we `map` those categories to an array, some of the array items might be `nil` if any pages do not have a `category` attribute.
@@ -2,6 +2,8 @@
 title: concat
 ---

+{% since %}v2.0.0{% endsince %}
+
 Concatenates (joins together) multiple arrays. The resulting array contains all the items from the input arrays.

 Input
@@ -2,7 +2,9 @@
 title: date
 ---

-Converts a timestamp into another date format. The format for this syntax is the same as [`strftime`](http://strftime.net). The input is first converted to Date object by [new Date()][newDate].
+{% since %}v1.9.1{% endsince %}
+
+Converts a timestamp into another date format. LiquidJS tries to be conformant with Shopify/Liquid which is using Ruby's core [Time#strftime(string)](http://www.ruby-doc.org/core/Time.html#method-i-strftime). The input is firstly converted to `Date` object via [new Date()][newDate].

 Input
 ```liquid
@@ -14,6 +16,10 @@ Output
 Fri, Jul 17, 15
 ```

+{% note info TimeZone %}
+Date will be converted to local time before output. To avoid that, you can set `timezoneOffset` LiquidJS option to `0`, its default value is your local timezone offset which can be obtained by `new Date().getTimezoneOffset()`.
+{% endnote %}
+
 Input
 ```liquid
 {{ article.published_at | date: "%Y" }}
@@ -36,6 +42,10 @@ Output
 Mar 14, 16
 ```

+{% note info Timestamp Strings %}
+Note that LiquidJS is using JavaScript [Date][newDate] to parse the input string, that means [IETF-compliant RFC 2822 timestamps](https://datatracker.ietf.org/doc/html/rfc2822#page-14) and strings in [a version of ISO8601](https://www.ecma-international.org/ecma-262/11.0/#sec-date.parse) are supported.
+{% endnote %}
+
 To get the current time, pass the special word `"now"` (or `"today"`) to `date`:

 Input
@@ -2,6 +2,8 @@
 title: default
 ---

+{% since %}v1.9.1{% endsince %}
+
 Allows you to specify a fallback in case a value doesn't exist. `default` will show its value if the left side is [falsy][falsy] or empty (`string` or `Array`).

 In this example, `product_price` is not defined, so the default value is used.
@@ -2,6 +2,8 @@
 title: divided_by
 ---

+{% since %}v1.9.1{% endsince %}
+
 Divides a number by another number. The result is the string obtained by JavaScript `.toString()` of the result number.

 Input
@@ -2,6 +2,8 @@
 title: downcase
 ---

+{% since %}v1.9.1{% endsince %}
+
 Makes each character in a string lowercase. It has no effect on strings which are already all lowercase.

 Input
@@ -2,6 +2,8 @@
 title: escape
 ---

+{% since %}v1.9.1{% endsince %}
+
 Escapes a string by replacing HTML special characters with escape sequences. It doesn't change strings that don't have anything to escape.

 Input
@@ -2,6 +2,8 @@
 title: escape_once
 ---

+{% since %}v1.9.1{% endsince %}
+
 Escapes a string without changing existing escaped entities. It doesn't change strings that don't have anything to escape.

 Input
@@ -2,6 +2,8 @@
 title: first
 ---

+{% since %}v1.9.1{% endsince %}
+
 Returns the first item of an array.

 Input
@@ -2,6 +2,8 @@
 title: floor
 ---

+{% since %}v1.9.1{% endsince %}
+
 Rounds the input down to the nearest whole number. LiquidJS tries to convert the input to a number before the filter is applied.

 Input
@@ -2,6 +2,8 @@
 title: join
 ---

+{% since %}v1.9.1{% endsince %}
+
 Combines the items in an array into a single string using the argument as a separator.

 Input
@@ -2,6 +2,8 @@
 title: json
 ---

+{% since %}v9.10.0{% endsince %}
+
 Convert values to string via `JSON.stringify()`, for debug purpose.

 Input
@@ -2,6 +2,8 @@
 title: last
 ---

+{% since %}v1.9.1{% endsince %}
+
 Returns the last item of an array.

 Input
@@ -2,6 +2,8 @@
 title: lstrip
 ---

+{% since %}v1.9.1{% endsince %}
+
 Removes all whitespace (tabs, spaces, and newlines) from the left side of a string. It does not affect spaces between words.

 Input
@@ -2,6 +2,8 @@
 title: map
 ---

+{% since %}v1.9.1{% endsince %}
+
 Creates an array of values by extracting the values of a named property from another object.

 In this example, assume the object `site.pages` contains all the metadata for a website. Using `assign` with the `map` filter creates a variable that contains only the values of the `category` properties of everything in the `site.pages` object.
@@ -2,6 +2,8 @@
 title: minus
 ---

+{% since %}v1.9.1{% endsince %}
+
 Subtracts a number from another number.

 Input
@@ -2,6 +2,8 @@
 title: modulo
 ---

+{% since %}v1.9.1{% endsince %}
+
 Returns the remainder of a division operation.

 Input
@@ -2,6 +2,8 @@
 title: newline_to_br
 ---

+{% since %}v1.9.1{% endsince %}
+
 Replaces every newline (`\n`) in a string with an HTML line break (`<br />`).

 Input
@@ -11,7 +11,7 @@ Categories | Filters
 Math | plus, minus, modulo, times, floor, ceil, round, divided_by, abs
 String | append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, remove, remove_first, truncate, truncatewords
 HTML/URI | escape, escape_once, url_encode, url_decode, strip_html, newline_to_br
-Array | slice, map, sort, sort_natural, uniq, wheres, first, last, join, reverse
+Array | slice, map, sort, sort_natural, uniq, where, first, last, join, reverse, concat
 Date | date

 [shopify/liquid]: https://github.com/Shopify/liquid
@@ -2,6 +2,8 @@
 title: plus
 ---

+{% since %}v1.9.1{% endsince %}
+
 Adds a number to another number.

 Input
@@ -2,6 +2,8 @@
 title: prepend
 ---

+{% since %}v1.9.1{% endsince %}
+
 Adds the specified string to the beginning of another string.

 Input
@@ -2,6 +2,8 @@
 title: remove
 ---

+{% since %}v1.9.1{% endsince %}
+
 Removes every occurrence of the specified substring from a string.

 Input
@@ -2,6 +2,8 @@
 title: remove_first
 ---

+{% since %}v1.9.1{% endsince %}
+
 Removes only the first occurrence of the specified substring from a string.

 Input
@@ -2,6 +2,8 @@
 title: replace
 ---

+{% since %}v1.9.1{% endsince %}
+
 Replaces every occurrence of the first argument in a string with the second argument.

 Input
@@ -2,6 +2,8 @@
 title: replace_first
 ---

+{% since %}v1.9.1{% endsince %}
+
 Replaces only the first occurrence of the first argument in a string with the second argument.

 Input
@@ -2,6 +2,8 @@
 title: reverse
 ---

+{% since %}v1.9.1{% endsince %}
+
 Reverses the order of the items in an array. `reverse` cannot reverse a string.

 Input
@@ -2,6 +2,8 @@
 title: round
 ---

+{% since %}v1.9.1{% endsince %}
+
 Rounds a number to the nearest integer or, if a number is passed as an argument, to that number of decimal places.

 Input
@@ -2,6 +2,8 @@
 title: rstrip
 ---

+{% since %}v1.9.1{% endsince %}
+
 Removes all whitespace (tabs, spaces, and newlines) from the right side of a string. It does not affect spaces between words.

 Input
@@ -2,6 +2,8 @@
 title: size
 ---

+{% since %}v1.9.1{% endsince %}
+
 Returns the number of characters in a string or the number of items in an array.

 Input
@@ -2,6 +2,8 @@
 title: slice
 ---

+{% since %}v1.9.1{% endsince %}
+
 Returns a substring of 1 character beginning at the index specified by the first argument. An optional second argument specifies the length of the substring to be returned.

 String indices are numbered starting from 0.
@@ -2,6 +2,8 @@
 title: sort
 ---

+{% since %}v1.9.1{% endsince %}
+
 Sorts items in an array in case-sensitive order.

 Input
@@ -2,6 +2,8 @@
 title: sort_natural
 ---

+{% since %}v8.4.0{% endsince %}
+
 Sorts items in an array in case-insensitive order.

 Input
@@ -2,6 +2,8 @@
 title: split
 ---

+{% since %}v1.9.1{% endsince %}
+
 Divides a string into an array using the argument as a separator. `split` is commonly used to convert comma-separated items from a string to an array.

 Input
@@ -2,6 +2,8 @@
 title: strip
 ---

+{% since %}v1.9.1{% endsince %}
+
 Removes all whitespace (tabs, spaces, and newlines) from both the left and right sides of a string. It does not affect spaces between words.

 Input
@@ -2,6 +2,8 @@
 title: strip_html
 ---

+{% since %}v1.9.1{% endsince %}
+
 Removes any HTML tags from a string.

 Input
@@ -2,6 +2,8 @@
 title: strip_newlines
 ---

+{% since %}v1.9.1{% endsince %}
+
 Removes any newline characters (line breaks) from a string.

 Input
@@ -2,6 +2,8 @@
 title: times
 ---

+{% since %}v1.9.1{% endsince %}
+
 Multiplies a number by another number.

 Input
@@ -2,6 +2,8 @@
 title: truncate
 ---

+{% since %}v1.9.1{% endsince %}
+
 Shortens a string down to the number of characters passed as an argument. If the specified number of characters is less than the length of the string, an ellipsis (...) is appended to the string and is included in the character count.

 ## Basic Usage
@@ -2,6 +2,8 @@
 title: truncatewords
 ---

+{% since %}v1.9.1{% endsince %}
+
 Shortens a string down to the number of words passed as an argument. If the specified number of words is less than the number of words in the string, an ellipsis (...) is appended to the string.

 Input
--- a/Show More
+++ b/Show More
				`@@ -0,0 +1 @@`
				`<img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{{id}}.png">`