NAME

Template::LiquidX::Tag::Include - Include another file (Functioning Custom Tag Example)

Synopsis

            

              
              
{% include 'comments.inc' %}
            
          

Description

This is a demonstration of extending Template::Liquid.

If you find yourself using the same snippet of code or text in several templates, you may consider making the snippet an include.

You include static filenames...

            

              
              
use Template::Liquid;
use Template::LiquidX::Tag::Include;
Template::Liquid->parse("{%include 'my.inc'%}")->render();
            
          

...or 'dynamic' filenames (for example, based on a variable)...

            

              
              
use Template::Liquid;
use Template::LiquidX::Tag::Include;
Template::Liquid->parse('{%include inc%}')->render(inc => 'my.inc');
            
          

Notes

The default directory searched for includes is ./_includes/ but this can be changed in the include statement...

            

              
              
use Template::LiquidX::Tag::Include '~/my_site/templates/includes';
            
          

This mimics Jekyll's include statement and was a 15m hack so it's subject to change ...and may be completly broken.

See Also

Liquid for Designers: http://wiki.github.com/tobi/liquid/liquid-for-designers

Template::Liquid's section on custom tags.

Author

Sanko Robinson <sanko@cpan.org> - http://sankorobinson.com/

License and Legal

Copyright (C) 2009-2016 by Sanko Robinson <sanko@cpan.org>

This program is free software; you can redistribute it and/or modify it under the terms of The Artistic License 2.0. See the LICENSE file included with this distribution or http://www.perlfoundation.org/artistic_license_2_0. For clarification, see http://www.perlfoundation.org/artistic_2_0_notes.

When separated from the distribution, all original POD documentation is covered by the Creative Commons Attribution-Share Alike 3.0 License. See http://creativecommons.org/licenses/by-sa/3.0/us/legalcode. For clarification, see http://creativecommons.org/licenses/by-sa/3.0/us/.