
=======================================================
Rsum de la procdure pour crer une instance de DENIF
sur un autre site que denif.ens-lyon.fr
=======================================================

1) Copier conf-local-template.inc.php vers conf-local.inc.php.
diter le fichier copi en suivant les commentaires.

2) Copier conf-secondary-template.inc.php vers conf-secondary.inc.php.
diter le fichier copi en suivant les commentaires.

3) Si le code source du site est modifi, crer une archive pour les sources modifies et renseigner la variable de configuration sSecondarySourceDownloadLink.

4) Si le site n'est pas hberg  la racine d'un domaine ou sous-domaine, mentionner le rpertoire racine dans robots.txt.

5) Avant de gnrer le fichier sitemaps (facultatif), mettre  jour les fichiers de configuration de src\sitemap.


====================
Configuration locale
====================

La configuration locale d'une installation de DENIF est stocke dans conf-local.inc.php.
Ce fichier contient le mot de passe de la base de donnes SQL, et ne doit donc pas tre enregistr par SVN.

La configuration locale permet aussi de forcer la valeur de n'importe quel paramtre. En particulier, dfinir bLocal  true pour faire tourner une version de dveloppement. (Entre autres, cela dsactive la collecte de statistiques par Google Analytics pour acclrer le chargement des pages.)

Un modle de configuration est fourni par conf-local-template.inc.php. Copier ce fichier sous le nom conf-local.inc.php, et modifier les valeurs tel qu'expliqu dans les commentaires.


========================
Configuration d'instance
========================

Le site DENIF principal (http://denif.ens-lyon.fr) est appel instance primaire.
Les autres sites qui utilisent le moteur de DENIF sous un autre nom sont appels instances secondaires.

Les diffrences entre instances primaire et secondaire sont principalement d'ordre cosmtique :
- Nom, acronyme, adresse email : les instances secondaires ne peuvent pas s'appeler DENIF ou rutiliser l'adresse email de DENIF.
- Pied de page : les instances secondaires contiennent un lien vers l'instance primaire.
- Page d'accueil : la description du site doit tre adapte  chaque instance (public vis, contenu). De plus, les instances secondaires peuvent mentionner des auteurs supplmentaires  ceux de DENIF.
- Code source : une instance secondaire qui modifie le code source de DENIF doit le redistribuer, car DENIF est sous licence GPL. Le paramtre sSecondarySourceDownloadLink permet de spcifier l'emplacement des sources d'une instance secondaire.

Si conf-secondary.inc.php n'existe pas, DENIF utilise conf-primary.inc.php pour se configurer en mode primaire. Il s'agit du mode par dfaut.

Si conf-secondary.inc.php existe, DENIF ignore conf-primary.inc.php et utilise les paramtres dfinis par conf-secondary.inc.php. Un modle de configuration est fourni par secondary-template.inc.php. Pour passer en mode instance secondaire, copier ce fichier sous le nom conf-secondary.inc.php, et modifier les valeurs tel qu'expliqu dans les commentaires.


===========
URL du site
===========

Le code PHP utilise des URLs relatives. Le site peut tre hberg dans un domaine diffrent sans changement de code. Exceptions :

- robots.txt. L'URL /zip.php doit tre exclue, afin que les robots ne tlchargent pas tous les documents, consommant ainsi de la bande passante. Le fichier robots.txt par dfaut suppose que le site est hberg  la racine d'un domaine.

- sitemaps. Le protocole sitemaps impose que les URLs soient absolues. Avant de gnrer des sitemaps sur une instance secondaire, ne pas oublier de 1) modifier la variable de configuration sWebDataPath, et 2) mettre  jour les fichiers de configuration de src\sitemap.
