[Lxr-commits] CVS: html/fr/1-0-InstallSteps 1-0-install3config.shtml, 1.7, 1.8
Brought to you by:
ajlittoz
Menu
▾
▴
[Lxr-commits] CVS: html/fr/1-0-InstallSteps 1-0-install3config.shtml, 1.7, 1.8
|
From: Andre-Littoz <ajl...@us...> - 2013-03-14 18:21:57
|
Update of /cvsroot/lxr/html/fr/1-0-InstallSteps In directory sfp-cvs-1.v30.ch3.sourceforge.com:/tmp/cvs-serv26205/fr/1-0-InstallSteps Modified Files: 1-0-install3config.shtml Log Message: General revision for 1.1 and 1.2 features and procedures Index: 1-0-install3config.shtml =================================================================== RCS file: /cvsroot/lxr/html/fr/1-0-InstallSteps/1-0-install3config.shtml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- 1-0-install3config.shtml 3 Jan 2013 11:07:03 -0000 1.7 +++ 1-0-install3config.shtml 14 Mar 2013 18:21:54 -0000 1.8 @@ -73,6 +73,106 @@ Vous n'avez pas besoin d'écrire le choix sélectionné en entier, tapez juste assez de caractères pour rendre la réponse non ambiguë. </p> + <ul class="version"> + <li>Version 1.1 et supérieures + <p class="comment"> +Configurer le serveur web demandant un soin particulier, +les questions suivantes visent à faciliter cette tâche. + </p> +<pre class="shell"> +<samp>Configure for single/multiple trees? [S/m] ></samp> +</pre> + <p class="normal caution"> +Important! +C'est le seul choix que vous ne pourrez pas changer ultérieurement +car il configure le serveur web d'une façon non triviale. + </p> + <p class="normal"> +Répondez <code>S</code> si vous ne proposerez jamais qu'un seul arbre +(si vous changez d'idée à ce sujet, +vous serez contraint de recommencer de zéro +avec l'effacement de la base de données en cours de création). +C'est néanmoins un choix idéal pour un premier essai. + </p> + <p class="normal"> +Répondez <code>M</code> si vous avez l'intention d'ajouter un autre arbre +dans un avenir indéfini. + </p> +<pre class="shell"> +<samp>Do you intend to add other trees later? [yes/NO] ></samp> +</pre> + <p class="comment"> +Cette question offre la possibilité de corriger une erreur de choix. +Supposons que le choix par défaut <code>S</code> était le bon. + </p> + <p class="normal"> +Traiter l'arbre source correct demande un codage spécifique de l'URL. +LXR a été conçu pour désigner le service LXR après le nom d'hôte, +puis l'arbre voulu. + </p> + <p class="normal"> +Si les pages du serveur viennent uniquement de LXR, +le nom de service (habituellement <code>/lxr</code>) peut être omis. + </p> + <p class="comment"> +Ceci correspond au cas d'un site entièrement dédié à LXR +(cas 1 et 3 ci-dessous). + </p> + <p class="normal"> +En contexte d'arbre unique, +il n'est pas besoin de désigner l'arbre. + </p> + <p class="comment"> +Ceci supprime la question ultérieure sur la racine virtuelle. + </p> +<pre class="shell"> +<samp>*** LXR web server configuration *** + +LXR can be configured as the default server (the only service in your computer), +a section of this default server or an independent server (with its own +host name). +Refer to the User's Manual for a description of the differences. +Web server type? [1.DEFAULT +/2.section in default +/3.indepedent +/4.section in indepedent +] > </samp><kbd>2</kbd> +</pre> + <p class="normal"> +Choisissez <code>1</code> (réponse par défaut) pour le cas le plus simple +ou <code>2</code> pour ne pas écraser un server local existant. + </p> +<pre class="shell"> +<samp>The computer hosting the server is described by an URL. +The form is scheme://host_name:port +where: + - scheme is either http or https (http: can be omitted), + - host_name can be given as an IP address such as 123.45.67.89 + or a domain name like localhost or lxr.url.example, + - port may be omitted if standard for the scheme. +The following question asks for a primary URL. Later, you'll have +the opportunity to give aliases to this primary URL. +--- Host name or IP? [//localhost] ></samp> +</pre> + <p class="normal"> +Le serveur local par défaut s'appelle généralement <code>//localhost</code>, +tapez alors "retour chariot". + </p> +<pre class="shell"> +<samp>URL section name for LXR in your server? [/lxr] ></samp> +</pre> + <p class="normal"> +C'est le nom sous lequel le service LXR sera requis par l'URL. + </p> + <p class="comment"> +<span class="attention">ATTENTION!</span><br> +Si vous répondez <code>/</code>, +vous revenez aux cas 1 ou 3 sans aucun avertissement. +Ceci peut entraîner de sérieux dysfonctionnements dans votre server +web existant. + </p> + </li> + </ul> <pre class="shell"> <samp>The choice of the database engine can make a difference in indexing performance, but resource consumption is also an important factor. @@ -88,41 +188,44 @@ cross-referencing) where it is fastest at the cost of bigger databases. * Take also in consideration the number of connected users.</samp> -<samp>Database engine? [MYSQL/oracle/postgres/sqlite] </samp> +<samp>Database engine? [MYSQL/oracle/postgres/sqlite] ></samp> </pre> <p class="normal"> Sélectionnez la base de données en fonction de la politique de votre site ou de ses disponibilités. </p> + <ul class="version"> + <li>Version 1.0 <pre class="shell"> -<samp>Configure for single/multiple trees? [S/m] </samp> +<samp>Configure for single/multiple trees? [S/m] ></samp> </pre> - <p class="normal caution"> + <p class="normal caution"> Important! C'est le seul choix que vous ne pourrez pas changer ultérieurement car il configure le serveur web d'une façon non triviale. - </p> - <p class="normal"> - + </p> + <p class="normal"> Répondez <code>S</code> si vous ne proposerez jamais qu'un seul arbre (si vous changez d'idée à ce sujet, vous serez contraint de recommencer de zéro avec l'effacement de la base de données en cours de création). C'est néanmoins un choix idéal pour un premier essai. - </p> - <p class="normal"> + </p> + <p class="normal"> Répondez <code>M</code> si vous avez l'intention d'ajouter un autre arbre dans un avenir indéfini. - </p> + </p> <pre class="shell"> -<samp>Do you intend to add other trees later? [yes/NO] </samp> +<samp>Do you intend to add other trees later? [yes/NO] ></samp> </pre> - <p class="comment"> + <p class="comment"> Cette question offre la possibilité de corriger une erreur de choix. Supposons que le choix par défaut <code>S</code> était le bon. - </p> + </p> + </li> + </ul> <pre class="shell"> -<samp>--- Directory for glimpse databases? </samp><kbd>/home/myself/glimpse_DB</kbd> +<samp>--- Directory for glimpse databases? ></samp><kbd>/home/myself/glimpse_DB</kbd> </pre> <p class="normal"> Le script de configuration a détecté le moteur de recherche en plein texte @@ -135,8 +238,25 @@ assurez-vous qu'il peut être lu par <em>"tout le monde"</em>. </p> <pre class="shell"> -<samp>templates directory templates/ now protected read-only -file .htaccess written into LXR root directory +<samp>templates directory templates/ now protected read-only</samp> +</pre> + <ul class="version"> + <li>Version 1.1 et supérieures +<pre class="shell"> +<samp>Is your Apache version 2.4 or higher? [YES/no] ></samp> +</pre> + <p class="normal"> +Comme les contrôles d'accès ont changé entre Apache 2.2 et 2.4, +il est nécessaire de connaître quelle version est utilisée sur votre ordinateur +pour configurer correctement les fichiers d'accès d'Apache. + </p> + <p class="comment"> +N'importe quelle réponse est valable si vous n'utilisez pas Apache. + </p> + </li> + </ul> +<pre class="shell"> +<samp>file .htaccess written into LXR root directory file apache2-require.pl written into configuration directory file apache-lxrserver.conf written into configuration directory file lighttpd-lxrserver.conf written into configuration directory</samp> @@ -151,17 +271,57 @@ *** Configuring auxiliary tool paths *** Configuring host name or IP (as http://...)</samp> -<samp>--- Host name? </samp><kbd>//localhost</kbd> -<samp>--- Alias name ? (hit return to stop) </samp><kbd>//mycomputer.example.com</kbd> -<samp>--- Alias name ? (hit return to stop)</samp> +<samp>--- Host name? ></samp><kbd>//localhost</kbd> +</pre> + <ul class="version"> + <li>Version 1.1 et supérieures +<pre class="shell"> +<samp>*** Host name previously defined as //localhost</samp> +</pre> + <p class="comment"> +Cette ligne rappelle le nom d'hôte +que vous avez défini plus haut pendant la configuration du serveur web. + </p> + </li> + <li>Version 1.0 +<pre class="shell"> +<samp>--- Host name? ></samp><kbd>//localhost</kbd> +</pre> + <p class="normal"> +Donnez le nom d'hôte principal. + </p> + </li> + </ul> +<pre class="shell"> +<samp>--- Alias name ? (hit return to stop) ></samp><kbd>//mycomputer.example.com</kbd> +<samp>--- Alias name ? (hit return to stop) ></samp> </pre> <p class="normal"> -Donnez le nom d'hôte principal et autant d'alias (éventuellement aucun) -que de besoin. +Donnez autant d'alias (éventuellement aucun) que de besoin. </p> <pre class="shell"> <samp>*** Configuring HTML parameters -*** Configuring file subsection +</pre> + <ul class="version"> + <li>Version 1.1 et supérieures +<pre class="shell"> +<samp>'Buttons-and-menus' interface is recommended for the kernel +*** to avoid screen cluttering. +--- Use 'buttons-and-menus' instead of 'link' interface? [YES/no] ></samp> +</pre> + <p class="normal"> +L'interface <em>boutons-et-menus</em> présente une mise en page plus dense +que l'interface <em>lien</em> traditionnel. +Il est vivement recommandé dans les situations +où l'arbre source a beaucoup de versions ou, +comme dans le cas du noyau Linux, +lorsqu'une forme de contrôle de configuration est réalisée +à l'aide de nombreuses variables auxiliaires LXR. + </p> + </li> + </ul> +<pre class="shell"> +<samp>*** Configuring file subsection *** Configuring "common factors" *** Marking tree section</samp> </pre> @@ -175,23 +335,38 @@ *** Configuring LXR server parameters *** The virtual root is the fixed URL part after the hostname.</samp> -<samp>--- Virtual root? (i.e. URL part after host) [/lxr]</samp> </pre> - <p class="normal"> + <ul class="version"> + <li>Version 1.1 et supérieures +<pre class="shell"> +<samp>*** You previously defined the virtual root as /lxr</samp> +</pre> + <p class="comment"> +Cette ligne rappelle la racine virtuelle +implicite ou définie plus haut pendant la configuration du serveur web. + </p> + </li> + <li>Version 1.0 +<pre class="shell"> +<samp>--- Virtual root? (i.e. URL part after host) [/lxr] ></samp> +</pre> + <p class="normal"> La réponse par défaut construit un URL <code>http://localhost/lxr</code>. Si vous rangez votre serveur LXR à la racine de votre site, pour être accédé comme <code>http://localhost</code>, la réponse doit être <code>/</code> et non pas vide (ce qui sélectionnerait par défaut <code>/lxr</code>). - </p> + </p> + </li> + </ul> <pre class="shell"> -<samp>--- Caption in page header? (e.g. Project XYZZY displayed by LXR) </samp><kbd>LXR first trial</kbd> +<samp>--- Caption in page header? (e.g. Project XYZZY displayed by LXR) ></samp><kbd>LXR first trial</kbd> </pre> <p class="normal"> Ceci définit le titre dans la zone d'en-tête de chaque page. </p> <pre class="shell"> -Do you need a specific encoding for this tree ? [yes/NO] +<samp>Do you need a specific encoding for this tree ? [yes/NO] ></samp> </pre> <p class="normal"> Le codage par défaut est <code>UTF-8</code>. @@ -202,7 +377,7 @@ <samp>*** Describing tree location How is your tree stored? [FILES/cvs/git/subversion/bitkeeper] *** A source directory contains one sub-directory for every version.</samp> -<samp>--- Source directory? (e.g. /home/myself/project-tree) </samp><kbd>/home/myself/my-project</kbd> +<samp>--- Source directory? (e.g. /home/myself/project-tree) ></samp><kbd>/home/myself/my-project</kbd> </pre> <p class="normal"> Faites votre premier essai sur un arbre résidant dans des vrais fichiers et répertoires @@ -219,7 +394,7 @@ même si vous n'avez qu'une seule version. </p> <pre class="shell"> -<samp>Name to display for the path root? (e.g. Project or $v for version) [$v]</samp> +<samp>Name to display for the path root? (e.g. Project or $v for version) [$v] ></samp> </pre> <p class="normal"> Ceci est un raccourci du chemin du répertoire soure dans un nom complet de fichier @@ -232,11 +407,11 @@ *** Versions can be explicitly enumerated, be read from a file or computed *** by a function. The latter case is recommended for VCS-stored trees. Version enumeration method? [LIST/file/function]</samp> -<samp>--- Version name? (hit return to stop) </samp><kbd>v1</kbd> -<samp>--- Version name? (hit return to stop)</samp> +<samp>--- Version name? (hit return to stop) ></samp><kbd>v1</kbd> +<samp>--- Version name? (hit return to stop) ></samp> <samp>*** By default, first version in list is displayed. You may also indicate *** a prefered version.</samp> -<samp>--- Default displayed version is first in 'range'? [YES/no]</samp> +<samp>--- Default displayed version is first in 'range'? [YES/no] ></samp> </pre> <p class="normal"> Indiquez à LXR les versions figurant dans le répertoire source. @@ -256,7 +431,7 @@ --- Directory to ignore, e.g. CVSROOT or .git? (hit return to stop) *** If your source code uses "include" statements (#include, require, ...) *** LXR needs hints to resolve the destination file. ---- Include directory, e.g. /include? (hit return to stop)</samp> +--- Include directory, e.g. /include? (hit return to stop) ></samp> </pre> <p class="normal"> Laissez de côté ces questions pour un arbre simple. @@ -265,16 +440,15 @@ </p> <pre class="shell"> <samp>*** Configuring data storage</samp> -<samp>--- Database name? </samp><kbd>lxr_myproject</kbd> -<samp>--- DB user name? [lxr] ---- DB password? [lxrpw] ---- DB table prefix? [lxr_]</samp> +<samp>--- Database name? ></samp><kbd>lxr_myproject</kbd> +<samp>--- DB user name? [lxr] > +--- DB password? [lxrpw] > +--- DB table prefix? [lxr_] ></samp> <samp>configuration saved in custom.d/t DB initialisation sript is custom.d/initdb.sh</samp> </pre> <p class="normal"> - Donnez un nom à la base de données selon les règles de votre site. De toute façon, il est toujours sage qu'il soit unique, à moins que vous définissiez la base en tant que jeu de tables particulier @@ -314,6 +488,20 @@ avant de les créer, de façon qu'il puisse être relancé n'importe quand dans un état cohérent. </p> + <p class="comment caution"> +ATTENTION!<br> +Il vaut néanmoins mieux détruire ce script dès qu'il a été utiliséc +car le script <em>configure-lxr.pl</em> ajoute toujours son +résultat au bout de <em>initdb.sh</em> sans l'effacer +(ce comportement permet de fractionner une configuration en arbres multiples +en plusieurs sessions +et de ne lancer qu'une seule fois l'initialisation de la base données +à la fin du processus). +Ne pas le détruire conserve toutes les créations antérieures de base de données. +Quand le script est relancé, +les nouvelles bases de données sont créées +et les anciennes recréées, entraînant la perte de leur contenu. + </p> </li> <li>Copiez <code>lxr.conf</code> à son emplacement final <p class="normal"> |
