Contents of /trunk/pts/www/README

This is the code of the PTS web interface.

Principle :
-----------

The system gathers data in incoming from various sources (this is done by
bin/update_incoming.sh). Those data are merged in a set of XML file in the
base directory (this is done by bin/*_to_xml.py). Those XML files are then
transformed in HTML files (put in the web directory) with xsltproc and the
xsl/pts.xsl stylesheet.

Dependencies :
--------------

xsltproc, mhonarc, python2.2, python2.2-xml, devscripts (for uscan)

Installation :
--------------

The "web" directory should be set as DocumentRoot of your VirtualHost.

Example of apache config (adapt it to your case)
<VirtualHost master>
ServerName packages.qa.debian.org
DocumentRoot /org/packages.qa.debian.org/www/web
ErrorLog /var/log/apache/packages.qa.debian.org-error.log
CustomLog /var/log/apache/packages.qa.debian.org-access.log combined

ScriptAlias /cgi-bin /org/packages.qa.debian.org/www/cgi-bin

RewriteEngine on
RewriteRule ^/$ /common/index.html [L,R]
RewriteRule ^/lib([^/])([^/]+)$ /lib$1/lib$1$2.html [L,R]
RewriteRule ^/([^/])([^/]+)$ /$1/$1$2.html [L,R]
RewriteCond %{QUERY_STRING} ^src=lib(.)(.*)$
RewriteRule ^/common/index.html$ /lib%1/lib%1%2.html? [L,R,NE]
RewriteCond %{QUERY_STRING} ^src=(.)(.*)$
RewriteRule ^/common/index.html$ /%1/%1%2.html? [L,R,NE]
</VirtualHost>

1	hertzog	344	This is the code of the PTS web interface.
2
3			Principle :
4			-----------
5
6			The system gathers data in incoming from various sources (this is done by
7			bin/update_incoming.sh). Those data are merged in a set of XML file in the
8			base directory (this is done by bin/*_to_xml.py). Those XML files are then
9			transformed in HTML files (put in the web directory) with xsltproc and the
10			xsl/pts.xsl stylesheet.
11
12			Dependencies :
13			--------------
14
15	hertzog	692	xsltproc, mhonarc, python2.2, python2.2-xml, devscripts (for uscan)
16	hertzog	344
17			Installation :
18			--------------
19
20			The "web" directory should be set as DocumentRoot of your VirtualHost.
21
22			Example of apache config (adapt it to your case)
23			<VirtualHost master>
24			ServerName packages.qa.debian.org
25			DocumentRoot /org/packages.qa.debian.org/www/web
26	hertzog	401	ErrorLog /var/log/apache/packages.qa.debian.org-error.log
27			CustomLog /var/log/apache/packages.qa.debian.org-access.log combined
28
29			ScriptAlias /cgi-bin /org/packages.qa.debian.org/www/cgi-bin
30
31	hertzog	344	RewriteEngine on
32			RewriteRule ^/$ /common/index.html [L,R]
33			RewriteRule ^/lib([^/])([^/]+)$ /lib$1/lib$1$2.html [L,R]
34			RewriteRule ^/([^/])([^/]+)$ /$1/$1$2.html [L,R]
35	hertzog	401	RewriteCond %{QUERY_STRING} ^src=lib(.)(.*)$
36			RewriteRule ^/common/index.html$ /lib%1/lib%1%2.html? [L,R,NE]
37			RewriteCond %{QUERY_STRING} ^src=(.)(.*)$
38			RewriteRule ^/common/index.html$ /%1/%1%2.html? [L,R,NE]
39	hertzog	344	</VirtualHost>
40
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision