cvs: phpdoc /fr/functions mnogosearch.xml
| From: | Damien Seguy | Date: | Thu, 12 Jul 2001 12:17:47 +0000 |
| Subject: | cvs: phpdoc /fr/functions mnogosearch.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336204@lists.php.net to get a copy of this message | ||
dams Thu Jul 12 08:17:47 2001 EDT
Modified files:
/phpdoc/fr/functions mnogosearch.xml
Log:
Corrected build-breaking files.Next build should go
Index: phpdoc/fr/functions/mnogosearch.xml diff -u phpdoc/fr/functions/mnogosearch.xml:1.6 phpdoc/fr/functions/mnogosearch.xml:1.7 --- phpdoc/fr/functions/mnogosearch.xml:1.6 Sat Jul 7 18:22:15 2001 +++ phpdoc/fr/functions/mnogosearch.xml Thu Jul 12 08:17:46 2001 @@ -6,12 +6,12 @@ Ces fonctions donnent l'accès à mnoGoSearch (anciennement UdmSearch), moteur de recherche du monde libre. Pour pouvoir les utiliser, vous devez inclure le support en ajoutant l'option - <option role="configure">--with-mnogosearch</option>. + <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch</option></link>. Si vous utilisez cette option sans indiquer le chemin jusqu'à mnogosearch, PHP essaiera de le trouver dans le dossier <filename>/usr/local/mnogosearch</filename>. Si vous avez installé mnogosearch dans un autre endroit, vous devez l'indiquer comme - ceci : <option role="configure">--with-mnogosearch=DIR</option>. + ceci : <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch=DIR</option></link>. </simpara> <para> mnoGoSearch est une moteur de recherche complet, destinés aux intranet et @@ -24,8 +24,8 @@ et le moteur de recherche. L'indexeur passe en revue récursivement les sites HTTP, FTP, NEWS ou encore les fichiers locaux, et enregistre des méta-données dans les bases MySQL, pour optimiser les recherches ultérieures. - Une fois que tous les documents ont été référéncés, ils sont accessibles au moteur - de recherche. Celui-ci est utilisable par interface web. Les langages + Une fois que tous les documents ont été référéncés, + ils sont accessibles au moteur de recherche. Celui-ci est utilisable par interface web. Les langages C CGI, Perl et PHP sont supportés pour effectuer les recherches. </para> <note> @@ -36,7 +36,7 @@ MySQL. Par conséquent, si vous utilisez mnoGoSearch avec MySQL, indiquez le dossier d'installation de MySQL durant la configuration avec l'option : - <option role="configure">--with-mnogosearch --with-mysql=/usr</option>. + <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch --with-mysql=/usr</option></link>. </para> </note> <simpara> @@ -115,15 +115,15 @@ similaires aux étiquettes, mais elles peuvent être imbriquées. Vous pouvez donc placer des catégories dans d'autres cattégories. Vous devez utiliser deux caractères pour chaque niveau. Vous pouvez utiliser des nombres héxadécimaux - allant de 0 à F ou bien sur une base de 36, allant de 0 à Z. Par exemple + allant de 0 à F ou bien sûr une base de 36, allant de 0 à Z. Par exemple la catégorie supérieure 'Auto' vaut 01. Si elle a une sous catégorie 'Renault', cette dernière sera repérée par 01 (catégorie mère) suivie de 01 (dans sa catégorie), ce qui donne "0101". Si 'Auto' a une autre - sous-catégorie 'Peugeot', cette dernière aura le numéro 02, et sera identifiée - par <literal>0102</literal>. Si 'Peugeot' a elle-même une autre sous-catégorie, - 'Moteur', elle sera numéroté 01, et identifiée uniquement par <literal>010201</literal>. - Si vous voulez restreindre les recherches à cette catégorie uniquement, - passez <literal>cat=010201</literal>. + sous-catégorie 'Peugeot', cette dernière aura le numéro 02, et + sera identifiée par <literal>0102</literal>. Si 'Peugeot' a elle-même + une autre sous-catégorie, 'Moteur', elle sera numéroté 01, et + identifiée uniquement par <literal>010201</literal>. Si vous voulez restreindre + les recherches à cette catégorie uniquement, passez <literal>cat=010201</literal>. </simpara> </listitem> <listitem> @@ -184,11 +184,11 @@ supporté, utilisez le terme "unknown". </para> <para> - <parameter>dbmode</parameter> - Vous pouvez selectionner le mode de stockage + <parameter>dbmode</parameter> - Vous pouvez sélectionner le mode de stockage des mots dans la base de données. Si vous indiquez "single", tous les mots seront sotckés dans la même table. Si vous indiquez "multi", les mots seront situés dans différentes tables, suivant leur taille. Le mode "multi" est généralement plus - rapide, mais requiert plus de tables. Si le mode "crc" est selectionné, mnoGoSearch + rapide, mais requiert plus de tables. Si le mode "crc" est sélectionné, mnoGoSearch enregistrera un entier de 32 bits, calculé avec l'algorithme CRC32, plutot que des des mots. Ce mode requiert moins d'espace disque, et il est beaucoup plus rapide que les modes "single" et "multi". "crc-multi" utilise la même technique de stockage que @@ -220,7 +220,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>udm_api_version</function></funcdef> - <paramdef><parameter></parameter></paramdef> + <void/> </funcprototype> </funcsynopsis> <para> @@ -346,7 +346,7 @@ mots. Avec l'exemple ci-dessus, mnoGoSearch va rechercher les pages contenant "mysql" et/ou "odbc". Les meilleures réponses seront classées en premier, et affichées en tête de liste. - Si vous selectionez le mode de recherche "tous" ("ALL"), la recherche + Si vous sélectionnez le mode de recherche "tous" ("ALL"), la recherche va retourner les documents qui contiennent l'un ou l'autre des mots que vous avez entré. Dans le cas où vous utilisez le mode "ANY", la recheche retourne la lsite des documents qui contiennent @@ -632,7 +632,7 @@ </listitem> <listitem> <simpara> - UDM_PARAM_WORDINFO - Informations sur les mots trouvés, c'est à dire que + UDM_PARAM_WORDINFO - Informations sur les mots trouvés, c'est-à-dire que la recherche "un bon libre" retournera "un: stopword, bon:5637, livre: 120" </simpara> </listitem> @@ -737,7 +737,7 @@ la fonction retourne &false;, et un message d'erreur sera affiché. Les messages d'erreur ne sont pas accessibles avec <function>udm_error</function> et <function>udm_errno</function>, puisque ces fonctions ne traitent que les messages - SQL. Reportez vous à la description du paramètre <parameter>flag</parameter>. + SQL. Reportez-vous à la description du paramètre <parameter>flag</parameter>. </para> <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> <informalexample> @@ -768,7 +768,7 @@ avec ce mode, si le fichier est absent, la fonction retourne &false;, et un message d'erreur sera affiché. Les messages d'erreur ne sont pas accessibles avec <function>udm_error</function> et <function>udm_errno</function>, puisque ces fonctions - ne traitent que les messages SQL. Reportez vous à la description du paramètre + ne traitent que les messages SQL. Reportez-vous à la description du paramètre <parameter>flag</parameter>. </para> <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> @@ -803,7 +803,7 @@ les trie et les stockes en mémoire. Avec les clients, le serveur communique de deux façons : vers les indexeurs, tout le contenu de la mémoire est transféré pour que l'indexeur travaille plus vite; vers le - moteur de recherche, il recoit les mots à normaliser, et les rend + moteur de recherche, il reçoit les mots à normaliser, et les rend au client corrigés. Cela permet une plus grande rapidité d'éxécution, en comparaison des modes db et text (notamment, les tris et les chargements sont beaucoup plus rapides). @@ -861,8 +861,9 @@ <itemizedlist> <listitem> <simpara> - UDM_PARAM_PAGE_NUM - Utilisé pour choisir le numéro de groupe de résultat (les - résultats sont retournés par groupe, commencant à 0, avec UDM_PARAM_PAGE_SIZE + UDM_PARAM_PAGE_NUM - Utilisé pour choisir le numéro de + groupe de résultat (les résultats sont retournés + par groupe, commençant à 0, avec UDM_PARAM_PAGE_SIZE résultats par page). </simpara> </listitem> @@ -933,7 +934,7 @@ mots ignorés. Il y a une petite différence avec mnoGoSearch : Avec mnoGoSearch, si le chemin est &null; ou relatif, il est utilisé à partir de UDM_CONF_DIR, alors qu'en PHP, le module - va rechercher à partir du chemin courant, c'est à dire celui du + va rechercher à partir du chemin courant, c'est-à-dire celui du script courant. </simpara> </listitem> @@ -962,8 +963,8 @@ Comme l'indexeur utiliser l'opérateur de bits OR pour mesurer le poids des mots, il est possible que le même mot soit trouvé plusieurs fois dans le même document lors des - recherches. Un mot qui n'apparait qu'une fois dans le corps - sera défini par 00000010 (notation binaire). Un mot qui apparaitra + recherches. Un mot qui n'apparaît qu'une fois dans le corps + sera défini par 00000010 (notation binaire). Un mot qui apparaîtra dans plusieurs parties pourra avoir la notation 00011111. </simpara> <simpara> @@ -1019,7 +1020,7 @@ <simpara> UDM_PARAM_MIN_WORD_LEN - définit les tailles extrêmes de mots. Tout mot plus court que la limite inférieur est ignoré. Notez - que ce paramètre est inclusif, c'est à dire que si + que ce paramètre est inclusif, c'est-à-dire que si UDM_PARAM_MIN_WORD_LEN=3, un mot de 3 caractères ne sera pas ignoré, alors qu'un mot de 2 caractères sera ignoré. Par défaut, la valeur est de 1. @@ -1029,7 +1030,7 @@ <simpara> UDM_PARAM_ISPELL_PREFIXES - Valeurs possibles : UDM_PREFIXES_ENABLED et UDM_PREFIXES_DISABLED. Ces valeurs activent et désactivent le support des préfixes. Par exemple, si le mot - "testé" est placé dans la requête de recherche, les mots tels que "test", "tester", etc. + "testé" est placé dans la requête de recherche, les mots tels que "test", "tester", etc.. seront aussi recherchés. Les suffixes sont supportés par défaut. Les préfixes modifie généralement le sens des mots. Par exemple, si vous cherchez "testé", vous ne souhaitez pas trouver "protesté" ou "contesté". Le support des préfixes peut cependant être
Index: phpdoc/fr/functions/mnogosearch.xml diff -u phpdoc/fr/functions/mnogosearch.xml:1.6 phpdoc/fr/functions/mnogosearch.xml:1.7 --- phpdoc/fr/functions/mnogosearch.xml:1.6 Sat Jul 7 18:22:15 2001 +++ phpdoc/fr/functions/mnogosearch.xml Thu Jul 12 08:17:46 2001 @@ -6,12 +6,12 @@ Ces fonctions donnent l'accès à mnoGoSearch (anciennement UdmSearch), moteur de recherche du monde libre. Pour pouvoir les utiliser, vous devez inclure le support en ajoutant l'option - <option role="configure">--with-mnogosearch</option>. + <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch</option></link>. Si vous utilisez cette option sans indiquer le chemin jusqu'à mnogosearch, PHP essaiera de le trouver dans le dossier <filename>/usr/local/mnogosearch</filename>. Si vous avez installé mnogosearch dans un autre endroit, vous devez l'indiquer comme - ceci : <option role="configure">--with-mnogosearch=DIR</option>. + ceci : <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch=DIR</option></link>. </simpara> <para> mnoGoSearch est une moteur de recherche complet, destinés aux intranet et @@ -24,8 +24,8 @@ et le moteur de recherche. L'indexeur passe en revue récursivement les sites HTTP, FTP, NEWS ou encore les fichiers locaux, et enregistre des méta-données dans les bases MySQL, pour optimiser les recherches ultérieures. - Une fois que tous les documents ont été référéncés, ils sont accessibles au moteur - de recherche. Celui-ci est utilisable par interface web. Les langages + Une fois que tous les documents ont été référéncés, + ils sont accessibles au moteur de recherche. Celui-ci est utilisable par interface web. Les langages C CGI, Perl et PHP sont supportés pour effectuer les recherches. </para> <note> @@ -36,7 +36,7 @@ MySQL. Par conséquent, si vous utilisez mnoGoSearch avec MySQL, indiquez le dossier d'installation de MySQL durant la configuration avec l'option : - <option role="configure">--with-mnogosearch --with-mysql=/usr</option>. + <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch --with-mysql=/usr</option></link>. </para> </note> <simpara> @@ -115,15 +115,15 @@ similaires aux étiquettes, mais elles peuvent être imbriquées. Vous pouvez donc placer des catégories dans d'autres cattégories. Vous devez utiliser deux caractères pour chaque niveau. Vous pouvez utiliser des nombres héxadécimaux - allant de 0 à F ou bien sur une base de 36, allant de 0 à Z. Par exemple + allant de 0 à F ou bien sûr une base de 36, allant de 0 à Z. Par exemple la catégorie supérieure 'Auto' vaut 01. Si elle a une sous catégorie 'Renault', cette dernière sera repérée par 01 (catégorie mère) suivie de 01 (dans sa catégorie), ce qui donne "0101". Si 'Auto' a une autre - sous-catégorie 'Peugeot', cette dernière aura le numéro 02, et sera identifiée - par <literal>0102</literal>. Si 'Peugeot' a elle-même une autre sous-catégorie, - 'Moteur', elle sera numéroté 01, et identifiée uniquement par <literal>010201</literal>. - Si vous voulez restreindre les recherches à cette catégorie uniquement, - passez <literal>cat=010201</literal>. + sous-catégorie 'Peugeot', cette dernière aura le numéro 02, et + sera identifiée par <literal>0102</literal>. Si 'Peugeot' a elle-même + une autre sous-catégorie, 'Moteur', elle sera numéroté 01, et + identifiée uniquement par <literal>010201</literal>. Si vous voulez restreindre + les recherches à cette catégorie uniquement, passez <literal>cat=010201</literal>. </simpara> </listitem> <listitem> @@ -184,11 +184,11 @@ supporté, utilisez le terme "unknown". </para> <para> - <parameter>dbmode</parameter> - Vous pouvez selectionner le mode de stockage + <parameter>dbmode</parameter> - Vous pouvez sélectionner le mode de stockage des mots dans la base de données. Si vous indiquez "single", tous les mots seront sotckés dans la même table. Si vous indiquez "multi", les mots seront situés dans différentes tables, suivant leur taille. Le mode "multi" est généralement plus - rapide, mais requiert plus de tables. Si le mode "crc" est selectionné, mnoGoSearch + rapide, mais requiert plus de tables. Si le mode "crc" est sélectionné, mnoGoSearch enregistrera un entier de 32 bits, calculé avec l'algorithme CRC32, plutot que des des mots. Ce mode requiert moins d'espace disque, et il est beaucoup plus rapide que les modes "single" et "multi". "crc-multi" utilise la même technique de stockage que @@ -220,7 +220,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>udm_api_version</function></funcdef> - <paramdef><parameter></parameter></paramdef> + <void/> </funcprototype> </funcsynopsis> <para> @@ -346,7 +346,7 @@ mots. Avec l'exemple ci-dessus, mnoGoSearch va rechercher les pages contenant "mysql" et/ou "odbc". Les meilleures réponses seront classées en premier, et affichées en tête de liste. - Si vous selectionez le mode de recherche "tous" ("ALL"), la recherche + Si vous sélectionnez le mode de recherche "tous" ("ALL"), la recherche va retourner les documents qui contiennent l'un ou l'autre des mots que vous avez entré. Dans le cas où vous utilisez le mode "ANY", la recheche retourne la lsite des documents qui contiennent @@ -632,7 +632,7 @@ </listitem> <listitem> <simpara> - UDM_PARAM_WORDINFO - Informations sur les mots trouvés, c'est à dire que + UDM_PARAM_WORDINFO - Informations sur les mots trouvés, c'est-à-dire que la recherche "un bon libre" retournera "un: stopword, bon:5637, livre: 120" </simpara> </listitem> @@ -737,7 +737,7 @@ la fonction retourne &false;, et un message d'erreur sera affiché. Les messages d'erreur ne sont pas accessibles avec <function>udm_error</function> et <function>udm_errno</function>, puisque ces fonctions ne traitent que les messages - SQL. Reportez vous à la description du paramètre <parameter>flag</parameter>. + SQL. Reportez-vous à la description du paramètre <parameter>flag</parameter>. </para> <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> <informalexample> @@ -768,7 +768,7 @@ avec ce mode, si le fichier est absent, la fonction retourne &false;, et un message d'erreur sera affiché. Les messages d'erreur ne sont pas accessibles avec <function>udm_error</function> et <function>udm_errno</function>, puisque ces fonctions - ne traitent que les messages SQL. Reportez vous à la description du paramètre + ne traitent que les messages SQL. Reportez-vous à la description du paramètre <parameter>flag</parameter>. </para> <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> @@ -803,7 +803,7 @@ les trie et les stockes en mémoire. Avec les clients, le serveur communique de deux façons : vers les indexeurs, tout le contenu de la mémoire est transféré pour que l'indexeur travaille plus vite; vers le - moteur de recherche, il recoit les mots à normaliser, et les rend + moteur de recherche, il reçoit les mots à normaliser, et les rend au client corrigés. Cela permet une plus grande rapidité d'éxécution, en comparaison des modes db et text (notamment, les tris et les chargements sont beaucoup plus rapides). @@ -861,8 +861,9 @@ <itemizedlist> <listitem> <simpara> - UDM_PARAM_PAGE_NUM - Utilisé pour choisir le numéro de groupe de résultat (les - résultats sont retournés par groupe, commencant à 0, avec UDM_PARAM_PAGE_SIZE + UDM_PARAM_PAGE_NUM - Utilisé pour choisir le numéro de + groupe de résultat (les résultats sont retournés + par groupe, commençant à 0, avec UDM_PARAM_PAGE_SIZE résultats par page). </simpara> </listitem> @@ -933,7 +934,7 @@ mots ignorés. Il y a une petite différence avec mnoGoSearch : Avec mnoGoSearch, si le chemin est &null; ou relatif, il est utilisé à partir de UDM_CONF_DIR, alors qu'en PHP, le module - va rechercher à partir du chemin courant, c'est à dire celui du + va rechercher à partir du chemin courant, c'est-à-dire celui du script courant. </simpara> </listitem> @@ -962,8 +963,8 @@ Comme l'indexeur utiliser l'opérateur de bits OR pour mesurer le poids des mots, il est possible que le même mot soit trouvé plusieurs fois dans le même document lors des - recherches. Un mot qui n'apparait qu'une fois dans le corps - sera défini par 00000010 (notation binaire). Un mot qui apparaitra + recherches. Un mot qui n'apparaît qu'une fois dans le corps + sera défini par 00000010 (notation binaire). Un mot qui apparaîtra dans plusieurs parties pourra avoir la notation 00011111. </simpara> <simpara> @@ -1019,7 +1020,7 @@ <simpara> UDM_PARAM_MIN_WORD_LEN - définit les tailles extrêmes de mots. Tout mot plus court que la limite inférieur est ignoré. Notez - que ce paramètre est inclusif, c'est à dire que si + que ce paramètre est inclusif, c'est-à-dire que si UDM_PARAM_MIN_WORD_LEN=3, un mot de 3 caractères ne sera pas ignoré, alors qu'un mot de 2 caractères sera ignoré. Par défaut, la valeur est de 1. @@ -1029,7 +1030,7 @@ <simpara> UDM_PARAM_ISPELL_PREFIXES - Valeurs possibles : UDM_PREFIXES_ENABLED et UDM_PREFIXES_DISABLED. Ces valeurs activent et désactivent le support des préfixes. Par exemple, si le mot - "testé" est placé dans la requête de recherche, les mots tels que "test", "tester", etc. + "testé" est placé dans la requête de recherche, les mots tels que "test", "tester", etc.. seront aussi recherchés. Les suffixes sont supportés par défaut. Les préfixes modifie généralement le sens des mots. Par exemple, si vous cherchez "testé", vous ne souhaitez pas trouver "protesté" ou "contesté". Le support des préfixes peut cependant être