Skip to content

Commit d389c37

Browse files
author
Alexander Smishlajev
committed
added links to TAL specifications
1 parent 238d0ab commit d389c37

File tree

1 file changed

+18
-8
lines changed

1 file changed

+18
-8
lines changed

doc/customizing.txt

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
Customising Roundup
33
===================
44

5-
:Version: $Revision: 1.135 $
5+
:Version: $Revision: 1.136 $
66

77
.. This document borrows from the ZopeBook section on ZPT. The original is at:
88
http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
@@ -1284,8 +1284,8 @@ Basic Templating Actions
12841284
~~~~~~~~~~~~~~~~~~~~~~~~
12851285

12861286
Roundup's templates consist of special attributes on the HTML tags.
1287-
These attributes form the Template Attribute Language, or TAL. The basic
1288-
TAL commands are:
1287+
These attributes form the `Template Attribute Language`_, or TAL.
1288+
The basic TAL commands are:
12891289

12901290
**tal:define="variable expression; variable expression; ..."**
12911291
Define a new variable that is local to this tag and its contents. For
@@ -1378,12 +1378,16 @@ making arbitrary blocks of HTML conditional or repeatable (very handy
13781378
for repeating multiple table rows, which would othewise require an
13791379
illegal tag placement to effect the repeat).
13801380

1381+
.. _TAL:
1382+
.. _Template Attribute Language:
1383+
http://dev.zope.org/Wikis/DevSite/Projects/ZPT/TAL%20Specification%201.4
13811384

13821385
Templating Expressions
13831386
~~~~~~~~~~~~~~~~~~~~~~
13841387

1385-
The expressions you may use in the attribute values may be one of the
1386-
following forms:
1388+
Templating Expressions are covered by `Template Attribute Language
1389+
Expression Syntax`_, or TALES. The expressions you may use in the
1390+
attribute values may be one of the following forms:
13871391

13881392
**Path Expressions** - eg. ``item/status/checklist``
13891393
These are object attribute / item accesses. Roughly speaking, the
@@ -1440,6 +1444,9 @@ Modifiers:
14401444
This simply inverts the logical true/false value of another
14411445
expression.
14421446

1447+
.. _TALES:
1448+
.. _Template Attribute Language Expression Syntax:
1449+
http://dev.zope.org/Wikis/DevSite/Projects/ZPT/TALES%20Specification%201.3
14431450

14441451
Template Macros
14451452
~~~~~~~~~~~~~~~
@@ -1450,8 +1457,8 @@ you'll use is the "icing" macro defined in the "page" template.
14501457

14511458
Macros are generated and used inside your templates using special
14521459
attributes similar to the `basic templating actions`_. In this case,
1453-
though, the attributes belong to the Macro Expansion Template Attribute
1454-
Language, or METAL. The macro commands are:
1460+
though, the attributes belong to the `Macro Expansion Template
1461+
Attribute Language`_, or METAL. The macro commands are:
14551462

14561463
**metal:define-macro="macro name"**
14571464
Define that the tag and its contents are now a macro that may be
@@ -1497,10 +1504,13 @@ Language, or METAL. The macro commands are:
14971504
where the tag that fills the slot completely replaces the one defined
14981505
as the slot in the macro.
14991506

1500-
Note that you may not mix METAL and TAL commands on the same tag, but
1507+
Note that you may not mix `METAL`_ and `TAL`_ commands on the same tag, but
15011508
TAL commands may be used freely inside METAL-using tags (so your
15021509
*fill-slots* tags may have all manner of TAL inside them).
15031510

1511+
.. _METAL:
1512+
.. _Macro Expansion Template Attribute Language:
1513+
http://dev.zope.org/Wikis/DevSite/Projects/ZPT/METAL%20Specification%201.0
15041514

15051515
Information available to templates
15061516
----------------------------------

0 commit comments

Comments
 (0)