Table of Contents

• List of Tables vii
• Introduction 1
• General Information 3
• DTML Tag Syntax 3
• Server Side Include Format Syntax 5
• Alternate Python String Format Syntax 5
• Common Tag Attributes 7

The name attribute 7

The expr attribute 7

Expression syntax 7

Variable lookup 8

The special namespace variable, _ 8

• Name Lookup 15
• Access Control 18
• Using Document Templates from Python 21

Creating document templates 21

Using document templates 22

Using document templates with ZPublisher 22

• The dtml-var Tag 23
• Custom, Special, C, and Empty Formats 23
• Null Values 24
• Truncation 25
• A dtml-var Tag Example, the Default Document Source 25
• Conditional Insertion, the dtml-if and dtml-unless Tags 27
• Iterative Insertion, the dtml-in Tag 29
• The dtml-else Tag as an Intermediate Tag in the dtml-in Tag 29
• Variables Defined by the dtml-in Tag 31
• Summary Statistics 33
• Grouping Variables 33
• Batch Processing 33

Orphan rows 35

Overlapping batches 37

Showing row number and row data in previous and next batch hyperlinks. 37

Showing information about multiple batches 39

• Displaying Objects with the dtml-with Tag 41
• Using the only Attribute to Limit the Namespace 41
• Multiple assignments with the dtml-let Tag 42
• Evaluating Names or Expressions without Generating Text Using the dtml-call Tag 43
• Reporting Errors with the dtml-raise Tag 45
• Exception Handling with the dtml-try Tag 46
• The dtml-try tag optional dtml-else block 47
• The dtml-try tag optional dtml-finally block 47
• Excluding Source Text with the dtml-comment Tag 48
• Returning Data using the dtml-return tag 49
• Displaying Information Hierarchically: the dtml-tree tag 50
• Sending Mail: the dtml-sendmail tag 54
• Sending Attachments with the dtml-mime Tag 56
• Appendix A, Date-time data 57