Changes between Version 30 and Version 31 of MarkupTemplates

Timestamp:

Aug 20, 2006, 1:58:36 PM (18 years ago)

Author:

cmlenz

Comment:

Explain loader usage in Python API intro

MarkupTemplates

@@ -3 +3 @@
 The most important feature provided by the Markup package is a template engine.
 
-Templates are XML files of some kind (such as XHTML) that include ''[MarkupTemplates#TemplateDirectives processing directives]'' (elements or attributes identified by a separate namespace) that affect how the template is rendered, and ''[MarkupTemplates#TemplateExpressions template expressions]'' that are dynamically substituted by variable data.
+Templates are XML files of some kind (such as XHTML) that include ''[MarkupTemplates#Directives processing directives]'' (elements or attributes identified by a separate namespace) that affect how the template is rendered, and ''[MarkupTemplates#Expressions template expressions]'' that are dynamically substituted by variable data.
 
 This documentation is a work in progress and as of yet rather incomplete.
@@ -35 +35 @@
 #!xml
 <h1>Hello, world!</h1>
+}}}
+
+However, if you want [MarkupTemplates#Includes includes] to work, you should attain the template instance through a `TemplateLoader`, and load the template from a file:
+
+{{{
+#!python
+from markup.template import TemplateLoader
+
+loader = TemplateLoader([templates_dir])
+tmpl = loader.load('test.html')
+stream = tmpl.generate(title='Hello, world!')
+print stream.render('xhtml')
 }}}
 
@@ -390 +402 @@
 {{{
 #!xml
-<div xmlns:py="http://markup.edgewall.org/">
+<div>
   <span py:with="y=7; z=x+10">$x $y $z</span>
 </div>
@@ -408 +420 @@
 {{{
 #!xml
-<div xmlns:py="http://markup.edgewall.org/">
+<div>
   <py:with vars="y=7; z=x+10">$x $y $z</py:with>
 </div>