Hello, World! @#$%SGVsbG8sIFdvcmxkISBAIyQlTemplate files names passed to renderFile, parseFile, renderFileSync, parseFileSync APIs,
and include, layout tags are resolved against the root option.
It can be a string-typed path (see above example), or a list of root directories, in which case templates will be looked up in that order. e.g.
var engine = new Liquid({
- root: ['views/', 'views/partials/'],
+ root: ['views/'],
+ partials: ['views/partials/'],
+ layouts: ['views/layouts/'],
extname: '.liquid'
-});Relative Paths-Relative paths in
rootwill be resolved againstcwd().
When {% render "foo" %} is rendered or liquid.renderFile('foo') is called, the following files will be looked up and the first existing file will be used:
cwd()/views/foo.liquidcwd()/views/partials/foo.liquidparse(), render() functions are called, for example liquid.renderFile('foo'), templates under root will be looked up.{% render "foo" %}, templates under partials will be looked up.{% layout "foo" %}, templates under layouts will be looked up.If none of the above files exists, an ENOENT error will be thrown. Here’s a demo for Node.js: demo/nodejs.
When LiquidJS is used in browser, say current location is https://example.com/bar/index.html, only the first root will be used and the file to be fetched is:
If fetch fails, a 404/500 error or network failures for example, an ENOENT error will be thrown.
Here’s a demo for browsers: demo/browser.
When LiquidJS is used in browser, the paths will be resolved based on current location. Here’s a demo for browsers: demo/browser.
LiquidJS defines an abstract file system interface and the default implementation is src/fs/fs-impl.ts for Node.js and src/build/fs-impl-browser.ts for the browser bundle.
The Liquid constructor provides a fs option to specify the file system implementation. It’s supposed to be used to define customized template fetching logic, i.e. fetch template from a database table, like:
var engine = new Liquid({
@@ -177,7 +174,7 @@ engine.rende
diff --git a/tutorials/render-tag-content.html b/tutorials/render-tag-content.html
index ffd0e738f..ca28e8b2e 100644
--- a/tutorials/render-tag-content.html
+++ b/tutorials/render-tag-content.html
@@ -188,7 +188,7 @@
diff --git a/tutorials/setup.html b/tutorials/setup.html
index a29b4bbf2..96f6a4aed 100644
--- a/tutorials/setup.html
+++ b/tutorials/setup.html
@@ -155,7 +155,7 @@ npx liquidjs --template
diff --git a/tutorials/static-analysis.html b/tutorials/static-analysis.html
index 3eee13c8e..33643751a 100644
--- a/tutorials/static-analysis.html
+++ b/tutorials/static-analysis.html
@@ -317,7 +317,7 @@ engine.globa
diff --git a/tutorials/sync-and-async.html b/tutorials/sync-and-async.html
index 8b7c3df21..4df088688 100644
--- a/tutorials/sync-and-async.html
+++ b/tutorials/sync-and-async.html
@@ -180,7 +180,7 @@ engine.regis
diff --git a/tutorials/truthy-and-falsy.html b/tutorials/truthy-and-falsy.html
index d3833437c..0f5980107 100644
--- a/tutorials/truthy-and-falsy.html
+++ b/tutorials/truthy-and-falsy.html
@@ -226,7 +226,7 @@
diff --git a/tutorials/use-in-expressjs.html b/tutorials/use-in-expressjs.html
index 813c5a2cb..8f860e383 100644
--- a/tutorials/use-in-expressjs.html
+++ b/tutorials/use-in-expressjs.html
@@ -134,7 +134,7 @@ res.render
diff --git a/tutorials/whitespace-control.html b/tutorials/whitespace-control.html
index 8bc6c8339..d708ead67 100644
--- a/tutorials/whitespace-control.html
+++ b/tutorials/whitespace-control.html
@@ -121,7 +121,7 @@ harttle
diff --git a/zh-cn/filters/abs.html b/zh-cn/filters/abs.html
index ba7247534..353194a4d 100644
--- a/zh-cn/filters/abs.html
+++ b/zh-cn/filters/abs.html
@@ -116,7 +116,7 @@
diff --git a/zh-cn/filters/append.html b/zh-cn/filters/append.html
index 25772b5bb..cc9521b9d 100644
--- a/zh-cn/filters/append.html
+++ b/zh-cn/filters/append.html
@@ -112,7 +112,7 @@ website.com/index.html<
diff --git a/zh-cn/filters/array_to_sentence_string.html b/zh-cn/filters/array_to_sentence_string.html
index d566d2083..d2068ff82 100644
--- a/zh-cn/filters/array_to_sentence_string.html
+++ b/zh-cn/filters/array_to_sentence_string.html
@@ -109,7 +109,7 @@
diff --git a/zh-cn/filters/at_least.html b/zh-cn/filters/at_least.html
index 208a0e499..239139072 100644
--- a/zh-cn/filters/at_least.html
+++ b/zh-cn/filters/at_least.html
@@ -109,7 +109,7 @@
diff --git a/zh-cn/filters/at_most.html b/zh-cn/filters/at_most.html
index 72218a03a..9b77f2e07 100644
--- a/zh-cn/filters/at_most.html
+++ b/zh-cn/filters/at_most.html
@@ -109,7 +109,7 @@
diff --git a/zh-cn/filters/capitalize.html b/zh-cn/filters/capitalize.html
index 4c26a3830..613fef833 100644
--- a/zh-cn/filters/capitalize.html
+++ b/zh-cn/filters/capitalize.html
@@ -110,7 +110,7 @@
diff --git a/zh-cn/filters/ceil.html b/zh-cn/filters/ceil.html
index 4ff89653e..7e9bdf62b 100644
--- a/zh-cn/filters/ceil.html
+++ b/zh-cn/filters/ceil.html
@@ -122,7 +122,7 @@
diff --git a/zh-cn/filters/cgi_escape.html b/zh-cn/filters/cgi_escape.html
index 47450fe42..74fd6b631 100644
--- a/zh-cn/filters/cgi_escape.html
+++ b/zh-cn/filters/cgi_escape.html
@@ -103,7 +103,7 @@
diff --git a/zh-cn/filters/compact.html b/zh-cn/filters/compact.html
index 32206671c..dfdbc7812 100644
--- a/zh-cn/filters/compact.html
+++ b/zh-cn/filters/compact.html
@@ -129,7 +129,7 @@
diff --git a/zh-cn/filters/concat.html b/zh-cn/filters/concat.html
index 657dc2363..4eb6f7b9b 100644
--- a/zh-cn/filters/concat.html
+++ b/zh-cn/filters/concat.html
@@ -136,7 +136,7 @@
diff --git a/zh-cn/filters/date.html b/zh-cn/filters/date.html
index fe57c88cf..828567876 100644
--- a/zh-cn/filters/date.html
+++ b/zh-cn/filters/date.html
@@ -154,7 +154,7 @@
diff --git a/zh-cn/filters/date_to_long_string.html b/zh-cn/filters/date_to_long_string.html
index 940584d93..44d8099fb 100644
--- a/zh-cn/filters/date_to_long_string.html
+++ b/zh-cn/filters/date_to_long_string.html
@@ -112,7 +112,7 @@
diff --git a/zh-cn/filters/date_to_rfc822.html b/zh-cn/filters/date_to_rfc822.html
index 4359a4d67..285556f47 100644
--- a/zh-cn/filters/date_to_rfc822.html
+++ b/zh-cn/filters/date_to_rfc822.html
@@ -105,7 +105,7 @@
diff --git a/zh-cn/filters/date_to_string.html b/zh-cn/filters/date_to_string.html
index e176ab78b..42fc791b2 100644
--- a/zh-cn/filters/date_to_string.html
+++ b/zh-cn/filters/date_to_string.html
@@ -111,7 +111,7 @@
diff --git a/zh-cn/filters/date_to_xmlschema.html b/zh-cn/filters/date_to_xmlschema.html
index a16a53598..25c6792e3 100644
--- a/zh-cn/filters/date_to_xmlschema.html
+++ b/zh-cn/filters/date_to_xmlschema.html
@@ -105,7 +105,7 @@
diff --git a/zh-cn/filters/default.html b/zh-cn/filters/default.html
index 963ad8ba3..f3f72536a 100644
--- a/zh-cn/filters/default.html
+++ b/zh-cn/filters/default.html
@@ -130,7 +130,7 @@
diff --git a/zh-cn/filters/divided_by.html b/zh-cn/filters/divided_by.html
index 95bdfd4cf..256fb83e1 100644
--- a/zh-cn/filters/divided_by.html
+++ b/zh-cn/filters/divided_by.html
@@ -121,7 +121,7 @@
diff --git a/zh-cn/filters/downcase.html b/zh-cn/filters/downcase.html
index a76b80e42..1fb5b6d3c 100644
--- a/zh-cn/filters/downcase.html
+++ b/zh-cn/filters/downcase.html
@@ -109,7 +109,7 @@
diff --git a/zh-cn/filters/escape.html b/zh-cn/filters/escape.html
index 03f1ff012..6e5b4d43c 100644
--- a/zh-cn/filters/escape.html
+++ b/zh-cn/filters/escape.html
@@ -111,7 +111,7 @@ Have you read 'James & the Giant Peach'?
diff --git a/zh-cn/filters/escape_once.html b/zh-cn/filters/escape_once.html
index be72a166d..7d9094759 100644
--- a/zh-cn/filters/escape_once.html
+++ b/zh-cn/filters/escape_once.html
@@ -115,7 +115,7 @@
diff --git a/zh-cn/filters/find.html b/zh-cn/filters/find.html
index 690bdb7a0..a437490eb 100644
--- a/zh-cn/filters/find.html
+++ b/zh-cn/filters/find.html
@@ -109,7 +109,7 @@
diff --git a/zh-cn/filters/find_exp.html b/zh-cn/filters/find_exp.html
index 8fd1f45f5..416a27ba3 100644
--- a/zh-cn/filters/find_exp.html
+++ b/zh-cn/filters/find_exp.html
@@ -109,7 +109,7 @@
diff --git a/zh-cn/filters/first.html b/zh-cn/filters/first.html
index d4fc381e6..8425e8e13 100644
--- a/zh-cn/filters/first.html
+++ b/zh-cn/filters/first.html
@@ -116,7 +116,7 @@ zebra