====== Configurer son site Greenstone ====== Dans Greenstone, deux fichiers de configuration sont utilisés pour configurer divers aspects du site Greenstone. Il s'agit du fichier de configuration «principal» main.cfg, qui se trouve dans GSDLHOME/etc, et du fichier de configuration «de site» gsdlsite.cfg, qui se trouve dans GSDLHOME/cgi-bin. Ces fichiers contrôlent tous deux des aspects spécifiques de la configuration du site, et tous deux peuvent être visualisés depuis la page d'administration de Greenstone. ===== Fichier de configuration principal ===== Le fichier de configuration principal main.cfg sert à configurer le réceptionniste -- la partie de Greenstone qui présente les requêtes et affiche les pages. Vous pouvez tout contrôler, des langues que l'interface peut utiliser aux journaux qui seront conservés. ==== Maintenance du site et journalisation ==== Les lignes du fichier de configuration dictent la manière dont votre site Greenstone sera maintenu, quelles fonctionnalités il offrira, quels événements seront journalisés, et quelles notifications seront faites au mainteneur. La table  détaille certaines des options disponibles; les options restantes sont décrites dans les sections suivantes. |< - 132 151 246 >| | | **Valeur** | **But** | | //maintainer// | vide ou une adresse de courrier électronique | Adresse de courrier électronique du mainteneur de site à utiliser pour certaines notifications. Si elle est vide, les événements de courrier électronique sont désactivés | | //MailServer// | vide ou un nom de serveur | Serveur de courrier électronique sortant pour le site. Si elle est vide, c'est//mail.domaine-du-mainteneur//qui sera utilisé (si par exemple le mainteneur est//aide@exemple.com//, la valeur par défaut sera// mail.exemple.com //). Si ceci n'aboutit pas à un serveur SMTP valide, les événements de courrier électronique ne fonctionneront pas | | //status// | //enabled//(activée) ou//disabled//(désactivée) | Détermine si la page de//Maintenance et administration//doit être rendue disponible | | //collector// | //enabled//(activée) ou//disabled//(désactivée) | Détermine si l'outil «Collector» de construction de collection pour l'utilisateur final est disponible | | //logcgiargs// | //true//(vraie) ou//false//(fausse) | Si la valeur est//true//, , un journal d'utilisation est conservé dans le fichier //usage.txt//. | | //usecookies// | //true//(vraie) ou//false//(fausse) | Si la valeur est//true//,des informations relatives aux utilisateurs du site sont collectées (à l'aide de//cookies//) et consignées dans le journal//usage.txt//(ceci ne fonctionne que si l'option//logcgiargs//a la valeur//true//) | | //LogDateFormat// | //LocalTime//(heure locale) ou
//UTCTime//(heure du temps universel—GMT) ou
//Absolute//(heure absolue) | Format dans lequel consigner les dates et les heures dans les journaux.//LocalTime//produit le format «Thu Dec 07 12:34 NZDT 2000»,//UTCTime//est le même format mais en temps universel, et//absolute//est un entier représentant le nombre de secondes écoulées depuis «00:00:00 01/01/1970 GMT» | | //LogEvents// | //AllEvents//(tous les événements) ou
//CollectorEvents//(événements du Collector) ou
//disabled//(désactivée) | Consigne certains événements dans le journal//events.txt//.//AllEvents//consigne tous les événements de Greenstone,//CollectorEvents//ne consigne que les événements liés au Collector, et//disabled//ne consigne aucun événement | | //EmailEvents// | //enabled//(activée) ou//disabled//(désactivée) | Envoie un courrier électronique au mainteneur (s'il y en a un—voir l'option maintainer) à chaque fois qu'un événement se produit | | //EmailUserEvents// | //enabled//(activée) ou//disabled//(désactivée) | Envoie un courrier électronique à l'utilisateur lors de certains événements—tels que la fin de la construction d'une collection par le Collector | | //macrofiles// | liste de noms de fichiers de macros | Détermine quelles macros sont disponibles pour le logiciel d'interface utilisateur de Greenstone | ==== Support des langues ==== Le fichier de configuration main.cfg contient deux types d'entrées qui affectent la gestion des différentes langues. Elles déterminent quelles langues et quels encodages seront disponibles dans la page de Préférences. Les lignes encoding (encodage) spécifient les différents types d'encodage de caractères qui peuvent être sélectionnés. Les lignes language (langue) spécifient quelles langues on pourra sélectionner pour l'interface utilisateur (il doit bien sûr exister une macro de langue pour chaque langue possible). La ligne encoding peut contenir quatre valeurs possibles: shortname (nom court), longname (nom long), map (correspondance), et multibyte (multi-octets). La valeur shortname est l'étiquette du jeu de caractères standard, et doit être spécifiée pour tous les encodages. La valeur longname donne le nom d'encodage spécifié sur la page de Préférences. En son absence la valeur par défaut est celle de shortname. La valeur map est obligatoire pour tous les encodages à l'exception de l'UTF-8, qui est géré de manière interne (et qui devrait toujours être activé). La valeur multibyte devrait être positionnée pour tous les jeux de caractères qui nécessitent plus d'un octet par caractère. Le fichier main.cfg spécifie de nombreux encodages, dont la plupart sont désactivés car commentés. Pour activer un encodage, ôtez le caractère de commentaire «//#//». Chaque ligne language peut contenir trois valeurs possibles: shortname (nom court), longname (nom long), et default_encoding (encodage par défaut). La valeur shortname est le symbole de langue en deux lettres ISO 639, et elle est obligatoire. La valeur longname donne le nom de la langue spécifié sur la page de Préférences. En son absence la valeur par défaut est celle de shortname. L'option default_encoding sert à spécifier l'encodage préféré pour cette langue. ==== Paramètres de page et arguments CGI ==== On peut définir des paramètres de page et des arguments CGI dans le fichier de configuration main.cfg. Rappelez-vous qu'à la figure  la plupart des arguments CGI sont définis au sein même du code C++ de la bibliothèque. Cependant, il est parfois utile de définir de nouveaux arguments ou d'éditer les arguments existants dans les fichiers de configuration, ce qui évite de recompiler la bibliothèque. Pour ce faire, vous utiliserez l'option de configuration cgiarg. Elle peut prendre jusqu'à six arguments, qui sont les suivants: shortname (nom court), longname (nom long), multiplechar (caractères multiples), argdefault (argument par défaut), defaultstatus (état par défaut), et savedarginfo (informations de sauvegarde d'argument). Ces arguments correspondent aux options d'arguments CGI décrits section [[#receptionist|receptionist]]. Par exemple, dans le fichier main.cfg, par défaut, l'option de configuration cgiarg sert à positionner les valeurs par défaut des arguments CGI existants a et p à p et home, respectivement. Les paramètres de page sont un cas particulier d'arguments CGI qui correspondent aux paramètres des fichiers de macros de Greenstone. Par exemple, l'argument CGI l correspond directement au paramètre l= dans les fichiers de macros. On utilise l'option de configuration pageparam pour définir un argument CGI comme étant également un paramètre de page. La meilleure manière d'apprendre les différentes options de configuration possibles dans le fichier de configuration main.cfg est de faire des expériences avec ce dernier. Souvenez-vous que si vous utilisez la version «Bibliothèque locale» de Greenstone sous Windows, il faut redémarrer le serveur pour que toute modification des fichiers de configuration soit prise en compte. ===== Fichier de configuration de site ===== |< - 132 397 >| | **Ligne** | **Fonction** | | //gsdlhome// | Un chemin vers le répertoire//GSDLHOME//. | | //httpprefix// | L'adresse web de//GSDLHOME//. Si la racine de documents de votre serveur web a la valeur//GSDLHOME//vous n'avez pas besoin de cette ligne. | | //httpimage// | L'adresse web du répertoire contenant les images de l'interface utilisateur. Si la racine de documents de votre serveur web a la valeur//GSDLHOME//ceci vaudra///images//. | | //gwcgi// | L'adresse web du présent script CGI (se termine généralement par//library//). Ceci n'est pas nécessaire si votre serveur web positionne la variable d'environnement//SCRIPT_NAME//(nom de script). | | //maxrequests// | (Ne s'applique que si l'on utilise//fast-cgi//.) Nombre de requêtes que Fast-CGI doit traiter avant de rendre la main. Lors du débogage de la bibliothèque il faut positionner ceci à une faible valeur, et à une valeur élevée dans le cas contraire, en production. | Le fichier de configuration de site gsdlsite.cfg positionne des variables utilisées par le logiciel de bibliothèque et le serveur web au moment de l'exécution, et se trouve dans le même répertoire que le programme library. La table  décrit les lignes de ce fichier; elles sont expliquées dans la section 5 du Guide d'installation de la bibliothèque numérique Greenstone.