1432380329
* feat!: remove CLI support for template via STDIN Fixes #940 Co-authored-by: Cursor <[email protected]> * feat!: take CLI template as positional argument Make template a required positional arg (drop --template) for v11 per #586; stdin template remains unsupported without a special error. Co-authored-by: Cursor <[email protected]> * fix: restore --template CLI option Revert the positional-only template change. Keep --template as the primary API; stdin template remains unsupported without a special error. Co-authored-by: Cursor <[email protected]> * fix: restore explicit @- stdin for template and context Keep @- for --template and --context; only the legacy bare-stdin-as-template fallback stays removed. Co-authored-by: Cursor <[email protected]> * feat: accept CLI template as positional or --template Support positional <template> alongside --template/-t for compatibility; error if both are set and differ. Bare stdin template remains removed; @- still works. Co-authored-by: Cursor <[email protected]> * feat!: remove --template CLI option Template is positional-only; bare stdin template and --template/-t are both removed. Keep @- for template and --context. Co-authored-by: Cursor <[email protected]> --------- Co-authored-by: Cursor <[email protected]>
3.8 KiB
title
| title |
|---|
| Setup |
In case you're not familiar with Liquid Template Language, see Introduction to Liquid Template Language.
LiquidJS in Node.js
Install via npm:
npm install --save liquidjs
var { Liquid } = require('liquidjs');
var engine = new Liquid();
engine
.parseAndRender('{{name | capitalize}}', {name: 'alice'})
.then(console.log); // outputs 'Alice'
{% note info Working Demo %} Here's a working demo for LiquidJS usage in Node.js: liquidjs/demo/nodejs/.{% endnote %}
Type definitions for LiquidJS are also exported and published, which makes it more enjoyable for TypeScript projects:
import { Liquid } from 'liquidjs';
const engine = new Liquid();
engine
.parseAndRender('{{name | capitalize}}', {name: 'alice'})
.then(console.log); // outputs 'Alice'
{% note info Working Demo %} Here's a working demo for LiquidJS usage in TypeScript: liquidjs/demo/typescript/.{% endnote %}
LiquidJS in Browsers
Pre-built UMD bundles are also available:
<!--for production-->
<script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.browser.min.js"></script>
<!--for development-->
<script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.browser.umd.js"></script>
{% note info Working Demo %} Here's a live demo on jsFiddle: jsfiddle.net/pd4jhzLs/1/, and the source code is also available in liquidjs/demo/browser/.{% endnote %}
{% note warn Compatibility %} You may need a Promise polyfill for legacy browsers like IE and Android UC, see caniuse statistics. {% endnote %}
LiquidJS in CLI
LiquidJS can also be used to render a template directly from CLI using npx. Pass the template as a positional argument:
npx liquidjs '{{"hello" | capitalize}}'
You can either pass the template inline (as shown above), read it from a file with @ followed by a path, or from stdin with @-:
npx liquidjs @./some-template.liquid
echo '{{"hello" | capitalize}}' | npx liquidjs @-
A context can be passed the same ways (inline, from a path, or via @- for stdin). The following three are equivalent:
npx liquidjs 'Hello, {{ name }}!' --context '{"name": "Snake"}'
npx liquidjs 'Hello, {{ name }}!' --context @./some-context.json
echo '{"name": "Snake"}' | npx liquidjs 'Hello, {{ name }}!' --context @-
Note that you can only use the stdin specifier @- for a single argument. If you try to use it for both the template and --context you will get an error.
The rendered output is written to stdout by default, but you can also specify an output file (if the file exists, it will be overwritten):
npx liquidjs '{{"hello" | capitalize}}' --output ./hello.txt
You can also pass a number of options to customize template rendering behavior. For example, the --js-truthy option can be used to enable JavaScript truthiness:
npx liquidjs @./some-template.liquid --js-truthy
Most of the options available through the JavaScript API are also available from the CLI. For help on available options, use npx liquidjs --help.
Miscellaneous
A ReactJS demo is also added by @stevenanthonyrevo, see liquidjs/demo/reactjs/.