Amaya Templates installation guide - Server side

I - Install template feature on a server

The programs needed to install this4 feature are :

• Apache version >= 1.3
• Perl version >= 5.004
• gcc & make

All files needed for this installation are available in the compressed file templates.tgz downloadable here.

An installation script (./install) is also available.

For a manual install, follow the steps below:

• Install the perl module XML::Parser.

  tar zxvf XML-Parser-2.23.tar.gz

  perl Makefile.PL && make && make install

• Copy the 3 perl scripts createform.pl, sendtemp.pl and xmlparser.pl and the module templateconfig.pm available in the Script directory in the server script directory (/home/http/cgi-bin by default).

  cp Scripts/*.pl /home/http/cgi-bin/

  cp Scripts *.pm /home/http/cgi-bin/

• Copy the index file templates.xml in the server configuration directory (/etc/httpd/conf by default).

  cp templates.xml /etc/httpd/conf

• Create the directory that will contain the templates. By default, this directory is /home/httpd/templates.

  mkdir /home/httpd/templates

• Copy all CSS and template files in that directory.

  cp /templates/* /home/httpd/templates/

• Edit templates.xml previously copied and add the following line in the head of the file.

  <templates dir="/home/httpd/templates/">

  Do not forget the slash after the URL

• Add the following line to the file srm.conf

  Alias /templates/ /home/httpd/templates/

In order to allow direct publication, Apache server must be configured to accept the PUT method.

Here are the following steps to perform this :

• Compile the program put.c (in the PUT directory) and move the binary file in the server script directory :

  gcc -o /home/httpd/cgi-bin/put PUT/put.c

• Add the following line to the Apache configuration file srm.conf

  Script PUT /home/httpd/cgi-bin/put

For more information about the put feature, follow this link

Publishing Pages with PUT - http://www.apacheweek.com/features/put

The next step consist in allowing the server to manage publication rights.

• Add the following line to the Apache configuration file access.conf

  Include /etc/httpd/conf/templates.conf

• Create the file templates.conf in the Apache configuration directory

  touch /etc/httpd/conf/templates.conf

• Insert the following lines in the file templates.conf. Modify these lines to fit your configuration.

  <FilesMatch sendtemp.pl>

  AuthName templates

  AuthType Basic

  AuthUserFile /etc/httpd/conf/passwd

  AuthGroupFile /etc/httpd/conf/groups

  Options ExecCGI

  order allow,deny allow from all

  require group public

  </FilesMatch>

• Add one or more templates users (refer to II - Add a template user )
• Start or restart Apache server

II - Add a template user

To add a user allowed to use direct publication on the server, follow the steps below :

• Define a user password. This operation can be carried out with the following command

  htpasswd password_file user_name

  i.e : htpasswd passwd dupont

  By default, the password file is /etc/http/conf/passwd. If the password file does not exist yet, add the prefix -c to the previous command :

  i.e : htpasswd -c passwd dupont

• Create the file htuserdir in the apache configuration directory.

  This file realize the correspondence between the user login and his server publication directory. So add the line like below

  dupont:/Jean_Dupont/

  "dupont" is the login and "Jean_Dupont" is the relative address of the publication directory. The absolute address is /home/httpd/html/Jean_Dupont.

• Create the user publication directory.

  mkdir /home/httpd/html/Jean_Dupont

• Modify the groups configuration file (/etc/httpd/conf/groups) and inert the new user.
• Add the following lines to the file templates.conf previously created.

  <Directory /home/httpd/html/Jean_Dupont>

  AuthName templates

  AuthType Basic

  AuthUserFile /etc/httpd/conf/passwd

  AuthGroupFile /etc/httpd/conf/groups

  Options Includes FollowSymLinks

  AllowOverride None

  order allow,deny allow from all

  <Limit PUT>

  require user dupont

  </Limit>

  </Directory>

  The authentification name AuthName must be the same as the one in the <FilesMatch sendtemp.pl> section previously typed.

III - Addition of templates and stylesheets

To add templates and CSS, copy the associated files in the templates directory (/home/httpd/templates/ par défaut)and modify the file templates.xml as below :

• For each added template, add the following lines at the end of the file templates.xml.

  <template file="filename.html">

  <name>template_name</name>

  <description> A description sentence of the template </description>

  </template>

• For each added stylesheet, add the following lines at the end of the file templates.xml.

  <stylesheet file="filename.css">

  <name>Stylesheet_name</name>

  <description> A description sentence of the stylesheet </description>

  </stylesheet>

New templates and stylesheets will automatically be recognized and displayed the next time you use the template fonctionality.

VI - Use a template server with Amaya

The Amaya client browser/editor (version >= 2.1) must be told which server provides templates.

Insert in the configuration file thot.rc the following line :

URL_TEMPLATE=http://server_name/cgi-bin/createform.pl