Étape 5: configuration de base de LXR

1. Ouvrez lxrconf.d/lxr.conf dans votre éditeur favori (vi, emacs, KWrite, gedit, …). Le fichier est divisé en sections pour faciliter la configuration.
   • Allez à Global configuration section, Auxiliary tools subsection.

     Si l'étape de préconfiguration a détecté à la fois glimpse et swish-e, vous commentez l'un des groupes suivants de paramètres:

     , 'glimpsebin' => '/usr/local/bin/glimpse' , 'glimpseindex' => '/usr/local/bin/glimpseindex'

     ou:

     , 'swishbin' => '/path/to/your/swishe-e/executable' Important!
     Comme un seul moteur de recherche peut être utilisé, commentez soit 'glimpsebin' soit 'swishbin' en préfixant la ligne avec un signe "dièse" (#). Important!
     Tous les chemins dans cette section doivent être absolus.
   • Allez à Computer DNS names subsection pour lister les noms de votre ordinateur.

     Le nom d'hôte (complet avec le protocole et le canal) est tiré du paramètre 'host_names', une liste des différents noms sous lesquels votre ordinateur est connu de votre serveur web et des serveurs DNS.

     La valeur de ce paramètre doit être cohérente avec la configuration du serveur web. , 'host_names' => [ 'http://localhost' , 'http://localhost.localdomain' , 'http://127.0.0.1' ] Par commodité, vous pouvez omettre le protocole s'il est http:.
   • Allez à HTML subsection.

     Selon votre choix du moteur de recherche, faites pointer 'htmlsearch' vers le bon modèle; choisissez un des suivants:

     , 'htmlsearch' => 'templates/html/html-search-swish.html' , 'htmlsearch' => 'templates/html/html-search-glimpse.html' Important!
     La forme "relative" est ancrée dans le répertoire racine de LXR. Vous pouvez aussi utiliser un chemin absolu.
   • Avancez jusqu'à Tree configuration section et modifiez Server configuration subsection pour informer LXR comment il sera connu du serveur web.

     L'URL d'accès est formé de la concaténation du nom d'hôte et de la racine virtuelle du script.

     Le paramètre 'virtroot' est égal à ce qui suit le nom d'hôte dans l'URL d'accès.

     , 'virtroot' => '/lxr'

     Donnez un titre sympathique à vos pages:

     , 'caption' => 'Ma première installation LXR'
   • Allez à Tree location subsection Dans ce premier essai, nous ne considérons qu'un seul arbre résidant dans des répertoires réels.

     Mettez dans le paramètre 'sourceroot' le chemin absolu du répertoire contenant les différentes versions (comme sous-répertoires):

     , 'sourceroot' => '/home/malcolm/indexed-src'

     Donnez un nom pour l'origine des chemins relatifs de votre arbre:

     , 'sourcerootname' => 'monProjet'

     ou, pour l'insertion de l'identificateur de version:

     , 'sourcerootname' => 'version-$v'
   • Allez à Version selection subsection.

     Placez dans le paramètre 'range' les noms des sous-répertoires contenant les versions:

     , 'range' => [qw(v1 v2 v3.1 v4 experimental)]

     Et modifiez 'default' pour sélectionner la version à afficher au démarrage de LXR.

     , 'default' => 'v4'

     Si vos fichiers source utilisent des directives include, placez dans 'incprefix' la liste des répertoires include.

     Tous les chemins sont relatifs au répertoire de base de l'arbre source, mais n'oubliez pas de les écrire avec un séparateur initial. , 'incprefix' => [ '/include', '/include/linux' ]
   • Enfin, allez à Data storage subsection pour préciser les emplacements des données auxiliaires.

     Indiquez quelle base de données utiliser dans 'dbname' parmi les trois suivantes:

     # ----- MySql ----- , 'dbname' => 'dbi:mysql:dbname=lxr' # ----- Postgresql ----- , 'dbname' => 'dbi:Pg:dbname=lxr' # ----- Oracle ----- , 'dbname' => 'dbi:Oracle:host=localhost;sid=DEVMMS;port=1521' Pour MySQL et Postgresql, lxr est le nom donné lors de la création de la base (voir l'étape précédente).

     N'oubliez pas d'ajuster les paramètres d'accès tels que vous les avez définis dans l'étape précédente:

     , 'dbuser' => 'lxr' , 'dbpass' => 'lxrpassword' , 'dbprefix' => 'lxr_' Vous n'avez besoin de décommenter 'dbprefix' que s'il est différent de la valeur par défaut.

     Enfin, donnez un peu d'espace au moteur de recherche pour son propre usage:

     , 'glimpsedir' => '/path/to/glimpse/databases' , 'swishdir' => '/a/directory/here/' Il vaut mieux ne pas mettre ces répertoires dans votre répertoire source, car cela pourrait entraîner une confusion (pour vous, pas pour LXR). Quand bien même un seul moteur de recherche est utilisé, il n'y a aucun mal à définir les deux répertoires. Ainsi, vous pouvez librement changer de moteur de recherche.
2. Copiez lxr.conf à son emplacement final: $ cp lxrconf.d/lxr.conf .

Vous êtes prêt pour le chargement de la base de données.