Changes between Version 1 and Version 2 of WorkInProgress/PluggableDirectivesLibraries/TextTemplates

Timestamp:

Jun 11, 2010, 9:11:09 PM (14 years ago)

Author:

Carsten Klein <carsten.klein@…>

Comment:

--

WorkInProgress/PluggableDirectivesLibraries/TextTemplates

@@ -18 +18 @@
 embedding Python code in templates.
 
-.. note:: Actually, Genshi currently has two different syntaxes for text
-          templates languages: One implemented by the class ``OldTextTemplate``
-          and another implemented by ``NewTextTemplate``. This documentation
-          concentrates on the latter, which is planned to completely replace the
-          older syntax. The older syntax is briefly described under legacy_.
-
 .. _django: http://www.djangoproject.com/
 
@@ -47 +41 @@
 effectively treated as a comment.
 
+An exception to that rule is the {% namespace %} directive.
+Namespace declarations are considered one line statements that will enhance
+text templates by provision of additional directives defined in so-called
+directive libraries.
+
 If you want to include a literal delimiter in the output, you need to escape it
 by prepending a backslash character (``\``).
+
+.. Note: Directives libraries are similar to JSP tag libraries and are a new feature
+         of Genshi.
+
+
+Namespaces
+==========
+
+.. _`namespace`:
+
+``{% namespace %}``
+-------------------
+
+Declares a new namespace for use with Genshi directives. Individual directives
+being used in the template will have to be prefixed by the namespace alias 
+defined as part of the namespace declaration.
+
+The default namespace is "http://genshi.edgewall.org/". All non prefixed 
+directives will be looked up from that namespace. If a prefix was defined,
+and there is also a valid namespace declaration for it, then that namespace
+will be used instead for looking up the directive.
+
+.. code-block:: genshitext
+ 
+  {% namespace "http://genshi.edgewall.org/" %}
+  {% namespace py "http://genshi.edgewall.org/" %}
+  {% namespace foo "http://foo.example.org/" %}
+
+  # use if directive from default namespace
+
+  {% if ... %}
+
+  # use bar directive from foo namespace
+
+  {% foo:bar ... %}
+
+  # use if directive (from default namespace)
+
+  {% py:if ... %}
+
+More information on directives libraries can be found
+under `Pluggable Directives Libraries <directives_libraries.html>`_.
+