Index: openacs-4/packages/acs-templating/www/doc/install.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/www/doc/install.html,v diff -u -r1.2 -r1.2.4.1 --- openacs-4/packages/acs-templating/www/doc/install.html 12 Apr 2013 16:12:57 -0000 1.2 +++ openacs-4/packages/acs-templating/www/doc/install.html 22 Jun 2016 07:48:43 -0000 1.2.4.1 @@ -4,7 +4,7 @@

Installation

- Templating System + Templating System

The templating system may be used alone or in conjunction with @@ -36,10 +36,10 @@

The distribution consists of four subdirectories:

demo: A set of sample templates and supporting files. -
doc: Documentation and tutorials. -
tcl: The Tcl module. -
resources: Sitewide style templates for forms and +
demo: A set of sample templates and supporting files. +
doc: Documentation and tutorials. +
tcl: The Tcl module. +
resources: Sitewide style templates for forms and error messages and associated assets.

@@ -52,10 +52,10 @@

The templating system code is a Tcl-only module for AOLserver. For AOLserver to load the module source code, you must move, copy or -symlink the tcl directory in the templating system +symlink the tcl directory in the templating system distribution to the private Tcl library of your AOLserver installation -(as indicated by the Library parameter in the -ns/server/myserver/tcl section of the AOLserver configuration +(as indicated by the Library parameter in the +ns/server/myserver/tcl section of the AOLserver configuration file):

$ cd /web/myserver/tcl
@@ -69,16 +69,16 @@
 [ns/server/myserver/modules]
 nssock=nssock.so
 nslog=nslog.so
-ats=Tcl
+ats=Tcl

or if you are using the new configuration file format:

ns_section "ns/server/${server}/modules"
 ns_param   nssock          nssock.so
 ns_param   nslog           nslog.so
-ns_param   ats          Tcl

+ns_param ats Tcl -

Note that you should replace ats with whatever you named +

Note that you should replace ats with whatever you named the directory or symlink for the templating code within your private Tcl library.

@@ -96,41 +96,41 @@

The templating system recognizes two optional parameters in the AOLserver configuration file in the -ns/server/yourserver/ats section:

+ns/server/yourserver/ats section:

- +

- + +Oracle. - - + - - + - - + +$::acs::pageroot/ats/resources.

`DatabaseInterface`	`DatabaseInterface`	Specifies the set of procedures to use for accessing a relational database from the templating system. Two interfaces are supplied with -the system: `oracle` (uses the `ns_ora` API in conjunction -with the AOLserver Oracle driver) and `generic` (uses the `ns_db` +the system: `oracle` (uses the `ns_ora` API in conjunction +with the AOLserver Oracle driver) and `generic` (uses the `ns_db` API in conjunction with any AOLserver RDBMS driver). The default is -`Oracle`.
`ShowCompiledTemplatesP`	Enables a filter on the `cmp` extension so that the compiled +	`ShowCompiledTemplatesP`	Enables a filter on the `cmp` extension so that the compiled Tcl code for any template may be viewed in a browser for debugging purposes. The default is 0 (disabled).
`ShowDataDictionariesP`	Enables a filter on the `dat` extension so that documentation +	`ShowDataDictionariesP`	Enables a filter on the `dat` extension so that documentation directives in Tcl scripts may be extracted and viewed in a browser. The default is 1 (enabled).
`ResourcePath`	Specifies the absolute path to the system `templates` directory, +	`ResourcePath`	Specifies the absolute path to the system `templates` directory, containing sitewide styles for forms, system messages, etc. Defaults to -`$::acs::pageroot/ats/resources`.

Testing the System

To test the system, run the script demo/demo.sql to create +

To test the system, run the script demo/demo.sql to create and populate a simple table in your database.

Save the configuration file and restart the server. Use the samples