Index: openacs-4/packages/acs-templating/www/doc/tagref/include.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/www/doc/tagref/include.html,v diff -u -r1.5 -r1.5.2.1 --- openacs-4/packages/acs-templating/www/doc/tagref/include.html 27 Oct 2014 16:40:25 -0000 1.5 +++ openacs-4/packages/acs-templating/www/doc/tagref/include.html 25 Aug 2015 17:59:29 -0000 1.5.2.1 @@ -20,11 +20,11 @@
<include src="subtemplate" attribute="value" ...>+
<include src="subtemplate" attribute="value" ...>or -
<include src="/packages/packagename/www/lib/subtemplate" attribute="value" ...>+
<include src="/packages/packagename/www/lib/subtemplate" attribute="value" ...>
<include src="subtemplate" source_id="@source_id@" ...>+
<include src="subtemplate" source_id="@source_id@" ...>- Note that passing an html string to a subtemplate via
@var@
- will result in passing an html-escaped string. To prevent this, use
- @var;noquote@
when passing html to subtemplates.
+ Note that passing an html string to a subtemplate via
+ @var@
will result in passing an html-escaped and
+ internationalized string. To prevent this, use
+ @var;literal@
when passing html to subtemplates.
Alternatively the variable can by passed by name (similar to
call-by-reference) causing a variable alias to be created in
the scope of the subtemplate. This variant is necessary for
e.g. passing a Tcl array like a templating datasource. To pass
e.g. users
by reference, use this notation:
- <include src="subtemplate" &persons="users" ...>+
<include src="subtemplate" &persons="users" ...>This is particularly useful for passing onerow and multirow data sourced. Note that in this case, if the subtemplate modifies the value this will affect the includer. When the datasource in the included page has the same name (
&users="users"
), you
- can use the shorthand &="users"
.
+ can use the shorthand &="users"
.