Contents of /webwml/Perl/README

   
   Generation of the Debian web site involves many Perl scripts, so
   instead of reinvent the wheel again and again, it is wise to invoke
   regular CPAN modules and write our owns.
   
   As we do not have rights to install them outside of the webwml CVS
   tree, and it would be a pain for translators to keep up-to-date
   if we request them to install some Debian packages from unstable, 
   this place contains all the needed stuff.
   
   There are three different hierarchies:
      Webwml/           Modules devoted to www.debian.org generation,
                        contain some w.d.o specific parts
      Local/            Modules of general interest we have written
                        (do not be confused by the CPAN Locale
                        subdirectory)
      Debian/           Infrastructure for the new central 
                        infrastruture of l10n
                        - For more information, please have a 
                        look on:
                        alioth.debian.org/projects/debian-l10n/
                        NOTE: this CVS is not the cvsroot for
                        dl10n. dl10n cvs is hosted on alioth.
                        
      <others>, *.pm    CPAN modules
   
   All modules must be Perl code without need of compilation.

   In order to load these modules, top-level Perl script must
   include this line before loading these modules:
       use lib ($0 =~ m|(.*)/|, $1 or ".") ."/Perl";
   Scripts located elsewhere must be adapted.

   When some WML templates do use these modules too, this line
       <: use lib "$(ENGLISHDIR)/../Perl"; :>
   should be added at the right place.

1
2	Generation of the Debian web site involves many Perl scripts, so
3	instead of reinvent the wheel again and again, it is wise to invoke
4	regular CPAN modules and write our owns.
5
6	As we do not have rights to install them outside of the webwml CVS
7	tree, and it would be a pain for translators to keep up-to-date
8	if we request them to install some Debian packages from unstable,
9	this place contains all the needed stuff.
10
11	There are three different hierarchies:
12	Webwml/ Modules devoted to www.debian.org generation,
13	contain some w.d.o specific parts
14	Local/ Modules of general interest we have written
15	(do not be confused by the CPAN Locale
16	subdirectory)
17	Debian/ Infrastructure for the new central
18	infrastruture of l10n
19	- For more information, please have a
20	look on:
21	alioth.debian.org/projects/debian-l10n/
22	NOTE: this CVS is not the cvsroot for
23	dl10n. dl10n cvs is hosted on alioth.
24
25	<others>, *.pm CPAN modules
26
27	All modules must be Perl code without need of compilation.
28
29	In order to load these modules, top-level Perl script must
30	include this line before loading these modules:
31	use lib ($0 =~ m\|(.*)/\|, $1 or ".") ."/Perl";
32	Scripts located elsewhere must be adapted.
33
34	When some WML templates do use these modules too, this line
35	<: use lib "$(ENGLISHDIR)/../Perl"; :>
36	should be added at the right place.
37