Free Trial

Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.

Share this Page URL

4. Template Directives - Pg. 137

Chapter 4 CHAPTER 4 Template Directives Templates consist of a combination of fixed text and template directives. The tem- plate directives are recognized by the Template Toolkit and are expanded in a pro- cessor's output. In this chapter, we will take a close look at all of the directives that the Template Toolkit provides. We've already seen examples of many of them in pre- vious chapters, but now we'll go back and fill in all of the details. The Template Toolkit has directives for common presentation tasks. There are direc- tives for accessing and setting variables, loading and using both external and local templates, repetition, conditional processing, flow control, and exception handling. Directives are also provided to define macros and access template metadata. If that's not enough for you, you can extend the functionality of the Template Toolkit using filters, plugins, or even inline Perl code. Accessing Variables The Template Toolkit allows you to define variables in your templates. In this sec- tion, we will look at the various directives that the Template Toolkit provides for manipulating template variables. GET The GET directive retrieves and outputs the value of the named variable: [% GET foo %] The GET keyword is optional. A variable can be specified in a directive tag by itself: [% foo %] The variable name can have an unlimited number of elements, each separated by a . (dot). Each element can have arguments specified within parentheses: [% foo %] [% bar.baz %] [% biz.baz(10) %] 137 This is the Title of the Book, eMatter Edition Copyright © 2013 O'Reilly & Associates, Inc. All rights reserved.