Instructions d'installation pour Pee.


INSTALLATION


Si tu as désarchivé la distribution, saute au point 4.

1. Télécharge l'archive tar pee-x.xx.tar.gz
2. désarchive en utilisant
    gunzip pee-x.xx.tar.gz - | tar -xvf -
3. va dans le répertoire pee-x.xx/
4. perl Makefile.PL
5. make
6. make install (tu as besoin des droits de root)
7. lit la section suivante intitulée "POST-INSTALLATION"



POST-INSTALLATION


Pee peut être utilisé de 2 façons différentes:
1. génération différée
2. directive Action d'Apache


1. Génération différée

Compile les fichiers modèles pour obtenir du code Perl, qui sont alors des
scripts Perl valides.
Ces scripts peuvent être exécutés comme n'importe quel script CGI.

Avantage: rapide (pas de compilation de page à l'exécution)
Désavantage: compilation manuelle


# Descends dans le répertoire 'examples'
> cd examples

# compile le fichier 'cgitest.pet', le fichier de sortie sera nommé
'cgitest.pl'.
> ./compile.pl cgitest.pet

# copie le fichier obtenu (avec le fichier nécessaire cgiutils.pl) dans ton
# répertoire de cgi-bin
> cp cgitest.pl cgiutils.pl <ton_rep_cgi-bin>

# rend le script exécutable
> chmod 755 <ton_rep_cgi-bin>/cgitest.pl

# regarde le dans ton navigateur


2. Directive Action d'Apache

Avec la directive Action d'Apache, tu peux configurer Apache pour qu'il
fasse appel
au moteur de Pee dès qu'il rencontre un fichier qui se termine par ".pet".

Avantage: Pas de re-compilation manuelle quand le fichier modèle est
modifié.
Désavantage: Légèrement moins rapide que la génération différée.


a. Assures-toi d'avoir les lignes suivantes dans ton fichier httpd.conf
   Suivant ton installation / plateforme, les chemins peuvent varier

LoadModule action_module     modules/mod_actions.so
AddModule mod_actions.c


b. Edite le fichier httpd.conf

Ajoutes les lignes suivantes dans ton fichier de config (tu peux les mettre
dans
la section globale, ou simplement les ajouter à la fin du fichier).
On considère que tu utilises le répertoire cgi-bin standard:


AddHandler pet-file pet
Action pet-file /cgi-bin/engine.pl

Cela se résume essentiellement à faire en sorte qu'à chaque fois que
quelqu'un
accède à un fichier ".pet", le script "/cgi-bin/engine.pl" est appelé à la
place.

Mais l'utilisateur ne le voit jamais, car c'est une requête interne
d'Apache.


c. Copie "examples/engine.pl" et "examples/cgiutils.pl" dans ton répertoire
de cgi-bin
et assures toi qu'il est exécutable. En considérant que l'équivalent à l'URL
"/cgi-bin/"
est "/usr/local/apache/cgi-bin/":

cp examples/engine.pl /usr/local/apache/cgi-bin
cp examples/cgiutils.pl /usr/local/apache/cgi-bin
chmod 755 /usr/local/apache/cgi-bin/engine.pl

d. copie "examples/cgitest.pet" dans un répertoire d'où tu souhaiterais
desservir
les modèles PET. On considère que tu utilises "/www/abc":

cp examples/cgitest.pet /www/abc

e. relance Apache

f. ouvre l'URL de "cgitest.pet" dans ton navigateur