fr/Paramètres spécifiques d'un arbre lxr.conf

Les paramètres spécifiques d'un arbre sont contenus dans le groupe_parametres-n (avec n différent de 0 (zéro)) et sont lus seulement si la valeur combinée de 'host_names', 'virtroot' et, éventuellement, 'treename' correspond à l'URL.

Cette section (groupe_parametres-n) peut éventuellement écraser des paramètres globaux (voir ici). Une section spécifique d'un arbre contient tout ce qui est nécessaire pour décrire l'accès à un arbre: { 'host_names' => liste_noms_d_hote # 0.11+ , 'virtroot' => URL_sans_nom_hote , 'treename' => nom_arbre_pour_routing_=_argument # 2.0+ , 'caption' => titre # 0.10+ , 'shortcaption' => legende_bouton # 0.11+ , 'baseurl' => URL_d_acces # non recommandé 0.11+ , 'baseurl_aliases'=> URL_alias # non recommandé 0.11+ , 'sourceroot' => depot_arbre_source , 'sourcetext' => arbre_source_extrait # 2.3+ , 'sourcerootname' => prefixe_chemin_pour_affichage , 'sourceparams' => parametres_optionnels_pour_depot , 'sourceaccess' => acces_HTML_a_arbre_source # 0.10+ , 'ignoredirs' => [ liste_repertoires_a_ignorer ] , 'filterdirs' => [ regles_pour_repertoires ] # 1.1+ , 'ignorefiles'=> expression_reguliere # 1.1+ , 'filterfiles'=> [ regles_pour_fichiers ] # 1.1+ , 'incprefix' => [ liste_repertoires_include ] , 'maps' => { regles_transformation_chemin } # -0.11 (voir note ci-dessous) , 'maps' => [ regles_transformation_chemin ] # 1.0+ , 'variables' => { 'v' => { 'name' => nom_variable_pour_affichage , 'when' => expression_conditionnelle # 1.0+ , 'range' => liste_valeurs , 'default' => valeur_par_defaut } # , autre_variable => { ... } } , 'dbname' => interface_DB_et_designation_DB , 'dbprefix' => prefixe_table_DB , 'dbuser' => utilisateur_DB , 'dbpass' => mot_de_passe_DB , 'glimpsedir' => repertoire_pour_fichiers_index_glimpse # non recommandé 1.0+ | sauf si besoin spécifique, , 'swishdir' => repertoire_pour_fichiers_index_swish-e # non recommandé 1.0+ | préférez la désignation auto # | par xxxdirbase + virtroot }

Vous écrivez une telle section par arbre.

ATTENTION!
Le type Perl du paramètre 'maps' a changé en version 1.0 pour permettre un contrôle sur l'ordre d'application des règles.

Notes d'obsolescence:

'baseurl' et 'baseurl_aliases'
'baseurl_aliases' est sujet à erreur car il demande une duplication exacte d'une partie de 'baseurl'. De plus, tous deux exigent une recopie de 'virtroot'.

'host_names' et 'virtroot' doivent être préférés car ils séparent la liste des noms d'hôte de la racine virtuelle, supprimant ainsi les redondances et les erreurs de recopie potentielles.
L'usage de 'routing' => 'argument' encourage à placer 'host_names' et 'virtroot' dans la section globale pour ne garder que 'treename' dans la section spécifique.
'glimpsedir' et 'swishdir'
Si vous définissez 'glimpsedirbase' et/ou 'swishdirbase' dans la section globale, ces paramètres d'arbre sont automatiquement générés comme valeur('glimpsedirbase')/valeur('virtroot').

Bien entendu, comme d'habitude, l'écriture explicite de 'glimpsedir' et/ou 'swishdir' dans une section d'arbre remplace le nommage automatique par défaut.