[Zope3-checkins] SVN: Zope3/trunk/src/zope/pagetemplate/architecture.txt Added a high-level description of how things fit together.

[Jim Fulton]

Log message for revision 25969:
Added a high-level description of how things fit together.



-=-
Added: Zope3/trunk/src/zope/pagetemplate/architecture.txt
===================================================================
--- Zope3/trunk/src/zope/pagetemplate/architecture.txt	2004-06-24 15:12:01 UTC (rev 25968)
+++ Zope3/trunk/src/zope/pagetemplate/architecture.txt	2004-06-24 21:27:42 UTC (rev 25969)
@@ -0,0 +1,29 @@
+ZPT Architecture
+================
+
+There are a number of major components that make up the page-template
+architecture: 
+
+  - The TAL compiler and interpreter.  This is responsible for
+    compiling source files and for executing compiled templates. See
+    the zope.tal package for more information.
+
+  - An expression engine is responsible for compiling expressions and
+    for creating expression execution contexts.  It is common for
+    applications to override expression engines to provide custom
+    expression support or to change the way expressions are
+    implemented. 
+
+    Expression contexts support execution of expressions and provide
+    APIs for setting up variable scopes and setting variables.
+    The expressions contexts are passed to the TAL interpreter at
+    execution time.
+    
+    The most commonly used expression implementation is that found in
+    zope.tales.
+
+  - Page templates tie everything together. The assemble an expression
+    engine with the TAL interpreter and orchestrate management of
+    source and compiled template data.  See `interfaces.py`.
+
+  


Property changes on: Zope3/trunk/src/zope/pagetemplate/architecture.txt
___________________________________________________________________
Name: svn:eol-style
   + native