Previous Chapter | Up | Contents



1. It is also possible to define additional syntaxes, although the mechanism for doing this is not currently documented. For example, a syntax that is similar to the syntax used by active server pages has been developed.

2. Actually, all attributes have values. Certain attributes, like the capitalize attribute, have default values which are set when a value is not provided within the tag. The only case in which a value must be provided for this type of attribute is when the attribute is the first attribute in the tag. Without a value, the attribute would be confused with a name attribute value. For attributes like capitalize, a value of "yes", "on" or 1 is usually provided, as in: <dtml-var capitalize=1 name=id>. The capitalize attribute is an example of a flag. The presence of a flag typically indicates that some normally disabled option should be enabled, thus the values of "yes", "on" or 1.

3. In this context, "function" refers any "callable" object. Examples of an callable objects include Zope Database Methods and Zope Network Clients, DTML Methods.

4. For a detailed description of Python syntax, see the Python documentation at

5. A method is like a function except, a method is an attribute of an object and can use the object's data in computation.

6. Zope defines a large number of attributes that are used by Zope itself. Many of these will become part of an official Zope applications programming interface and will be documented in a forthcoming "Zope API Guide".

7. ZopeTime is a function that returns a date-time object giving the current time.

8. Dictionaries are objects that support looking of data by name
(e.g. REQUEST.cookies['CUST_ID'] to look up a cookie named CUST_ID ). Dictionaries have has_key methods for checking whether a dictionary contains a value (e.g. REQUEST.cookies.has_key('CUST_ID') ) and methods keys , values , and items , for updating lists of dictionary keys, values, and key-value pairs
(e.g. REQUEST.cookies.keys() to obtain a list of cookie names).

9. The special variable, _, is an exception to this rule.

10. Python 1.4 users must use the ni module to enable packages. DocumentTemplate may also be used as a collection of modules, rather than as a package by copying all of the DocumentTemplate modules except the __init__ module to a directory in the Python path.

11. The C programming language.

12. All Zope objects are either true or false. Numeric values are true if they are non-zero and false if they are zero. Objects that are sequences of objects, like search results, are true if the sequences are non-empty and false otherwise. Most other objects are true.

13. nnn is the name of an attribute or key. For example, to get the mean salary in a collection of employees, each with the attribute salary, mean-salary would be used.

14. These are relative URL's as generated by the DTML. The document_id for this example is r36.

15. A header line is a line that begins with a header name, followed by a colon, a space, and a value. Header lines may have continuation lines that begin with one or more spaces or tabs. All of the header lines, with continuation lines, if any, must start at the beginning of the text following the dtml-sendmail tag and must be separated from the message body by at least one blank line.

16. The dtml-mime tag can also be used in http multipart responses.

Previous Chapter | Up | Contents