diff --git a/docs/scenarios/web.rst b/docs/scenarios/web.rst index 08cc6ab..b267f74 100644 --- a/docs/scenarios/web.rst +++ b/docs/scenarios/web.rst @@ -416,27 +416,49 @@ into the corresponding block in the :file:`base.html` page. Chameleon --------- -`Chameleon `_ is an HTML/XML template engine for Python. It’s designed to generate the document output of a web application, typically HTML markup or XML. +`Chameleon `_ Page Templates are an HTML/XML template +engine implementation of the `Template Attribute Language (TAL) `_, +`TAL Expression Syntax (TALES) `_, +and `Macro Expansion TAL (Metal) ` syntaxes. -The language used is page templates, originally a Zope invention, but available here as a standalone library that you can use in any script or application running Python 2.5 and up (including 3.x and pypy). It comes with a set of new features, too. +Chameleon is available for Python 2.5 and up (including 3.x and pypy), and +is commonly used by the `Pyramid Framework `_. -The template engine compiles templates into Python byte-code and is optimized for speed. For a complex template language, the performance is very good. +Page Templates add within your document structure special element attributes +and text markup. Using a set of simple language constructs, you control the +document flow, element repetition, text replacement and translation. Because +of the attribute-based syntax, unrendered page templates are valid HTML and can +be viewed in a browser and even edited in WYSIWYG editors. This can make +round-trip collaboration with designers and prototyping in a browser easier. -The *page templates* language is used within your document structure -as special element attributes and text markup. Using a set of simple -language constructs, you control the document flow, element -repetition, text replacement and translation. - -.. note:: If you've used page templates in a Zope environment previously, note that Chameleon uses Python as the default expression language (instead of *path* expressions). - -The basic language (known as the *template attribute language* or TAL) -is simple enough to grasp from an example: +The basic TAL language is simple enough to grasp from an example: .. code-block:: html -

Hello, ${'world'}!

+

Hello, World!

+ + + + +
+ +
+ + + + +The `` pattern for text insertion is common +enough that if you do not require strict validity in your unrendered templates, +you can replace it with a more terse and readable syntax that uses the pattern +`${expression}`, as follows: + +.. code-block:: html + + + +

Hello, ${world}!

@@ -447,6 +469,10 @@ is simple enough to grasp from an example: + +But keep in mind that the full `Default Text` +syntax allows for default content in the unrendered template. + .. rubric:: References .. [1] `The mod_python project is now officially dead `_