diff --git a/src/docs/languages/liquid.md b/src/docs/languages/liquid.md index 014b1284e4..791e4ae90a 100644 --- a/src/docs/languages/liquid.md +++ b/src/docs/languages/liquid.md @@ -79,12 +79,12 @@ export default function (eleventyConfig) { | Feature | Syntax | | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ✅ Include | `{% raw %}{% include user %}{% endraw %}` looks for `_includes/user.liquid`. Does not process front matter in the include file. | -| ✅ Includes (Relative Path) {% addedin "0.9.0" %} | Relative paths use `./` (template’s directory) or `../` (template’s parent directory): `{% raw %}{% include ./included %}{% endraw %}` looks for `included.liquid` in the template’s current directory. Does not process front matter.

{% callout "warn" %}If `_includes/included.liquid` also exists, Liquid will use this file instead.{% endcallout %} | -| ✅ Include (Quoted) | {% callout "info" %}Starting in Eleventy 1.0, Liquid includes without quotation marks require `dynamicPartials: false`—Read more at [Quoted Include Paths](#quoted-include-paths).{% endcallout %}`{% raw %}{% include 'user' %}{% endraw %}` looks for `_includes/user.liquid`. Does not process front matter in the include file. | -| ✅ Include (Relative Path, Quoted) {% addedin "0.9.0" %} | {% callout "info" %}Starting in Eleventy 1.0, Liquid includes without quotation marks require `dynamicPartials: false`—Read more at [Quoted Include Paths](#quoted-include-paths).{% endcallout %}Relative paths use `./` (template’s directory) or `../` (template’s parent directory): `{% raw %}{% include './dir/user' %}{% endraw %}` looks for `./dir/user.liquid` from the template’s current directory. Does not process front matter in the include file.

{% callout "warn" %}If `_includes/dir/user.liquid` also exists, Liquid will use this file instead.{% endcallout %} | -| ✅ Include (pass in Data) | `{% raw %}{% include 'user' with 'Ava' %}{% endraw %}`. Does not process front matter in the include file. | -| ✅ Include (pass in Data) | `{% raw %}{% include 'user', user1: 'Ava', user2: 'Bill' %}{% endraw %}`. Does not process front matter in the include file. | +| ✅ Render | `{% raw %}{% render user %}{% endraw %}` looks for `_includes/user.liquid`. Does not process front matter in the include file. | +| ✅ Render (Relative Path) {% addedin "0.9.0" %} | Relative paths use `./` (template’s directory) or `../` (template’s parent directory): `{% raw %}{% render ./included %}{% endraw %}` looks for `included.liquid` in the template’s current directory. Does not process front matter.

{% callout "warn" %}If `_includes/included.liquid` also exists, Liquid will use this file instead.{% endcallout %} | +| ✅ Render (Quoted) | {% callout "info" %}Starting in Eleventy 1.0, Liquid includes without quotation marks require `dynamicPartials: false`—Read more at [Quoted Include Paths](#quoted-include-paths).{% endcallout %}`{% raw %}{% render 'user' %}{% endraw %}` looks for `_includes/user.liquid`. Does not process front matter in the include file. | +| ✅ Render (Relative Path, Quoted) {% addedin "0.9.0" %} | {% callout "info" %}Starting in Eleventy 1.0, Liquid includes without quotation marks require `dynamicPartials: false`—Read more at [Quoted Include Paths](#quoted-include-paths).{% endcallout %}Relative paths use `./` (template’s directory) or `../` (template’s parent directory): `{% raw %}{% render './dir/user' %}{% endraw %}` looks for `./dir/user.liquid` from the template’s current directory. Does not process front matter in the include file.

{% callout "warn" %}If `_includes/dir/user.liquid` also exists, Liquid will use this file instead.{% endcallout %} | +| ✅ Render (pass in Data) | `{% raw %}{% render 'user' with 'Ava' %}{% endraw %}`. Does not process front matter in the include file. | +| ✅ Render (pass in Data) | `{% raw %}{% render 'user', user1: 'Ava', user2: 'Bill' %}{% endraw %}`. Does not process front matter in the include file. | | ✅ Custom Filters | `{% raw %}{{ name \| upper }}{% endraw %}` Read more about [Filters](/docs/filters/) | | ✅ [Universal Filters](/docs/filters/) | `{% raw %}{% name \| filterName %}{% endraw %}` Read more about [Filters](/docs/filters/) | | ✅ [Custom Tags](/docs/custom-tags/) {% addedin "0.5.0" %} | `{% raw %}{% uppercase name %}{% endraw %}` Read more about [Custom Tags](/docs/custom-tags/). | @@ -98,11 +98,11 @@ If you’d like to use include paths without quotation marks, you must enable `d #### Default behavior, `dynamicPartials: true` -`{% raw %}{% include 'user' %}{% endraw %}` looks for `_includes/user.liquid` +`{% raw %}{% render 'user' %}{% endraw %}` looks for `_includes/user.liquid` #### Non-quoted includes with `dynamicPartials: false` -`{% raw %}{% include user %}{% endraw %}` looks for `_includes/user.liquid` +`{% raw %}{% render user %}{% endraw %}` looks for `_includes/user.liquid` ## Filters @@ -320,4 +320,3 @@ export default function (eleventyConfig) { }; {% endset %} {% include "snippets/configDefinition.njk" %} -