Index: openacs-4/packages/acs-templating/www/doc/design.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/www/doc/design.html,v diff -u -r1.4 -r1.5 --- openacs-4/packages/acs-templating/www/doc/design.html 16 Jun 2015 08:53:38 -0000 1.4 +++ openacs-4/packages/acs-templating/www/doc/design.html 7 Aug 2017 23:48:02 -0000 1.5 @@ -54,7 +54,7 @@
- A common solution. Programmers and designers + A common solution. Programmers and designers should only have to learn a single system that serves as a UI substrate for all the functionally specific modules used on a site. The system should not make any @@ -66,8 +66,8 @@
- Separation of code (Tcl, Java and SQL) and layout - (HTML). Programmers should be able to specify the + Separation of code (Tcl, Java and SQL) and layout + (HTML). Programmers should be able to specify the data sources and other properties of the template independently of the HTML template used to present the data. HTML authors should be to able to write templates @@ -78,7 +78,7 @@
- Separation of page components. There should be + Separation of page components. There should be provisions so that pages can be broken into discrete components to simplify maintenance of the HTML code and allow for reuse in different contexts. Examples of @@ -90,7 +90,7 @@
- Global control over presentation. There should be + Global control over presentation. There should be a way to define one or more standard master templates used by most pages on a site, so that changes to the overall look and feel of a site can be made in one @@ -99,7 +99,7 @@
- Dynamic selection of presentation style. Given + Dynamic selection of presentation style. Given that the same data may be presented in many different ways, there should be a general mechanism for selecting a specific presentation (including file format, layout, @@ -110,7 +110,7 @@
- Usability. Programmers should be able to develop
+ Usability. Programmers should be able to develop
template specifications using their standard tools for
writing and maintaining code on the server. HTML authors
should be able to access information about template
@@ -324,7 +324,7 @@
-properties
block indicates a set of data
sources that will be made available to the template.
template::set_file
directly or through
the wrapper ad_return_template
.
@@ -344,14 +344,14 @@
Below is a diagram of the typical call stack when processing a page without dependent pages. To conform to the Tcl notion of - what's up and down (as in upvar), the stack grows down. + what's up and down (as in upvar), the stack grows down.
@@ -392,12 +392,12 @@
- Level -Procedure -Arguments +Level +Procedure +Arguments #1 rp_handler #2 rp_serve_abstract_file @@ -363,7 +363,7 @@/web/service/www/page {} - (6) template::adp_prepare #5 +#5 template::code::tcl::/web/service/www/page
- To improve performance, adp pages are compiled into a tcl proc, + To improve performance, adp pages are compiled into a Tcl proc, and thus cached for future use. Tcl pages are also cached in a proc; this saves the trouble of reading and parsing the file the next time. The template system remembers the modification times of the adp and - tcl sources, and re-processes any requested file if the cached + Tcl sources, and re-processes any requested file if the cached version is no longer current. Consequently, this cacheing is transparent in normal use.
@@ -485,7 +485,7 @@Document Revision # | Action Taken, Notes |
---|