2. Installation Procedure

Ok, so you got the files from sourceforge now what? The installation procedure is really simple. We assume you have already installed apache and mod_python (http://httpd.apache.org and http://www.modpython.org ). We personally recommend version 2.0.x of apache and version 3.1.x of mod_python. We know mod_python 3.1 branch is still in development but it really rocks. You can also use apache 1.3.x and mod_python 3.0.x. As of python we *highly* recommend python 2.3 but the minimum is 2.2. To enable the XSLT and ZPT view technologies you will need the following:

ZPT, you will need the zpt package from http://zpt.sourceforge.net

XSLT, PyWork uses C libraries to process XSL Transforms. More specifically it uses "libxml2" and "libxslt" (the default GNOME xml libraries, you would normally have them if you already have GNOME installed). They come for a lot of platforms and can be downloaded from http://xmlsoft.org. From there you will need to get first "libxml2" and "libxslt". Then you will need to install the python bindings for these 2 libraries found in http://xmlsoft.org/python.html and http://xmlsoft.org/XSLT/python.html respectively.

The first thing you need is to unpack the tarball, enter the directory and execute:

	[root@localhost]$ python setup.py install

This will build and install PyWork in your python distribution. Then to bind PyWork to mod_python you will need to add this to your apache configuration:

	AddHandler python-program .action
	PythonHandler pywork.pywork
	DirectoryIndex index.action

	#recommended for a production site
	#PythonDebug Off
	#PythonAutoReload Off
	#PythonOptimize On

	#recommended for a development enviroment
	#PythonDebug On
	#PythonAutoReload On

Then there are two ways to bind your site to PyWork:

1 Set a global env var called PYWORK that will point to the dir containing your conf files. With this you get just one copy of the configuration files. It will fit for most users. The general approach with PyWork is to configure all your sites with the same configuration. We will see below how easy it is.

2 Set "PythonOption" directive PYWORK in you conf/virtual host/.htaccess of apache. like:

	PythonOption PYWORK /path/to/conf

With this you can customize the configuration physically for every site or dir. With a penalty: as PyWork works inside the Python interpreter you either define a single interpreter per site (with the PythonIntepreter directive) or leave the "reload" section to "1", so PyWork can read the files on every request

Once you have chosen the right option for you and a good place for your conf files you will like to go to the next section "Configuration"

See About this document... for information on suggesting changes.