Index: openacs-4/packages/acs-templating/www/doc/install.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/www/doc/install.adp,v diff -u -r1.2.2.2 -r1.2.2.3 --- openacs-4/packages/acs-templating/www/doc/install.adp 9 Jun 2016 13:03:12 -0000 1.2.2.2 +++ openacs-4/packages/acs-templating/www/doc/install.adp 22 Jun 2016 07:48:43 -0000 1.2.2.3 @@ -26,11 +26,11 @@

The distribution consists of four subdirectories:

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

You can also untar (or check out) the distribution somewhere @@ -40,10 +40,10 @@

Installing the Tcl module

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 +or 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 +installation (as indicated by the Library parameter in the +ns/server/myserver/tcl section of the AOLserver configuration file):

 $ cd /web/myserver/tcl
@@ -66,7 +66,7 @@
 ns_param   nslog           nslog.so
 ns_param   ats          Tcl
 
-

Note that you should replace ats with whatever you +

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

You will also need to ensure that the "fancy" ADP parser is the @@ -82,31 +82,31 @@

Optional Configuration

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

+ns/server/yourserver/ats section:

- +generic (uses the ns_db API in conjunction with +any AOLserver RDBMS driver). The default is Oracle. - - - +etc. Defaults to $::acs::pageroot/ats/resources.
DatabaseInterfaceSpecifies the set of procedures to use for accessing a +DatabaseInterfaceSpecifies 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 +supplied with 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.
ShowCompiledTemplatesPEnables a filter on the cmp extension so that the +ShowCompiledTemplatesPEnables 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).
ShowDataDictionariesPEnables a filter on the dat extension so that +ShowDataDictionariesPEnables 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).
ResourcePathSpecifies the absolute path to the system templates +ResourcePathSpecifies 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 +

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 included in the distribution to test whether the system is