diff --git a/liquid_tags/Readme.md b/liquid_tags/Readme.md index 6616c91b1..bf27b5e2a 100644 --- a/liquid_tags/Readme.md +++ b/liquid_tags/Readme.md @@ -258,8 +258,10 @@ comment line `# ` will be expanded on load but can be collapsed by tapping on their header. Cells without collapsed comments are rendered as standard code input cells. -## Configuration settings in custom tags +## Advanced features + +### Configuration settings in custom tags Tags do not have access to the full Pelicans settings, and instead arrange for the variables to be passed to the tag. For tag authors who plan to add their tag as in-tree tags, they can just add the variables they need to an array in @@ -269,6 +271,15 @@ user's `pelicanconf.py` settings: LIQUID_CONFIGS = (('PATH', '.', "The default path"), ('SITENAME', 'Default Sitename', 'The name of the site')) +### Custom delimiters +If you are using Liquid Tags in conjunction with some other plugin that also +uses the `{%` and `%}` delimiters to mark its blocks, then chaos will occur. +You can avoid the chaos by defining an alternative set of delimiters for +Liquid Tags. Just add them as a tuple in your `pelicanconf.py` settings: + + LT_DELIMITERS = ('<+', '+>') + + ## Testing To test the plugin in multiple environments we use [tox](http://tox.readthedocs.org/en/latest/). To run the entire test suite: