cvs: phpdoc /fr/functions mnogosearch.xml
| From: | Damien Seguy | Date: | Wed, 08 Aug 2001 09:39:06 +0000 |
| Subject: | cvs: phpdoc /fr/functions mnogosearch.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336906@lists.php.net to get a copy of this message | ||
dams Wed Aug 8 05:39:06 2001 EDT
Modified files:
/phpdoc/fr/functions mnogosearch.xml
Log:
Added last functions.Corrected typosDid some reformating
Index: phpdoc/fr/functions/mnogosearch.xml diff -u phpdoc/fr/functions/mnogosearch.xml:1.7 phpdoc/fr/functions/mnogosearch.xml:1.8 --- phpdoc/fr/functions/mnogosearch.xml:1.7 Thu Jul 12 08:17:46 2001 +++ phpdoc/fr/functions/mnogosearch.xml Wed Aug 8 05:39:06 2001 @@ -1,20 +1,23 @@ - <reference id="ref.mnogo"> - <title>mnoGoSearch</title> - <titleabbrev>mnoGoSearch</titleabbrev> - <partintro> - <simpara> - 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 - <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 : <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch=DIR</option></link>. +<!-- $Revision: 1.8 $ --> +<reference id="ref.mnogo"> + <title>mnoGoSearch</title> + <titleabbrev>mnoGoSearch</titleabbrev> + <partintro> + <simpara> + 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 <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 : <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 + <para> + mnoGoSearch est une moteur de recherche complet, destinés aux intranet et serveurs web, distribué sous licence GNU. mnoGoSearch offre des fonctionnalités unique, qui en font un excellent outil pour un grand nombre d'applications de recherche dans votre site : recherche de recettes de cuisines ou dans les @@ -23,691 +26,840 @@ textes. mnoGoSearch est constitué de deux parties : l'indexeur, qui effectue les recherches 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. + 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 + 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> + <para> + PHP supporte naturellement MySQL. Il faut savoir que mnoGoSearch + n'est pas compatible avec la librairie interne de PHP, et ne + peut fonctionner qu'avec les librairies génériques + MySQL. Par conséquent, si vous utilisez mnoGoSearch avec + MySQL, indiquez le dossier d'installation de MySQL durant + la configuration avec l'option : + <link linkend="install.configure.with-mnogosearch"><option role="configure"> + --with-mnogosearch --with-mysql=/usr</option></link>. </para> - <note> - <para> - PHP supporte naturellement MySQL. Il faut savoir que mnoGoSearch - n'est pas compatible avec la librairie interne de PHP, et ne - peut fonctionner qu'avec les librairies génériques - MySQL. Par conséquent, si vous utilisez mnoGoSearch avec - MySQL, indiquez le dossier d'installation de MySQL durant - la configuration avec l'option : - <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch --with-mysql=/usr</option></link>. - </para> - </note> - <simpara> - Pour utiliser ces fonctions, vous devez installer les versions - 3.1.10 ou plus récente de mnoGoSearch. + </note> + <simpara> + Pour utiliser ces fonctions, vous devez installer les versions 3.1.10 ou + plus récente de mnoGoSearch. </simpara> - <simpara> - Plus de détails sur le site officiel de mnoGoSearch : - <ulink url="&url.mnogo">&url.mnogo;</ulink>. + <simpara> + Plus de détails sur le site officiel de mnoGoSearch : <ulink + url="&url.mnogo">&url.mnogo;</ulink>. </simpara> - </partintro> - <refentry id="function.udm-add-search-limit"> - <refnamediv> - <refname>udm_add_search_limit</refname> - <refpurpose>Ajoute différentes limitations de recherche</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_add_search_limit</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - <paramdef>int <parameter>var</parameter></paramdef> - <paramdef>string <parameter>val</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_add_search_limit</function> retourne &true; - en cas de succès, &false; en cas d'erreur. - <function>udm_add_search_limit</function> ajoute différentes limitations - de recherche. - </para> - <para> - <parameter>agent</parameter> - un identifiant d'Agent, - obtenu après un appel à <function>udm_alloc_agent</function>. - </para> - <para> - <parameter>var</parameter> - nom du paramètre de limitation. - </para> - <para> - <parameter>val</parameter> - Valeur du paramètre sus-cité. - </para> - <para> - <parameter>var</parameter> peut prendre les valeurs suivantes : - </para> - <itemizedlist> - <listitem> - <simpara> - UDM_LIMIT_URL - Définit les limitations sur les URL, pour limiter les - recherches à une partie de la base. Ce paramètre supporte les - jokers SQL '%' et '_' : '%' remplace n'importe quel nombre de caractères, - même zéro caractères, et '_' remplace exactement un caractère. - Par exemple, <literal>'http://my.domain.__/catalog'</literal> peut remplacer - <literal>http://my.domain.ru/catalog</literal> ou <literal>http://my.domain.ua/catalog</literal>. + </partintro> + <refentry id="function.udm-add-search-limit"> + <refnamediv> + <refname>udm_add_search_limit</refname> + <refpurpose>Ajoute différentes limitations de recherche</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_add_search_limit</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>int <parameter>var</parameter></paramdef> + <paramdef>string <parameter>val</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_add_search_limit</function> retourne &true; + en cas de succès, &false; en cas d'erreur. + <function>udm_add_search_limit</function> ajoute différentes limitations + de recherche. + </para> + <para> + <parameter>agent</parameter> - un identifiant d'Agent, + obtenu après un appel à <function>udm_alloc_agent</function>. + </para> + <para> + <parameter>var</parameter> - nom du paramètre de limitation. + </para> + <para> + <parameter>val</parameter> - Valeur du paramètre sus-cité. + </para> + <para> + <parameter>var</parameter> peut prendre les valeurs suivantes : + </para> + <itemizedlist> + <listitem> + <simpara> + UDM_LIMIT_URL - Définit les limitations sur les URL, pour + limiter les recherches à une partie de la base. Ce + paramètre supporte les jokers SQL '%' et '_' : '%' remplace + n'importe quel nombre de caractères, même zéro + caractères, et '_' remplace exactement un caractère. + Par exemple, <literal>'http://my.domain.__/catalog'</literal> peut + remplacer <literal>http://my.domain.ru/catalog</literal> ou + <literal>http://my.domain.ua/catalog</literal>. </simpara> - </listitem> - <listitem> - <simpara> - UDM_LIMIT_TAG - Définit les limitations par étiquettes. Lors de l'indexation, - vous pouvez assigner des étiquettes sur différentes parties d'un site. - Les étiquettes de mnoGoSearch 3.1.x sont des lignes, qui peuvent contenir les - jokers '%' et '_' : '%' remplace n'importe quel nombre de caractères, - même zéro caractères, et '_' remplace exactement un caractère. - Par exemple, si vous avez les étiquettes ABCD et ABCE, la limitation de recherche - <literal>ABC_</literal> limitera la recherche à ces deux étiquettes; + </listitem> + <listitem> + <simpara> + UDM_LIMIT_TAG - Définit les limitations par étiquettes. + Lors de l'indexation, vous pouvez assigner des étiquettes sur + différentes parties d'un site. Les étiquettes de + mnoGoSearch 3.1.x sont des lignes, qui peuvent contenir les jokers + '%' et '_' : '%' remplace n'importe quel nombre de caractères, + même zéro caractères, et '_' remplace exactement + un caractère. Par exemple, si vous avez les étiquettes + ABCD et ABCE, la limitation de recherche <literal>ABC_</literal> + limitera la recherche à ces deux étiquettes; </simpara> - </listitem> - <listitem> - <simpara> + </listitem> + <listitem> + <simpara> UDM_LIMIT_LANG - Définit les limitations par langue. </simpara> - </listitem> - <listitem> - <simpara> - UDM_LIMIT_CAT - Définit les limitations par catégorie. Les catégories sont - 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 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>. + </listitem> + <listitem> + <simpara> + UDM_LIMIT_CAT - Définit les limitations par catégorie. + Les catégories sont 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 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>. </simpara> - </listitem> - <listitem> - <simpara> - UDM_LIMIT_DATE - Définit les limitations par date de modification du document. + </listitem> + <listitem> + <simpara> + UDM_LIMIT_DATE - Définit les limitations par date de + modification du document. </simpara> - <simpara> - Format de la valeur : une chaîne de caractères, dont le premier caractère est - < ou >, puis une date au format unixtimestamp. Par exemple : + <simpara> + Format de la valeur : une chaîne de caractères, dont le + premier caractère est < ou >, puis une date au format + unixtimestamp. Par exemple : </simpara> - <simpara> - Udm_Add_Search_Limit($udm,UDM_LIMIT_DATE,"<908012006"); + <simpara> + Udm_Add_Search_Limit($udm,UDM_LIMIT_DATE,"<908012006"); </simpara> - <simpara> - Si > est utilisé, la recherche sera limitée aux documents dont la - date de modification est plus grande que celle qui a été entrée. - Avec <, c'est le contraire. - </simpara> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - <refentry id="function.udm_alloc_agent"> - <refnamediv> - <refname>Udm_Alloc_Agent</refname> - <refpurpose>Alloue une session mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_alloc_agent</function></funcdef> - <paramdef>string <parameter>dbaddr</parameter></paramdef> - <paramdef>string - <parameter> - <optional>dbmode</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_alloc_agent</function> retourne un agent mnogosearch - en cas de succès, &false; en cas d'erreur. - <function>udm_alloc_agent</function> crée une session avec les - paramètres de base de données. - </para> - <para> - <parameter>dbaddr</parameter> est une description de base de données - formaté comme une URL. Les options (type, hôte, nom de base de données , port, utilisateur - ou mot de passe) servent à se connecter à la base de données SQL. - Ne passez aucune valeur si vous souhaitez utiliser le support des fichiers - texte intégré. Sinon, utilisez le format : - <literal>DBAddr DBType:[//[DBUser[:DBPass]@]DBHost[:DBPort]]/DBName/</literal>. - Actuellement, les valeurs de DBType possibles sont : - mysql, pgsql, msql, solid, mssql, oracle, ibase. En fait, si vous avez ajouté - un support natif, cette option est inutile. Mais les utilisateurs ODBC doivent - spécifier une des valeurs supportées. Si votre type de base de données n'est pas - supporté, utilisez le terme "unknown". - </para> + <simpara> + Si > est utilisé, la recherche sera limitée aux + documents dont la date de modification est plus grande que celle qui + a été entrée. Avec <, c'est le contraire. + </simpara> + </listitem> + </itemizedlist> + </refsect1> + </refentry> + <refentry id="function.udm-cat-path"> + <refnamediv> + <refname>udm_cat_path</refname> + <refpurpose>Lit le chemin de la catégorie courante.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>udm_cat_path</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>string <parameter>category</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_cat_path</function> retourne un tableau listant les catégories + depuis la racine jusqu'à la catégorie courante. + </para> + <para> + Le paramètre <parameter>agent</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. + </para> + <para> + <parameter>category</parameter> - La catégorie courante : celle dont on veut le chemin. + </para> + <para> + <function>udm_cat_path</function> retourne un tableau avec le format suivant : + </para> + <para> + Le tableau est constitué de paires. Les index pairs contiennent les chemins de catégories, + les index impairs contiennent les noms des catégories correspondantes. + </para> + <para> + Par exemple, l'appel <literal>$array=udm_cat_path($agent, '02031D');</literal> + peut retourner le tableau suivant : + </para> + <literallayout> + $array[0] contiendra '' + $array[1] contiendra 'Root' + $array[2] contiendra '02' + $array[3] contiendra 'Sport' + $array[4] contiendra '0203' + $array[5] contiendra 'Foot' + $array[4] contiendra '02031D' + $array[5] contiendra 'PSG' + </literallayout> + <example> + <title> + Spécifier le chemin de la catégorie courante avec le format suivant : + '> Root > Sport > Foot > PSG' + </title> + <programlisting role="php"> +<?php + $cat_path_arr=Udm_Cat_Path($udm_agent,$cat); + $cat_path=''; + for ($i=0; $i<count($cat_path_arr); $i+=2) { + $path=$cat_path_arr[$i]; + $name=$cat_path_arr[$i+1]; + $cat_path .= " > <a href=\"$PHP_SELF?cat=$path\">$name</a> "; + } +> + </programlisting> + </example> + </refsect1> + </refentry> + <refentry id="function.udm-cat-list"> + <refnamediv> + <refname>udm_cat_list</refname> + <refpurpose>Liste toutes les catégories soeurs d'une catégorie.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>udm_cat_list</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>string <parameter>category</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_cat_list</function> retourne un tableau contenant la liste de toutes + les catégories de même niveau que la catégorie courante. + </para> + <para> + Cette fonction est pratique pour réaliser des arbres à partir des catégories. + </para> + <para> + <function>udm_cat_list</function> retourne un tableau avec le format suivant : + </para> + <para> + Le tableau est constitué de paires. Les index pairs contiennent les chemins de catégories, + les index impairs contiennent les noms des catégories correspondantes. + </para> + <literallayout> + $array[0] contiendra '020300' + $array[1] contiendra 'Marseille' + $array[2] contiendra '020301' + $array[3] contiendra 'Lille' + $array[4] contiendra '020302' + $array[5] contiendra 'Lyon' + ... + etc. + </literallayout> + <simpara> + Ce qui peut être affiché comme ceci : + </simpara> + <literallayout> + Marseille + Lille + Lyon + ... + </literallayout> + <informalexample> + <programlisting role="php"> +<?php + $cat_list_arr=Udm_Cat_List($udm_agent,$cat); + $cat_list=''; + for ($i=0; $i<count($cat_list_arr); $i+=2) { + $path=$cat_list_arr[$i]; + $name=$cat_list_arr[$i+1]; + $cat_list .= "<a href=\"$PHP_SELF?cat=$path\">$name</a><br>"; + } +> + </programlisting> + </informalexample> + </refsect1> + </refentry> + <refentry id="function.udm_alloc_agent"> + <refnamediv> + <refname>Udm_Alloc_Agent</refname> + <refpurpose>Alloue une session mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_alloc_agent</function></funcdef> + <paramdef>string <parameter>dbaddr</parameter></paramdef> + <paramdef>string + <parameter> + <optional>dbmode</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_alloc_agent</function> retourne un agent mnogosearch + en cas de succès, &false; en cas d'erreur. + <function>udm_alloc_agent</function> crée une session avec les + paramètres de base de données. + </para> + <para> + <parameter>dbaddr</parameter> est une description de base de données + formaté comme une URL. Les options (type, hôte, nom de base de données, + port, utilisateur ou mot de passe) servent à se connecter à + la base de données SQL. + Ne passez aucune valeur si vous souhaitez utiliser le support des fichiers + texte intégré. Sinon, utilisez le format : + <literal>DBAddr DBType:[//[DBUser[:DBPass]@]DBHost[:DBPort]]/DBName/</literal>. + Actuellement, les valeurs de DBType possibles sont : + mysql, pgsql, msql, solid, mssql, oracle, ibase. En fait, si vous avez ajouté + un support natif, cette option est inutile. Mais les utilisateurs ODBC doivent + spécifier une des valeurs supportées. + Si votre type de base de données n'est pas + supporté, utilisez le terme "unknown". + </para> + <para> + <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 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 + le mode "crc", mais il stocke aussi les mots dans différentes tables suivant leur + taille. Format: DBMode single/multi/crc/crc-multi. + </para> + <note> <para> - <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 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 - le mode "crc", mais il stocke aussi les mots dans différentes tables suivant leur - taille. Format: DBMode single/multi/crc/crc-multi. - </para> - <note> - <para> <parameter>dbaddr</parameter> et <parameter>dbmode</parameter> doit correspondre à ceux qui sont utilisés lors de l'indexation. - </para> - </note> - <note> - <para> - En réalité, <function>udm_alloc_agent</function> n'ouvre - pas de connexion, et donc, ne vérifie ni le nom d'utilisateur, - ni le mot de passe. - </para> - </note> - </refsect1> - </refentry> - <refentry id="function.udm-api-version"> - <refnamediv> - <refname>udm_api_version</refname> - <refpurpose>Lit la version des API mnoGoSearch.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_api_version</function></funcdef> - <void/> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_api_version</function> retourne le numéro de version - des API mnoGoSearch. Par exemple, si mnoGosearch 3.1.10 est utilisé, - <function>udm_api_version</function> retournera <literal>30110</literal>. </para> + </note> + <note> <para> - <function>udm_api_version</function> permet aux utilisateurs d'identifier - quelles sont les API disponibles. Par exemple, <function>udm_get_doc_count</function> - n'est disponible qu'à partir de mnoGoSearch 3.1.11. + En réalité, <function>udm_alloc_agent</function> n'ouvre + pas de connexion, et donc, ne vérifie ni le nom d'utilisateur, + ni le mot de passe. </para> - <simpara>Exemple avec <function>udm_api_version</function></simpara> - <informalexample> + </note> + </refsect1> + </refentry> + <refentry id="function.udm-api-version"> + <refnamediv> + <refname>udm_api_version</refname> + <refpurpose>Lit la version des API mnoGoSearch.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_api_version</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_api_version</function> retourne le numéro de version + des API mnoGoSearch. Par exemple, si mnoGosearch 3.1.10 est utilisé, + <function>udm_api_version</function> retournera <literal>30110</literal>. + </para> + <para> + <function>udm_api_version</function> permet aux utilisateurs d'identifier + quelles sont les API disponibles. Par exemple, <function>udm_get_doc_count</function> + n'est disponible qu'à partir de mnoGoSearch 3.1.11. + </para> + <simpara>Exemple avec <function>udm_api_version</function></simpara> + <informalexample> <programlisting role="C"> - if (Udm_Api_Version() >= 30111) { - print "Total number of urls in database: ".Udm_Get_Doc_Count($udm)."<br>\n"; - } - </programlisting> - </informalexample> - </refsect1> - </refentry> - <refentry id="function.udm-clear-search-limits"> - <refnamediv> - <refname>udm_clear_search_limits</refname> - <refpurpose>Annule toutes les limitations de recherche</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_clear_search_limits</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_clear_search_limits</function> annule toutes les limitations - de recherche imposées, et retourne &true;. - </para> - </refsect1> - </refentry> - <refentry id="function.udm_errno"> - <refnamediv> - <refname>Udm_Errno</refname> - <refpurpose>Numéro d'erreur mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_errno</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_errno</function> retourne le numéro d'erreur mnoGoSearch, - ou bien <literal>0</literal> sinon. - </para> - <para> - Le paramètre <parameter>agent</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. - </para> - <para> - <function>udm_errno</function> retourne le numéro de l'erreur - généré par l'agent <parameter>agent</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.udm_error"> - <refnamediv> - <refname>Udm_Error</refname> - <refpurpose>Message d'erreur mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>udm_error</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_errno</function> retourne le message d'erreur mnoGoSearch, - ou bien une chaîne vide sinon. - </para> - <para> - Le paramètre <parameter>agent</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. - </para> - <para> - <function>udm_error</function> retourne le numéro de l'erreur - généré par l'agent <parameter>agent</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.udm_find"> - <refnamediv> - <refname>Udm_Find</refname> - <refpurpose>Effectue une recherche</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_find</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - <paramdef>string <parameter>query</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_add_search_limit</function> retourne - &true; en cas de succès, et - &false; en cas d'erreur. - </para> - <para> - La recherche en elle-même. Le premier argument <parameter>agent</parameter> - est la session, le second est la <parameter>query</parameter>. - Pour rechercher, entrez les mots avec lesquels que vous voulez - faire une recherche, puis cliquez sur le bouton d'envoi. - Par exemple, "<literal>mysql odbc</literal>". Vous ne devez - pas utiliser de guillemets doubles <literal>"</literal>, car - ils sont utilisés par mnoGoSearch pour séparer une requête en - 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 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 - l'un ou l'autre des mots. Si vous voulez accéder aux fonctions - avancées de recherche, vous pouvez utiliser le mode "BOOL", qui - vous permet d'entrer directement des requêtes. - </para> - <para> - mnoGoSearch utilise les opérateurs booléean suivants : - </para> - <para> - & - AND, ET logique. Par exemple, "mysql & - odbc". mnoGoSearch recherche toutes les URL qui contiennent - à la fois les mots "mysql" et "odbc". - </para> - <para> - | - OR, OU logique. Par exemple, "mysql | - odbc". mnoGoSearch recherche toutes les URL qui contiennent - soit "mysql", soit "odbc". - </para> - <para> - ~ - NOT, NON logique. Par exemple, "mysql & ~odbc". - mnoGoSearch recherche toutes les URL qui contiennent le - mot "mysql" mais ne contiennent pas le mot "odbc". - Attention : la requête "~odbc" ne trouvera rien! - </para> - <para> - () - Groupage de commandes pour les requêtes complexes : par exemple, - "(mysql | msql) & ~postgres". Le mode par requête est - simple et puissant à la fois. Vous pouvez utiliser les commandes - booléennes habituelles avec ce mode. - </para> - </refsect1> - </refentry> - <refentry id="function.udm_free_agent"> - <refnamediv> - <refname>Udm_Free_Agent</refname> - <refpurpose>Détruit une session mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_free_agent</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_free_res</function> retourne &true; en - cas de succès, &false; sinon. - </para> - <para> - Le paramètre <parameter>res</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. - </para> - <para> - <function>udm_free_agent</function> détruit l'agent de recherche - créé par <function>udm_alloc_agent</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.udm-free-ispell-data"> - <refnamediv> - <refname>udm_free_ispell_data</refname> - <refpurpose>Libère la mémoire allouée pour ispell</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_free_ispell_data</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_free_ispell_data</function> retourne toujours &true;. - </para> - <para> - <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à - <function>udm_alloc_agent</function>. - </para> - <note> +if (Udm_Api_Version() >= 30111) { + print "Total number of urls in database: ".Udm_Get_Doc_Count($udm)."<br>\n"; +} + </programlisting> + </informalexample> + </refsect1> + </refentry> + <refentry id="function.udm-clear-search-limits"> + <refnamediv> + <refname>udm_clear_search_limits</refname> + <refpurpose>Annule toutes les limitations de recherche</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_clear_search_limits</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_clear_search_limits</function> annule toutes les limitations + de recherche imposées, et retourne &true;. + </para> + </refsect1> + </refentry> + <refentry id="function.udm_errno"> + <refnamediv> + <refname>Udm_Errno</refname> + <refpurpose>Numéro d'erreur mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_errno</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_errno</function> retourne le numéro d'erreur mnoGoSearch, + ou bien <literal>0</literal> sinon. + </para> + <para> + Le paramètre <parameter>agent</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. + </para> + <para> + <function>udm_errno</function> retourne le numéro de l'erreur + généré par l'agent <parameter>agent</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.udm_error"> + <refnamediv> + <refname>Udm_Error</refname> + <refpurpose>Message d'erreur mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>udm_error</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_errno</function> retourne le message d'erreur mnoGoSearch, + ou bien une chaîne vide sinon. + </para> + <para> + Le paramètre <parameter>agent</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. + </para> + <para> + <function>udm_error</function> retourne le numéro de l'erreur + généré par l'agent <parameter>agent</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.udm_find"> + <refnamediv> + <refname>Udm_Find</refname> + <refpurpose>Effectue une recherche</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_find</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_add_search_limit</function> retourne + &true; en cas de succès, et + &false; en cas d'erreur. + </para> + <para> + La recherche en elle-même. Le premier argument <parameter>agent</parameter> + est la session, le second est la <parameter>query</parameter>. + Pour rechercher, entrez les mots avec lesquels que vous voulez + faire une recherche, puis cliquez sur le bouton d'envoi. + Par exemple, "<literal>mysql odbc</literal>". Vous ne devez + pas utiliser de guillemets doubles <literal>"</literal>, car + ils sont utilisés par mnoGoSearch pour séparer une requête en + 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 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 + l'un ou l'autre des mots. Si vous voulez accéder aux fonctions + avancées de recherche, vous pouvez utiliser le mode "BOOL", qui + vous permet d'entrer directement des requêtes. + </para> + <para> + mnoGoSearch utilise les opérateurs booléean suivants : + </para> + <para> + & - AND, ET logique. Par exemple, "mysql & + odbc". mnoGoSearch recherche toutes les URL qui contiennent + à la fois les mots "mysql" et "odbc". + </para> + <para> + | - OR, OU logique. Par exemple, "mysql | + odbc". mnoGoSearch recherche toutes les URL qui contiennent + soit "mysql", soit "odbc". + </para> + <para> + ~ - NOT, NON logique. Par exemple, "mysql & ~odbc". + mnoGoSearch recherche toutes les URL qui contiennent le + mot "mysql" mais ne contiennent pas le mot "odbc". + Attention : la requête "~odbc" ne trouvera rien! + </para> + <para> + () - Groupage de commandes pour les requêtes complexes : par exemple, + "(mysql | msql) & ~postgres". Le mode par requête est + simple et puissant à la fois. Vous pouvez utiliser les commandes + booléennes habituelles avec ce mode. + </para> + </refsect1> + </refentry> + <refentry id="function.udm_free_agent"> + <refnamediv> + <refname>Udm_Free_Agent</refname> + <refpurpose>Détruit une session mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_free_agent</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_free_res</function> retourne &true; en + cas de succès, &false; sinon. + </para> + <para> + Le paramètre <parameter>res</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. + </para> + <para> + <function>udm_free_agent</function> détruit l'agent de recherche + créé par <function>udm_alloc_agent</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.udm-free-ispell-data"> + <refnamediv> + <refname>udm_free_ispell_data</refname> + <refpurpose>Libère la mémoire allouée pour ispell</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_free_ispell_data</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_free_ispell_data</function> retourne toujours &true;. + </para> + <para> + <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à + <function>udm_alloc_agent</function>. + </para> + <note> <para> <function>udm_free_ispell_data</function> est supportée à partir de la version 3.1.12 de mnoGoSearch et elle ne fait strictement rien avec les versions précédentes. </para> - </note> - </refsect1> - </refentry> - <refentry id="function.udm_free_res"> - <refnamediv> - <refname>Udm_Free_Res</refname> - <refpurpose>Libère un résultat mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_free_res</function></funcdef> - <paramdef>int <parameter>res</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_free_res</function> retourne &true; en - cas de succès, &false; sinon. - </para> - <para> - Le paramètre <parameter>res</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. - </para> - <para> - <function>udm_free_res</function> libère la mémoire de tous - les résultats générés. - </para> - </refsect1> - </refentry> - <refentry id="function.udm-get-doc-count"> - <refnamediv> - <refname>udm_get_doc_count</refname> - <refpurpose>Lit le nombre total de documents dans les bases.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_get_doc_count</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_get_doc_count</function> retourne le nombre de document - dans les bases de données. - </para> - <para> - <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à - <function>udm_alloc_agent</function>. - </para> - <note> + </note> + </refsect1> + </refentry> + <refentry id="function.udm_free_res"> + <refnamediv> + <refname>Udm_Free_Res</refname> + <refpurpose>Libère un résultat mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_free_res</function></funcdef> + <paramdef>int <parameter>res</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_free_res</function> retourne &true; en + cas de succès, &false; sinon. + </para> + <para> + Le paramètre <parameter>res</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. + </para> + <para> + <function>udm_free_res</function> libère la mémoire de tous + les résultats générés. + </para> + </refsect1> + </refentry> + <refentry id="function.udm-get-doc-count"> + <refnamediv> + <refname>udm_get_doc_count</refname> + <refpurpose>Lit le nombre total de documents dans les bases.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_get_doc_count</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_get_doc_count</function> retourne le nombre de document + dans les bases de données. + </para> + <para> + <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à + <function>udm_alloc_agent</function>. + </para> + <note> <simpara> - <function>udm_get_doc_count</function> est supporté à partir de la version - mnoGoSearch 3.1.11 ou plus récent. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.udm_get_res_field"> - <refnamediv> - <refname>Udm_Get_Res_Field</refname> - <refpurpose>Lit un champs de résultat mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_get_res_field</function></funcdef> - <paramdef>int <parameter>res</parameter></paramdef> - <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>int <parameter>field</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_alloc_agent</function> retourne la valeur du - champs <parameter>field</parameter> dans la ligne <parameter>row</parameter>, - du résultat <parameter>res</parameter>, et - &false; sinon. - </para> - <para> - Le paramètre <parameter>res</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. - </para> - <para> - Le paramètre <parameter>row</parameter> est le numéro du lien dans - la page courante. Il peut valoir de 0 jusqu'à - <parameter>UDM_PARAM_NUM_ROWS</parameter>. - </para> - <para> - Le paramètre <parameter>field</parameter> est l'identifiant de - champs, et peut prendre l'une des valeurs suivantes : - </para> - <itemizedlist> - <listitem> - <simpara> - UDM_FIELD_URL - Champs URL + <function>udm_get_doc_count</function> est supporté à + partir de la version mnoGoSearch 3.1.11 ou plus récent. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.udm_get_res_field"> + <refnamediv> + <refname>Udm_Get_Res_Field</refname> + <refpurpose>Lit un champs de résultat mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_get_res_field</function></funcdef> + <paramdef>int <parameter>res</parameter></paramdef> + <paramdef>int <parameter>row</parameter></paramdef> + <paramdef>int <parameter>field</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_alloc_agent</function> retourne la valeur du + champs <parameter>field</parameter> dans la ligne <parameter>row</parameter>, + du résultat <parameter>res</parameter>, et + &false; sinon. + </para> + <para> + Le paramètre <parameter>res</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. + </para> + <para> + Le paramètre <parameter>row</parameter> est le numéro du lien dans + la page courante. Il peut valoir de 0 jusqu'à + <parameter>UDM_PARAM_NUM_ROWS</parameter>. + </para> + <para> + Le paramètre <parameter>field</parameter> est l'identifiant de + champs, et peut prendre l'une des valeurs suivantes : + </para> + <itemizedlist> + <listitem> + <simpara> + UDM_FIELD_URL - Champs URL </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_CONTENT - Champs "Content-type" (par exemple, "text/html"). + </listitem> + <listitem> + <simpara> + UDM_FIELD_CONTENT - Champs "Content-type" (par exemple, "text/html"). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_TITLE - Titre du document. + </listitem> + <listitem> + <simpara> + UDM_FIELD_TITLE - Titre du document. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_KEYWORDS - Mots clés du document (balise META KEYWORDS). + </listitem> + <listitem> + <simpara> + UDM_FIELD_KEYWORDS - Mots clés du document (balise META + KEYWORDS). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_DESC - Description du document (balise META DESCRIPTION). + </listitem> + <listitem> + <simpara> + UDM_FIELD_DESC - Description du document (balise META DESCRIPTION). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_TEXT - Corps du document (balise body, les premières lignes - pour donner une idée du document). + </listitem> + <listitem> + <simpara> + UDM_FIELD_TEXT - Corps du document (balise body, les premières + lignes pour donner une idée du document). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_SIZE - Taille du document. + </listitem> + <listitem> + <simpara> + UDM_FIELD_SIZE - Taille du document. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_URLID - Identifiant unique de l'URL. + </listitem> + <listitem> + <simpara> + UDM_FIELD_URLID - Identifiant unique de l'URL. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_RATING - Score de la page (calculé par mnoGoSearch). + </listitem> + <listitem> + <simpara> + UDM_FIELD_RATING - Score de la page (calculé par mnoGoSearch). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_MODIFIED - Date de modification au format unixtimestamp. + </listitem> + <listitem> + <simpara> + UDM_FIELD_MODIFIED - Date de modification au format unixtimestamp. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_ORDER - Le nombre de documents trouvés. + </listitem> + <listitem> + <simpara> + UDM_FIELD_ORDER - Le nombre de documents trouvés. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_CRC - La valeur CRC du document. + </listitem> + <listitem> + <simpara> + UDM_FIELD_CRC - La valeur CRC du document. </simpara> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - <refentry id="function.udm_get_res_param"> - <refnamediv> - <refname>Udm_Get_Res_Param</refname> - <refpurpose>Lit les paramètres de résultats mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_get_res_param</function></funcdef> - <paramdef>int <parameter>res</parameter></paramdef> - <paramdef>int <parameter>param</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_get_res_param</function> retourne les paramètres - de résultat en cas de succès, &false; en cas d'erreur. - </para> - <para> - Le paramètre <parameter>res</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. - </para> - <para> - Le paramètre <parameter>param</parameter> peut prendre les valeurs - suivantes : - </para> - <itemizedlist> - <listitem> - <simpara> - UDM_PARAM_NUM_ROWS - nombre de liens trouvés dans le groupe de résultat courant. - C'est la valeur de UDM_PARAM_PAGE_SIZE pour tous les groupes, sauf le dernier. + </listitem> + </itemizedlist> + </refsect1> + </refentry> + <refentry id="function.udm_get_res_param"> + <refnamediv> + <refname>Udm_Get_Res_Param</refname> + <refpurpose>Lit les paramètres de résultats mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_get_res_param</function></funcdef> + <paramdef>int <parameter>res</parameter></paramdef> + <paramdef>int <parameter>param</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_get_res_param</function> retourne les paramètres + de résultat en cas de succès, &false; en cas d'erreur. + </para> + <para> + Le paramètre <parameter>res</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. + </para> + <para> + Le paramètre <parameter>param</parameter> peut prendre les valeurs + suivantes : + </para> + <itemizedlist> + <listitem> + <simpara> + UDM_PARAM_NUM_ROWS - nombre de liens trouvés dans le groupe de + résultat courant. C'est la valeur de UDM_PARAM_PAGE_SIZE pour + tous les groupes, sauf le dernier. </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_FOUND - Nombre total de résultats trouvés. + </listitem> + <listitem> + <simpara> + UDM_PARAM_FOUND - Nombre total de résultats trouvés. </simpara> - </listitem> - <listitem> - <simpara> - 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" + </listitem> + <listitem> + <simpara> + 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> - <listitem> - <simpara> - UDM_PARAM_SEARCHTIME - Temps de recherche en secondes + </listitem> + <listitem> + <simpara> + UDM_PARAM_SEARCHTIME - Temps de recherche en secondes </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_FIRST_DOC - le numéro du premier document affiché dans le groupe. + </listitem> + <listitem> + <simpara> + UDM_PARAM_FIRST_DOC - le numéro du premier document + affiché dans le groupe. </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_LAST_DOC - le numéro du dernier document affiché dans le groupe. + </listitem> + <listitem> + <simpara> + UDM_PARAM_LAST_DOC - le numéro du dernier document + affiché dans le groupe. </simpara> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - <refentry id="function.udm-load-ispell-data"> - <refnamediv> - <refname>udm_load_ispell_data</refname> - <refpurpose>Charge les données ispell</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_load_ispell_data</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - <paramdef>int <parameter>var</parameter></paramdef> - <paramdef>string <parameter>val1</parameter></paramdef> - <paramdef>string <parameter>val2</parameter></paramdef> - <paramdef>int <parameter>flag</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_load_ispell_data</function> charge des données ispell. - <function>udm_load_ispell_data</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. - </para> - <para> - <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à - <function>udm_alloc_agent</function>. - </para> - <para> - <parameter>var</parameter> - paramètre indiquant la source des données ispell. - </para> - <para> - Après avoir utilisé cette fonction, pensez à libérer les données de la - mémoire avec <function>udm_free_ispell_data</function>, même si vous - utilisez le mode UDM_ISPELL_TYPE_SERVER. - </para> - <para> - Le mode de plus rapide est UDM_ISPELL_TYPE_SERVER. UDM_ISPELL_TYPE_TEXT est - plus lent, et UDM_ISPELL_TYPE_DB est le plus lent. Ce classement est vrai - pour mnoGoSearch 3.1.10 - 3.1.11. Il est prévu d'accélérer le mode DB dans les - versions futures, et cela sera plus rapide que le mode TEXT. - </para> - <itemizedlist> - <listitem> - <simpara> - UDM_ISPELL_TYPE_DB indique que les données ispell doivent être chargée depuis la - base SQL. Dans ce cas, les paramètres <parameter>val1</parameter> et - <parameter>val2</parameter> sont ignorés et doivent être laissés vides. - <parameter>flag</parameter> doit valoir <literal>1</literal>. + </listitem> + </itemizedlist> + </refsect1> + </refentry> + <refentry id="function.udm-load-ispell-data"> + <refnamediv> + <refname>udm_load_ispell_data</refname> + <refpurpose>Charge les données ispell</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_load_ispell_data</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>int <parameter>var</parameter></paramdef> + <paramdef>string <parameter>val1</parameter></paramdef> + <paramdef>string <parameter>val2</parameter></paramdef> + <paramdef>int <parameter>flag</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_load_ispell_data</function> charge des données ispell. + <function>udm_load_ispell_data</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. + </para> + <para> + <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à + <function>udm_alloc_agent</function>. + </para> + <para> + <parameter>var</parameter> - paramètre indiquant la source des données ispell. + </para> + <para> + Après avoir utilisé cette fonction, pensez à libérer les données de la + mémoire avec <function>udm_free_ispell_data</function>, même si vous + utilisez le mode UDM_ISPELL_TYPE_SERVER. + </para> + <para> + Le mode de plus rapide est UDM_ISPELL_TYPE_SERVER. UDM_ISPELL_TYPE_TEXT est + plus lent, et UDM_ISPELL_TYPE_DB est le plus lent. Ce classement est vrai + pour mnoGoSearch 3.1.10 - 3.1.11. Il est prévu d'accélérer le mode DB dans les + versions futures, et cela sera plus rapide que le mode TEXT. + </para> + <itemizedlist> + <listitem> + <simpara> + UDM_ISPELL_TYPE_DB indique que les données ispell doivent + être chargée depuis la base SQL. Dans ce cas, les + paramètres <parameter>val1</parameter> et + <parameter>val2</parameter> sont ignorés et doivent être + laissés vides. <parameter>flag</parameter> doit valoir + <literal>1</literal>. </simpara> - <note> + <note> <para> <parameter>flag</parameter> indique qu'après le chargement des données ispell - à partir de la source, elles doivent être triées (c'est nécessaire au bon + à partir de la source, elles doivent être triées (c'est nécessaire au bon fonctionnement d'ispell). Dans le cas où vous chargez les données depuis un fichier, - il peut y avoir plusieurs appels à <function>udm_load_ispell_data</function>, + il peut y avoir plusieurs appels à <function>udm_load_ispell_data</function>, et il ne vaut pas la peine de trier les valeurs après chaque appel, mais uniquement à la fin. Etant donné qu'en mode DB, toutes les données sont chargées en une seule fois, ce paramètre doit avoir la valeur de <literal>1</literal>. Dans ce mode, en @@ -715,350 +867,394 @@ &false; et le code d'erreur, avec son message, seront accessibles avec <function>udm_error</function> et <function>udm_errno</function>. </para> - </note> + </note> <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> - <informalexample> - <programlisting role="C"> - if (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_DB,'','',1)) { - printf("Error #%d: '%s'\n",Udm_Errno($udm),Udm_Error($udm)); - exit; - } - </programlisting> - </informalexample> - </listitem> - <listitem> + <informalexample> + <programlisting role="C"> +if (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_DB,'','',1)) { + printf("Error #%d: '%s'\n",Udm_Errno($udm),Udm_Error($udm)); + exit; +} + </programlisting> + </informalexample> + </listitem> + <listitem> <para> - UDM_ISPELL_TYPE_AFFIX indique que les données ispell doivent être chargée - depuis un fichier et initie le chargement. Dans ce cas, <parameter>val1</parameter> - définit le code de langue en deux lettre, et <parameter>val2</parameter> est le chemin - jusqu'aux fichiers. Notez que si vous utilisez un chemin relatif, le module recherche - les fichiers non pas dans UDM_CONF_DIR, mais directement avec le chemin courant, - où le script est exécuté. En cas d'erreur 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 <parameter>flag</parameter>. - </para> - <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> - <informalexample> - <programlisting role="C"> + UDM_ISPELL_TYPE_AFFIX indique que les données ispell doivent être chargée + depuis un fichier et initie le chargement. Dans ce cas, <parameter>val1</parameter> + définit le code de langue en deux lettre, et <parameter>val2</parameter> est le chemin + jusqu'aux fichiers. Notez que si vous utilisez un chemin relatif, le module recherche + les fichiers non pas dans UDM_CONF_DIR, mais directement avec le chemin courant, + où le script est exécuté. En cas d'erreur 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 <parameter>flag</parameter>. + </para> + <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> + <informalexample> + <programlisting role="C"> if ((! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'en','/opt/ispell/en.aff',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'ru','/opt/ispell/ru.aff',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'en','/opt/ispell/en.dict',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'ru','/opt/ispell/ru.dict',1))) { exit; } - </programlisting> - </informalexample> - <note> - <para> - <parameter>flag</parameter> prend la valeur <literal>1</literal> si c'est le dernier appel - à cette fonction. - </para> - </note> - </listitem> - <listitem> - <para> - UDM_ISPELL_TYPE_SPELL indique que les données ispell doivent être chargées - depuis un fichier, et initie le chargement du dictionnaire. Dans ce cas, - <parameter>val1</parameter> définit le code langue sur deux lettres, et - <parameter>val2</parameter> le chemin du fichier. Notez que si vous utilisez - un chemin relatif, le module recherche les fichiers non pas dans UDM_CONF_DIR, - mais directement avec le chemin courant, où le script est exécuté. En cas d'erreur - 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 - <parameter>flag</parameter>. - </para> + </programlisting> + </informalexample> + <note> + <para> + <parameter>flag</parameter> prend la valeur <literal>1</literal> si c'est le dernier appel + à cette fonction. + </para> + </note> + </listitem> + <listitem> + <para> + UDM_ISPELL_TYPE_SPELL indique que les données ispell doivent être chargées + depuis un fichier, et initie le chargement du dictionnaire. Dans ce cas, + <parameter>val1</parameter> définit le code langue sur deux lettres, et + <parameter>val2</parameter> le chemin du fichier. Notez que si vous utilisez + un chemin relatif, le module recherche les fichiers non pas dans UDM_CONF_DIR, + mais directement avec le chemin courant, où le script est exécuté. En cas d'erreur + 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 + <parameter>flag</parameter>. + </para> <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> - <informalexample> - <programlisting role="C"> + <informalexample> + <programlisting role="C"> if ((! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'en','/opt/ispell/en.aff',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'ru','/opt/ispell/ru.aff',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'en','/opt/ispell/en.dict',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'ru','/opt/ispell/ru.dict',1))) { exit; } - </programlisting> - </informalexample> - <note> - <para> - <parameter>flag</parameter> prend la valeur <literal>1</literal> si c'est le dernier appel - à cette fonction. - </para> - </note> - </listitem> - <listitem> - <para> - UDM_ISPELL_TYPE_SERVER active le support des serveurs ispell. <parameter>val1</parameter> - indique alors l'adresse de l'hôte qui supporte le serveur ispall. <parameter>val2</parameter> - n'est pas encore utilisé, mais dans les cas futurs, il indiquera le numéro de port - utilisé par le serveur ispell. <parameter>flag</parameter> n'est pas utile, car les - données sont déjà triées. - </para> - <para> - Les serveurs Spelld lisent les données d'orthographe dans une - configuration séparée (par défaut <filename>/usr/local/mnogosearch/etc/spelld.conf</filename>), - 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 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). - </para> - <para> - <function>udm_load_ispell_data</function> en mode UDM_ISPELL_TYPE_SERVER - ne charge pas vraiment les données ispell, mais définit simplement l'adresse - du serveur. En fait, le serveur sera automatiquement utilisé par - <function>udm_find</function> lors des recherches. En cas d'erreur, - (par exemple si le serveur ispell ne fonctionne pas ou que l'hôte indiqué - est invalide), la conversion sera annulée, mais aucun message d'erreur ne - sera affiché. - </para> - <note> - <para> - Cette fonction est disponible à partir de mnoGoSearch 3.1.12. - </para> - </note> - <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> - <informalexample> - <programlisting role="C"> + </programlisting> + </informalexample> + <note> + <para> + <parameter>flag</parameter> prend la valeur <literal>1</literal> si c'est le dernier appel + à cette fonction. + </para> + </note> + </listitem> + <listitem> + <para> + UDM_ISPELL_TYPE_SERVER active le support des serveurs ispell. <parameter>val1</parameter> + indique alors l'adresse de l'hôte qui supporte le serveur ispall. <parameter>val2</parameter> + n'est pas encore utilisé, mais dans les cas futurs, il indiquera le numéro de port + utilisé par le serveur ispell. <parameter>flag</parameter> n'est pas utile, car les + données sont déjà triées. + </para> + <para> + Les serveurs Spelld lisent les données d'orthographe dans une + configuration séparée (par défaut <filename>/usr/local/mnogosearch/etc/spelld.conf</filename>), + 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 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). + </para> + <para> + <function>udm_load_ispell_data</function> en mode UDM_ISPELL_TYPE_SERVER + ne charge pas vraiment les données ispell, mais définit simplement l'adresse + du serveur. En fait, le serveur sera automatiquement utilisé par + <function>udm_find</function> lors des recherches. En cas d'erreur, + (par exemple si le serveur ispell ne fonctionne pas ou que l'hôte indiqué + est invalide), la conversion sera annulée, mais aucun message d'erreur ne + sera affiché. + </para> + <note> + <para> + Cette fonction est disponible à partir de mnoGoSearch 3.1.12. + </para> + </note> + <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> + <informalexample> + <programlisting role="C"> if (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SERVER,'','',1)) { - printf("Error loading ispell data from server<br>\n"); - exit; - } - </programlisting> - </informalexample> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - <refentry id="function.udm-set-agent-param"> - <refnamediv> - <refname>udm_set_agent_param</refname> - <refpurpose>Modifie les paramètres de l'agent mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_set_agent_param</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - <paramdef>int <parameter>var</parameter></paramdef> - <paramdef>string <parameter>val</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_set_agent_param</function> retourne &true; en - cas de succès et &false; sinon. <function>udm_set_agent_param</function> - définit les paramètres de l'agent mnoGoSearch. - </para> - <simpara> - Les paramètres suivants et leurs valeurs sont disponibles : + printf("Error loading ispell data from server<br>\n"); + exit; + } + </programlisting> + </informalexample> + </listitem> + </itemizedlist> + </refsect1> + </refentry> + <refentry id="function.udm-set-agent-param"> + <refnamediv> + <refname>udm_set_agent_param</refname> + <refpurpose>Modifie les paramètres de l'agent mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_set_agent_param</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>int <parameter>var</parameter></paramdef> + <paramdef>string <parameter>val</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_set_agent_param</function> retourne &true; en + cas de succès et &false; sinon. <function>udm_set_agent_param</function> + définit les paramètres de l'agent mnoGoSearch. + </para> + <simpara> + Les paramètres suivants et leurs valeurs sont disponibles : </simpara> - <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, commençant à 0, avec UDM_PARAM_PAGE_SIZE - résultats par page). - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_PAGE_SIZE - Nombre de résultats affichés par page. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_SEARCH_MODE - Mode de recherche. Les valeurs suivantes sont disponibles : - UDM_MODE_ALL - recherche tous les mots; - UDM_MODE_ANY - recherche l'un des mots; - UDM_MODE_PHRASE - recherche une phrase; - UDM_MODE_BOOL - recherche booléenne. - Voir <function>udm_find</function> pour plus de détails sur les recherches booléennes. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_CACHE_MODE - Active/désactive le cache. Lorsque le cache est activé, le - moteur de recherche va stocker les résultats sur le disque. Lorque deux - requête seront similaires, il pourra retourner les résultats plus rapidement, - sans recherche. Valeurs disponibles : UDM_CACHE_ENABLED, UDM_CACHE_DISABLED. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_TRACK_MODE - Active le mode de suivi de requête. Depuis la version - 3.1.2, mnoGoSearch dispose d'un suivi de requête. Notez que ce suivi n'est implémenté - qu'avec les versions SQL et n'est pas disponible avec les bases de données - intégrées. Pour utiliser ce suivi, vous devez créer des tables de suivi. Pour mysql, - utilisez le script <filename>create/mysql/track.txt</filename>. Lorsque vous - effectuez une recherche avec l'interface, ces tables stockeront les mots recherchés - ainsi que le nombre de mots trouvés, et la date. Valeurs disponibles : - UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_PHRASE_MODE - indique si les index des bases de données utilise des - phrases( paramètre "phrase" dans indexer.conf). Valeurs disponibles : - UDM_PHRASE_ENABLED and UDM_PHRASE_DISABLED. - Notez bien que si la recherche par phrase est activé (UDM_PHRASE_ENABLED), - il est toujours possible de faire des recherches dans d'autres modes, - (ANY, ALL, BOOL ou PHRASE). En version 3.1.10 de mnoGoSearch, la recherche - par phrase n'est supportée que pour les modes SQL et intégré, tandis qu'en - 3.1.11, la recherche par phrase est supporté par le mode cache. - </simpara> - <simpara> - Exemple de recherche par phrase : - </simpara> - <simpara> - "Arizona desert" - Cette requete retourne tous les documents qui contiennent - les mots "Arizona desert" comme une phrase. Notez que vous devez mettre des - guillemets doubles autour des phrases. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_CHARSET - Définit le jeu de caractères local. Valeurs disponibles : - Tous les jeux supportés par mnoGoSearch. koi8-r, cp1251, ... - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_STOPFILE - Définit le nom et le chemin du fichier de - 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 - script courant. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_STOPTABLE - Charge la liste des mots ignorés depuis une table - SQL. Vous pouvez utiliser plusieurs tables SQL. Cette commande n'a aucun - effet si mnoGoSearch n'a pas été compilé avec le support de base - de données. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_WEIGHT_FACTOR - Représente le poids relatif des différentes - parties d'un document. Actuellement, le corps, titre, mots clés, descriptions - et url sont supportés. Pour activer cette fonctionnalité, utilisez - le degré 2 de *Weight commands, dans le fichier <filename>indexer.conf</filename>. - Imaginons que vous avez choisi les poids suivants : - </simpara> - <simpara>URLWeight 1</simpara> - <simpara>BodyWeight 2</simpara> - <simpara>TitleWeight 4</simpara> - <simpara>KeywordWeight 8</simpara> - <simpara>DescWeight 16</simpara> - <simpara> - 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'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> - La valeur de ce paramètre est une chaîne de chiffres héxadécimaux, sous la - forme ABCDE. Chaque chiffre est un facteur correspondant à un poids - affecté à une partie du document. Por la situation décrite ci-dessus, - </simpara> - <simpara>E est le facteur de poids 1 (URL)</simpara> - <simpara>D est le facteur de poids 2 (Corps)</simpara> - <simpara>C est le facteur de poids 4 (Titre)</simpara> - <simpara>B est le facteur de poids 8 (Mots clés)</simpara> - <simpara>A est le facteur de poids 16 (Description)</simpara> - <simpara> - Exemples: - </simpara> - <simpara> - UDM_PARAM_WEIGHT_FACTOR=00001 ne recherche que dans les URL. - </simpara> - <simpara> - UDM_PARAM_WEIGHT_FACTOR=00100 ne recherche que dans les Titres. - </simpara> - <simpara> - UDM_PARAM_WEIGHT_FACTOR=11100 recherche dans les Titres,Mots-clés,Description mais pas dans - le corps ou les URL. - </simpara> - <simpara> - UDM_PARAM_WEIGHT_FACTOR=F9421 recherche dans : - </simpara> - <simpara>Description avec un poids de 15 (F hex)</simpara> - <simpara>Keywords avec un poids de 9</simpara> - <simpara>Title avec un poids de 4</simpara> - <simpara>Body avec un poids de 2</simpara> - <simpara>URL avec un poids de 1</simpara> - <simpara> - Si UDM_PARAM_WEIGHT_FACTOR est omis, la valeur par défaut est - utilisée. + <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, commençant à 0, avec UDM_PARAM_PAGE_SIZE + résultats par page). + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_PAGE_SIZE - Nombre de résultats affichés par + page. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_SEARCH_MODE - Mode de recherche. Les valeurs suivantes sont + disponibles : UDM_MODE_ALL - recherche tous les mots; UDM_MODE_ANY - + recherche l'un des mots; UDM_MODE_PHRASE - recherche une phrase; + UDM_MODE_BOOL - recherche booléenne. Voir + <function>udm_find</function> pour plus de détails sur les + recherches booléennes. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_CACHE_MODE - Active/désactive le cache. Lorsque le + cache est activé, le moteur de recherche va stocker les + résultats sur le disque. Lorque deux requête seront + similaires, il pourra retourner les résultats plus rapidement, + sans recherche. Valeurs disponibles : UDM_CACHE_ENABLED, + UDM_CACHE_DISABLED. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_TRACK_MODE - Active le mode de suivi de requête. + Depuis la version 3.1.2, mnoGoSearch dispose d'un suivi de + requête. Notez que ce suivi n'est implémenté + qu'avec les versions SQL et n'est pas disponible avec les bases de + données intégrées. Pour utiliser ce suivi, vous + devez créer des tables de suivi. Pour mysql, utilisez le + script <filename>create/mysql/track.txt</filename>. Lorsque vous + effectuez une recherche avec l'interface, ces tables stockeront les + mots recherchés ainsi que le nombre de mots trouvés, et + la date. Valeurs disponibles : UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_PHRASE_MODE - indique si les index des bases de + données utilise des phrases( paramètre "phrase" dans + indexer.conf). Valeurs disponibles : UDM_PHRASE_ENABLED and + UDM_PHRASE_DISABLED. Notez bien que si la recherche par phrase est + activé (UDM_PHRASE_ENABLED), il est toujours possible de faire + des recherches dans d'autres modes, (ANY, ALL, BOOL ou PHRASE). En + version 3.1.10 de mnoGoSearch, la recherche par phrase n'est + supportée que pour les modes SQL et intégré, + tandis qu'en 3.1.11, la recherche par phrase est supporté par + le mode cache. + </simpara> + <simpara> + Exemple de recherche par phrase : + </simpara> + <simpara> + "Arizona desert" - Cette requete retourne tous les documents qui + contiennent les mots "Arizona desert" comme une phrase. Notez que + vous devez mettre des guillemets doubles autour des phrases. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_CHARSET - Définit le jeu de caractères local. + Valeurs disponibles : Tous les jeux supportés par mnoGoSearch. + koi8-r, cp1251, ... + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_STOPFILE - Définit le nom et le chemin du fichier de + 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 script courant. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_STOPTABLE - Charge la liste des mots ignorés depuis + une table SQL. Vous pouvez utiliser plusieurs tables SQL. Cette + commande n'a aucun effet si mnoGoSearch n'a pas été + compilé avec le support de base de données. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_WEIGHT_FACTOR - Représente le poids relatif des + différentes parties d'un document. Actuellement, le corps, + titre, mots clés, descriptions et url sont supportés. + Pour activer cette fonctionnalité, utilisez le degré 2 + de *Weight commands, dans le fichier + <filename>indexer.conf</filename>. Imaginons que vous avez choisi les + poids suivants : + </simpara> + <simpara>URLWeight 1</simpara> + <simpara>BodyWeight 2</simpara> + <simpara>TitleWeight 4</simpara> + <simpara>KeywordWeight 8</simpara> + <simpara>DescWeight 16</simpara> + <simpara> + 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'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> + La valeur de ce paramètre est une chaîne de chiffres + héxadécimaux, sous la forme ABCDE. Chaque chiffre est + un facteur correspondant à un poids affecté à + une partie du document. Por la situation décrite ci-dessus, + </simpara> + <simpara> + est le facteur de poids 1 (URL) + </simpara> + <simpara> + est le facteur de poids 2 (Corps) + </simpara> + <simpara> + est le facteur de poids 4 (Titre) + </simpara> + <simpara> + est le facteur de poids 8 (Mots clés) + </simpara> + <simpara> + est le facteur de poids 16 (Description) + </simpara> + <simpara> + Exemples: </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_WORD_MATCH - Recherche des mots. Vous pouvez utiliser ce - paramètre pour choisir le type de recherche de mots. Cette fonctionnalité - n'est valable qu'en mode "single" et "multi", avec les bases SQL ou intégrée. - Elle ne fonctionne pas en mode intégré, ni avec d'autres modes, car les CRC ne - supportent pas les recherches de sous-chaînes. Les valeurs disponibles sont : - </simpara> - <simpara>UDM_MATCH_BEGIN - début de mot;</simpara> + <simpara> + UDM_PARAM_WEIGHT_FACTOR=00001 ne recherche que dans les URL. + </simpara> + <simpara> + UDM_PARAM_WEIGHT_FACTOR=00100 ne recherche que dans les Titres. + </simpara> + <simpara> + UDM_PARAM_WEIGHT_FACTOR=11100 recherche dans les + Titres,Mots-clés,Description mais pas dans le corps ou les + URL. + </simpara> + <simpara> + UDM_PARAM_WEIGHT_FACTOR=F9421 recherche dans : + </simpara> + <simpara>Description avec un poids de 15 (F hex)</simpara> + <simpara>Keywords avec un poids de 9</simpara> + <simpara>Title avec un poids de 4</simpara> + <simpara>Body avec un poids de 2</simpara> + <simpara>URL avec un poids de 1</simpara> + <simpara> + Si UDM_PARAM_WEIGHT_FACTOR est omis, la valeur par défaut est + utilisée. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_WORD_MATCH - Recherche des mots. Vous pouvez utiliser ce + paramètre pour choisir le type de recherche de mots. Cette + fonctionnalité n'est valable qu'en mode "single" et "multi", + avec les bases SQL ou intégrée. Elle ne fonctionne pas + en mode intégré, ni avec d'autres modes, car les CRC ne + supportent pas les recherches de sous-chaînes. Les valeurs + disponibles sont : + </simpara> + <simpara>UDM_MATCH_BEGIN - début de mot;</simpara> <simpara>UDM_MATCH_END - fin de mot;</simpara> <simpara>UDM_MATCH_WORD - tout le mot;</simpara> <simpara>UDM_MATCH_SUBSTR - une sous-partie de mots.</simpara> - </listitem> - <listitem> - <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 - 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. - </simpara> - </listitem> - <listitem> - <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.. - 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 - utilisé pour des raisons d'orthographe. Pour activer ispell, vous devez charger les - données ispell avec la fonction <function>udm_load_ispell_data</function>. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_CROSS_WORDS - Active ou désactive le support "CROSS_WORDS". - Valeurs possibles : UDM_CROSS_WORDS_ENABLED et UDM_CROSS_WORDS_DISABLED. - </simpara> - <simpara> - La fonctionnalité "CROSS_WORDS" vous permet d'effectuer des recherches - dans les balises (entre <a href="xxx"> </a>), pour - utiliser le nom du lien. Ce mode fonctionne avec les bases de données - SQL et n'est pas supporté par les modes intégrés ou le cache. - </simpara> - <note> - <simpara> - CROSS_WORDS est supporté à partir de mnoGoSearch 3.1.11. - </simpara> - </note> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - </reference> + </listitem> + <listitem> + <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 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. + </simpara> + </listitem> + <listitem> + <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.. 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 utilisé pour des + raisons d'orthographe. Pour activer ispell, vous devez charger les + données ispell avec la fonction + <function>udm_load_ispell_data</function>. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_CROSS_WORDS - Active ou désactive le support + "CROSS_WORDS". Valeurs possibles : UDM_CROSS_WORDS_ENABLED et + UDM_CROSS_WORDS_DISABLED. + </simpara> + <simpara> + La fonctionnalité "CROSS_WORDS" vous permet d'effectuer des + recherches dans les balises (entre <a href="xxx"> </a>), + pour utiliser le nom du lien. Ce mode fonctionne avec les bases de + données SQL et n'est pas supporté par les modes + intégrés ou le cache. + </simpara> + <note> + <simpara> + CROSS_WORDS est supporté à partir de mnoGoSearch + 3.1.11. + </simpara> + </note> + </listitem> + <listitem> + <simpara> + UDM_PARAM_VARDIR - spécifie un chemin spécifique sur le + disque où l'indexeur enregistre les données lorsqu'il + utilise le cache et les bases de données internes. Par + défaut, le dossier <literal>/var</literal> de l'installation + de <application>mnoGoSearch</application> est utilisé. Ce + paramètre est disponible en PHP 4.0.7 et plus récent. + </simpara> + </listitem> + </itemizedlist> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/mnogosearch.xml diff -u phpdoc/fr/functions/mnogosearch.xml:1.7 phpdoc/fr/functions/mnogosearch.xml:1.8 --- phpdoc/fr/functions/mnogosearch.xml:1.7 Thu Jul 12 08:17:46 2001 +++ phpdoc/fr/functions/mnogosearch.xml Wed Aug 8 05:39:06 2001 @@ -1,20 +1,23 @@ - <reference id="ref.mnogo"> - <title>mnoGoSearch</title> - <titleabbrev>mnoGoSearch</titleabbrev> - <partintro> - <simpara> - 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 - <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 : <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch=DIR</option></link>. +<!-- $Revision: 1.8 $ --> +<reference id="ref.mnogo"> + <title>mnoGoSearch</title> + <titleabbrev>mnoGoSearch</titleabbrev> + <partintro> + <simpara> + 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 <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 : <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 + <para> + mnoGoSearch est une moteur de recherche complet, destinés aux intranet et serveurs web, distribué sous licence GNU. mnoGoSearch offre des fonctionnalités unique, qui en font un excellent outil pour un grand nombre d'applications de recherche dans votre site : recherche de recettes de cuisines ou dans les @@ -23,691 +26,840 @@ textes. mnoGoSearch est constitué de deux parties : l'indexeur, qui effectue les recherches 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. + 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 + 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> + <para> + PHP supporte naturellement MySQL. Il faut savoir que mnoGoSearch + n'est pas compatible avec la librairie interne de PHP, et ne + peut fonctionner qu'avec les librairies génériques + MySQL. Par conséquent, si vous utilisez mnoGoSearch avec + MySQL, indiquez le dossier d'installation de MySQL durant + la configuration avec l'option : + <link linkend="install.configure.with-mnogosearch"><option role="configure"> + --with-mnogosearch --with-mysql=/usr</option></link>. </para> - <note> - <para> - PHP supporte naturellement MySQL. Il faut savoir que mnoGoSearch - n'est pas compatible avec la librairie interne de PHP, et ne - peut fonctionner qu'avec les librairies génériques - MySQL. Par conséquent, si vous utilisez mnoGoSearch avec - MySQL, indiquez le dossier d'installation de MySQL durant - la configuration avec l'option : - <link linkend="install.configure.with-mnogosearch"><option role="configure">--with-mnogosearch --with-mysql=/usr</option></link>. - </para> - </note> - <simpara> - Pour utiliser ces fonctions, vous devez installer les versions - 3.1.10 ou plus récente de mnoGoSearch. + </note> + <simpara> + Pour utiliser ces fonctions, vous devez installer les versions 3.1.10 ou + plus récente de mnoGoSearch. </simpara> - <simpara> - Plus de détails sur le site officiel de mnoGoSearch : - <ulink url="&url.mnogo">&url.mnogo;</ulink>. + <simpara> + Plus de détails sur le site officiel de mnoGoSearch : <ulink + url="&url.mnogo">&url.mnogo;</ulink>. </simpara> - </partintro> - <refentry id="function.udm-add-search-limit"> - <refnamediv> - <refname>udm_add_search_limit</refname> - <refpurpose>Ajoute différentes limitations de recherche</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_add_search_limit</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - <paramdef>int <parameter>var</parameter></paramdef> - <paramdef>string <parameter>val</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_add_search_limit</function> retourne &true; - en cas de succès, &false; en cas d'erreur. - <function>udm_add_search_limit</function> ajoute différentes limitations - de recherche. - </para> - <para> - <parameter>agent</parameter> - un identifiant d'Agent, - obtenu après un appel à <function>udm_alloc_agent</function>. - </para> - <para> - <parameter>var</parameter> - nom du paramètre de limitation. - </para> - <para> - <parameter>val</parameter> - Valeur du paramètre sus-cité. - </para> - <para> - <parameter>var</parameter> peut prendre les valeurs suivantes : - </para> - <itemizedlist> - <listitem> - <simpara> - UDM_LIMIT_URL - Définit les limitations sur les URL, pour limiter les - recherches à une partie de la base. Ce paramètre supporte les - jokers SQL '%' et '_' : '%' remplace n'importe quel nombre de caractères, - même zéro caractères, et '_' remplace exactement un caractère. - Par exemple, <literal>'http://my.domain.__/catalog'</literal> peut remplacer - <literal>http://my.domain.ru/catalog</literal> ou <literal>http://my.domain.ua/catalog</literal>. + </partintro> + <refentry id="function.udm-add-search-limit"> + <refnamediv> + <refname>udm_add_search_limit</refname> + <refpurpose>Ajoute différentes limitations de recherche</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_add_search_limit</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>int <parameter>var</parameter></paramdef> + <paramdef>string <parameter>val</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_add_search_limit</function> retourne &true; + en cas de succès, &false; en cas d'erreur. + <function>udm_add_search_limit</function> ajoute différentes limitations + de recherche. + </para> + <para> + <parameter>agent</parameter> - un identifiant d'Agent, + obtenu après un appel à <function>udm_alloc_agent</function>. + </para> + <para> + <parameter>var</parameter> - nom du paramètre de limitation. + </para> + <para> + <parameter>val</parameter> - Valeur du paramètre sus-cité. + </para> + <para> + <parameter>var</parameter> peut prendre les valeurs suivantes : + </para> + <itemizedlist> + <listitem> + <simpara> + UDM_LIMIT_URL - Définit les limitations sur les URL, pour + limiter les recherches à une partie de la base. Ce + paramètre supporte les jokers SQL '%' et '_' : '%' remplace + n'importe quel nombre de caractères, même zéro + caractères, et '_' remplace exactement un caractère. + Par exemple, <literal>'http://my.domain.__/catalog'</literal> peut + remplacer <literal>http://my.domain.ru/catalog</literal> ou + <literal>http://my.domain.ua/catalog</literal>. </simpara> - </listitem> - <listitem> - <simpara> - UDM_LIMIT_TAG - Définit les limitations par étiquettes. Lors de l'indexation, - vous pouvez assigner des étiquettes sur différentes parties d'un site. - Les étiquettes de mnoGoSearch 3.1.x sont des lignes, qui peuvent contenir les - jokers '%' et '_' : '%' remplace n'importe quel nombre de caractères, - même zéro caractères, et '_' remplace exactement un caractère. - Par exemple, si vous avez les étiquettes ABCD et ABCE, la limitation de recherche - <literal>ABC_</literal> limitera la recherche à ces deux étiquettes; + </listitem> + <listitem> + <simpara> + UDM_LIMIT_TAG - Définit les limitations par étiquettes. + Lors de l'indexation, vous pouvez assigner des étiquettes sur + différentes parties d'un site. Les étiquettes de + mnoGoSearch 3.1.x sont des lignes, qui peuvent contenir les jokers + '%' et '_' : '%' remplace n'importe quel nombre de caractères, + même zéro caractères, et '_' remplace exactement + un caractère. Par exemple, si vous avez les étiquettes + ABCD et ABCE, la limitation de recherche <literal>ABC_</literal> + limitera la recherche à ces deux étiquettes; </simpara> - </listitem> - <listitem> - <simpara> + </listitem> + <listitem> + <simpara> UDM_LIMIT_LANG - Définit les limitations par langue. </simpara> - </listitem> - <listitem> - <simpara> - UDM_LIMIT_CAT - Définit les limitations par catégorie. Les catégories sont - 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 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>. + </listitem> + <listitem> + <simpara> + UDM_LIMIT_CAT - Définit les limitations par catégorie. + Les catégories sont 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 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>. </simpara> - </listitem> - <listitem> - <simpara> - UDM_LIMIT_DATE - Définit les limitations par date de modification du document. + </listitem> + <listitem> + <simpara> + UDM_LIMIT_DATE - Définit les limitations par date de + modification du document. </simpara> - <simpara> - Format de la valeur : une chaîne de caractères, dont le premier caractère est - < ou >, puis une date au format unixtimestamp. Par exemple : + <simpara> + Format de la valeur : une chaîne de caractères, dont le + premier caractère est < ou >, puis une date au format + unixtimestamp. Par exemple : </simpara> - <simpara> - Udm_Add_Search_Limit($udm,UDM_LIMIT_DATE,"<908012006"); + <simpara> + Udm_Add_Search_Limit($udm,UDM_LIMIT_DATE,"<908012006"); </simpara> - <simpara> - Si > est utilisé, la recherche sera limitée aux documents dont la - date de modification est plus grande que celle qui a été entrée. - Avec <, c'est le contraire. - </simpara> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - <refentry id="function.udm_alloc_agent"> - <refnamediv> - <refname>Udm_Alloc_Agent</refname> - <refpurpose>Alloue une session mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_alloc_agent</function></funcdef> - <paramdef>string <parameter>dbaddr</parameter></paramdef> - <paramdef>string - <parameter> - <optional>dbmode</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_alloc_agent</function> retourne un agent mnogosearch - en cas de succès, &false; en cas d'erreur. - <function>udm_alloc_agent</function> crée une session avec les - paramètres de base de données. - </para> - <para> - <parameter>dbaddr</parameter> est une description de base de données - formaté comme une URL. Les options (type, hôte, nom de base de données , port, utilisateur - ou mot de passe) servent à se connecter à la base de données SQL. - Ne passez aucune valeur si vous souhaitez utiliser le support des fichiers - texte intégré. Sinon, utilisez le format : - <literal>DBAddr DBType:[//[DBUser[:DBPass]@]DBHost[:DBPort]]/DBName/</literal>. - Actuellement, les valeurs de DBType possibles sont : - mysql, pgsql, msql, solid, mssql, oracle, ibase. En fait, si vous avez ajouté - un support natif, cette option est inutile. Mais les utilisateurs ODBC doivent - spécifier une des valeurs supportées. Si votre type de base de données n'est pas - supporté, utilisez le terme "unknown". - </para> + <simpara> + Si > est utilisé, la recherche sera limitée aux + documents dont la date de modification est plus grande que celle qui + a été entrée. Avec <, c'est le contraire. + </simpara> + </listitem> + </itemizedlist> + </refsect1> + </refentry> + <refentry id="function.udm-cat-path"> + <refnamediv> + <refname>udm_cat_path</refname> + <refpurpose>Lit le chemin de la catégorie courante.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>udm_cat_path</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>string <parameter>category</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_cat_path</function> retourne un tableau listant les catégories + depuis la racine jusqu'à la catégorie courante. + </para> + <para> + Le paramètre <parameter>agent</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. + </para> + <para> + <parameter>category</parameter> - La catégorie courante : celle dont on veut le chemin. + </para> + <para> + <function>udm_cat_path</function> retourne un tableau avec le format suivant : + </para> + <para> + Le tableau est constitué de paires. Les index pairs contiennent les chemins de catégories, + les index impairs contiennent les noms des catégories correspondantes. + </para> + <para> + Par exemple, l'appel <literal>$array=udm_cat_path($agent, '02031D');</literal> + peut retourner le tableau suivant : + </para> + <literallayout> + $array[0] contiendra '' + $array[1] contiendra 'Root' + $array[2] contiendra '02' + $array[3] contiendra 'Sport' + $array[4] contiendra '0203' + $array[5] contiendra 'Foot' + $array[4] contiendra '02031D' + $array[5] contiendra 'PSG' + </literallayout> + <example> + <title> + Spécifier le chemin de la catégorie courante avec le format suivant : + '> Root > Sport > Foot > PSG' + </title> + <programlisting role="php"> +<?php + $cat_path_arr=Udm_Cat_Path($udm_agent,$cat); + $cat_path=''; + for ($i=0; $i<count($cat_path_arr); $i+=2) { + $path=$cat_path_arr[$i]; + $name=$cat_path_arr[$i+1]; + $cat_path .= " > <a href=\"$PHP_SELF?cat=$path\">$name</a> "; + } +> + </programlisting> + </example> + </refsect1> + </refentry> + <refentry id="function.udm-cat-list"> + <refnamediv> + <refname>udm_cat_list</refname> + <refpurpose>Liste toutes les catégories soeurs d'une catégorie.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>udm_cat_list</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>string <parameter>category</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_cat_list</function> retourne un tableau contenant la liste de toutes + les catégories de même niveau que la catégorie courante. + </para> + <para> + Cette fonction est pratique pour réaliser des arbres à partir des catégories. + </para> + <para> + <function>udm_cat_list</function> retourne un tableau avec le format suivant : + </para> + <para> + Le tableau est constitué de paires. Les index pairs contiennent les chemins de catégories, + les index impairs contiennent les noms des catégories correspondantes. + </para> + <literallayout> + $array[0] contiendra '020300' + $array[1] contiendra 'Marseille' + $array[2] contiendra '020301' + $array[3] contiendra 'Lille' + $array[4] contiendra '020302' + $array[5] contiendra 'Lyon' + ... + etc. + </literallayout> + <simpara> + Ce qui peut être affiché comme ceci : + </simpara> + <literallayout> + Marseille + Lille + Lyon + ... + </literallayout> + <informalexample> + <programlisting role="php"> +<?php + $cat_list_arr=Udm_Cat_List($udm_agent,$cat); + $cat_list=''; + for ($i=0; $i<count($cat_list_arr); $i+=2) { + $path=$cat_list_arr[$i]; + $name=$cat_list_arr[$i+1]; + $cat_list .= "<a href=\"$PHP_SELF?cat=$path\">$name</a><br>"; + } +> + </programlisting> + </informalexample> + </refsect1> + </refentry> + <refentry id="function.udm_alloc_agent"> + <refnamediv> + <refname>Udm_Alloc_Agent</refname> + <refpurpose>Alloue une session mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_alloc_agent</function></funcdef> + <paramdef>string <parameter>dbaddr</parameter></paramdef> + <paramdef>string + <parameter> + <optional>dbmode</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_alloc_agent</function> retourne un agent mnogosearch + en cas de succès, &false; en cas d'erreur. + <function>udm_alloc_agent</function> crée une session avec les + paramètres de base de données. + </para> + <para> + <parameter>dbaddr</parameter> est une description de base de données + formaté comme une URL. Les options (type, hôte, nom de base de données, + port, utilisateur ou mot de passe) servent à se connecter à + la base de données SQL. + Ne passez aucune valeur si vous souhaitez utiliser le support des fichiers + texte intégré. Sinon, utilisez le format : + <literal>DBAddr DBType:[//[DBUser[:DBPass]@]DBHost[:DBPort]]/DBName/</literal>. + Actuellement, les valeurs de DBType possibles sont : + mysql, pgsql, msql, solid, mssql, oracle, ibase. En fait, si vous avez ajouté + un support natif, cette option est inutile. Mais les utilisateurs ODBC doivent + spécifier une des valeurs supportées. + Si votre type de base de données n'est pas + supporté, utilisez le terme "unknown". + </para> + <para> + <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 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 + le mode "crc", mais il stocke aussi les mots dans différentes tables suivant leur + taille. Format: DBMode single/multi/crc/crc-multi. + </para> + <note> <para> - <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 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 - le mode "crc", mais il stocke aussi les mots dans différentes tables suivant leur - taille. Format: DBMode single/multi/crc/crc-multi. - </para> - <note> - <para> <parameter>dbaddr</parameter> et <parameter>dbmode</parameter> doit correspondre à ceux qui sont utilisés lors de l'indexation. - </para> - </note> - <note> - <para> - En réalité, <function>udm_alloc_agent</function> n'ouvre - pas de connexion, et donc, ne vérifie ni le nom d'utilisateur, - ni le mot de passe. - </para> - </note> - </refsect1> - </refentry> - <refentry id="function.udm-api-version"> - <refnamediv> - <refname>udm_api_version</refname> - <refpurpose>Lit la version des API mnoGoSearch.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_api_version</function></funcdef> - <void/> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_api_version</function> retourne le numéro de version - des API mnoGoSearch. Par exemple, si mnoGosearch 3.1.10 est utilisé, - <function>udm_api_version</function> retournera <literal>30110</literal>. </para> + </note> + <note> <para> - <function>udm_api_version</function> permet aux utilisateurs d'identifier - quelles sont les API disponibles. Par exemple, <function>udm_get_doc_count</function> - n'est disponible qu'à partir de mnoGoSearch 3.1.11. + En réalité, <function>udm_alloc_agent</function> n'ouvre + pas de connexion, et donc, ne vérifie ni le nom d'utilisateur, + ni le mot de passe. </para> - <simpara>Exemple avec <function>udm_api_version</function></simpara> - <informalexample> + </note> + </refsect1> + </refentry> + <refentry id="function.udm-api-version"> + <refnamediv> + <refname>udm_api_version</refname> + <refpurpose>Lit la version des API mnoGoSearch.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_api_version</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_api_version</function> retourne le numéro de version + des API mnoGoSearch. Par exemple, si mnoGosearch 3.1.10 est utilisé, + <function>udm_api_version</function> retournera <literal>30110</literal>. + </para> + <para> + <function>udm_api_version</function> permet aux utilisateurs d'identifier + quelles sont les API disponibles. Par exemple, <function>udm_get_doc_count</function> + n'est disponible qu'à partir de mnoGoSearch 3.1.11. + </para> + <simpara>Exemple avec <function>udm_api_version</function></simpara> + <informalexample> <programlisting role="C"> - if (Udm_Api_Version() >= 30111) { - print "Total number of urls in database: ".Udm_Get_Doc_Count($udm)."<br>\n"; - } - </programlisting> - </informalexample> - </refsect1> - </refentry> - <refentry id="function.udm-clear-search-limits"> - <refnamediv> - <refname>udm_clear_search_limits</refname> - <refpurpose>Annule toutes les limitations de recherche</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_clear_search_limits</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_clear_search_limits</function> annule toutes les limitations - de recherche imposées, et retourne &true;. - </para> - </refsect1> - </refentry> - <refentry id="function.udm_errno"> - <refnamediv> - <refname>Udm_Errno</refname> - <refpurpose>Numéro d'erreur mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_errno</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_errno</function> retourne le numéro d'erreur mnoGoSearch, - ou bien <literal>0</literal> sinon. - </para> - <para> - Le paramètre <parameter>agent</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. - </para> - <para> - <function>udm_errno</function> retourne le numéro de l'erreur - généré par l'agent <parameter>agent</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.udm_error"> - <refnamediv> - <refname>Udm_Error</refname> - <refpurpose>Message d'erreur mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>udm_error</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_errno</function> retourne le message d'erreur mnoGoSearch, - ou bien une chaîne vide sinon. - </para> - <para> - Le paramètre <parameter>agent</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. - </para> - <para> - <function>udm_error</function> retourne le numéro de l'erreur - généré par l'agent <parameter>agent</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.udm_find"> - <refnamediv> - <refname>Udm_Find</refname> - <refpurpose>Effectue une recherche</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_find</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - <paramdef>string <parameter>query</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_add_search_limit</function> retourne - &true; en cas de succès, et - &false; en cas d'erreur. - </para> - <para> - La recherche en elle-même. Le premier argument <parameter>agent</parameter> - est la session, le second est la <parameter>query</parameter>. - Pour rechercher, entrez les mots avec lesquels que vous voulez - faire une recherche, puis cliquez sur le bouton d'envoi. - Par exemple, "<literal>mysql odbc</literal>". Vous ne devez - pas utiliser de guillemets doubles <literal>"</literal>, car - ils sont utilisés par mnoGoSearch pour séparer une requête en - 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 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 - l'un ou l'autre des mots. Si vous voulez accéder aux fonctions - avancées de recherche, vous pouvez utiliser le mode "BOOL", qui - vous permet d'entrer directement des requêtes. - </para> - <para> - mnoGoSearch utilise les opérateurs booléean suivants : - </para> - <para> - & - AND, ET logique. Par exemple, "mysql & - odbc". mnoGoSearch recherche toutes les URL qui contiennent - à la fois les mots "mysql" et "odbc". - </para> - <para> - | - OR, OU logique. Par exemple, "mysql | - odbc". mnoGoSearch recherche toutes les URL qui contiennent - soit "mysql", soit "odbc". - </para> - <para> - ~ - NOT, NON logique. Par exemple, "mysql & ~odbc". - mnoGoSearch recherche toutes les URL qui contiennent le - mot "mysql" mais ne contiennent pas le mot "odbc". - Attention : la requête "~odbc" ne trouvera rien! - </para> - <para> - () - Groupage de commandes pour les requêtes complexes : par exemple, - "(mysql | msql) & ~postgres". Le mode par requête est - simple et puissant à la fois. Vous pouvez utiliser les commandes - booléennes habituelles avec ce mode. - </para> - </refsect1> - </refentry> - <refentry id="function.udm_free_agent"> - <refnamediv> - <refname>Udm_Free_Agent</refname> - <refpurpose>Détruit une session mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_free_agent</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_free_res</function> retourne &true; en - cas de succès, &false; sinon. - </para> - <para> - Le paramètre <parameter>res</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. - </para> - <para> - <function>udm_free_agent</function> détruit l'agent de recherche - créé par <function>udm_alloc_agent</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.udm-free-ispell-data"> - <refnamediv> - <refname>udm_free_ispell_data</refname> - <refpurpose>Libère la mémoire allouée pour ispell</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_free_ispell_data</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_free_ispell_data</function> retourne toujours &true;. - </para> - <para> - <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à - <function>udm_alloc_agent</function>. - </para> - <note> +if (Udm_Api_Version() >= 30111) { + print "Total number of urls in database: ".Udm_Get_Doc_Count($udm)."<br>\n"; +} + </programlisting> + </informalexample> + </refsect1> + </refentry> + <refentry id="function.udm-clear-search-limits"> + <refnamediv> + <refname>udm_clear_search_limits</refname> + <refpurpose>Annule toutes les limitations de recherche</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_clear_search_limits</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_clear_search_limits</function> annule toutes les limitations + de recherche imposées, et retourne &true;. + </para> + </refsect1> + </refentry> + <refentry id="function.udm_errno"> + <refnamediv> + <refname>Udm_Errno</refname> + <refpurpose>Numéro d'erreur mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_errno</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_errno</function> retourne le numéro d'erreur mnoGoSearch, + ou bien <literal>0</literal> sinon. + </para> + <para> + Le paramètre <parameter>agent</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. + </para> + <para> + <function>udm_errno</function> retourne le numéro de l'erreur + généré par l'agent <parameter>agent</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.udm_error"> + <refnamediv> + <refname>Udm_Error</refname> + <refpurpose>Message d'erreur mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>udm_error</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_errno</function> retourne le message d'erreur mnoGoSearch, + ou bien une chaîne vide sinon. + </para> + <para> + Le paramètre <parameter>agent</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm_Alloc_Agent</parameter>. + </para> + <para> + <function>udm_error</function> retourne le numéro de l'erreur + généré par l'agent <parameter>agent</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.udm_find"> + <refnamediv> + <refname>Udm_Find</refname> + <refpurpose>Effectue une recherche</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_find</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_add_search_limit</function> retourne + &true; en cas de succès, et + &false; en cas d'erreur. + </para> + <para> + La recherche en elle-même. Le premier argument <parameter>agent</parameter> + est la session, le second est la <parameter>query</parameter>. + Pour rechercher, entrez les mots avec lesquels que vous voulez + faire une recherche, puis cliquez sur le bouton d'envoi. + Par exemple, "<literal>mysql odbc</literal>". Vous ne devez + pas utiliser de guillemets doubles <literal>"</literal>, car + ils sont utilisés par mnoGoSearch pour séparer une requête en + 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 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 + l'un ou l'autre des mots. Si vous voulez accéder aux fonctions + avancées de recherche, vous pouvez utiliser le mode "BOOL", qui + vous permet d'entrer directement des requêtes. + </para> + <para> + mnoGoSearch utilise les opérateurs booléean suivants : + </para> + <para> + & - AND, ET logique. Par exemple, "mysql & + odbc". mnoGoSearch recherche toutes les URL qui contiennent + à la fois les mots "mysql" et "odbc". + </para> + <para> + | - OR, OU logique. Par exemple, "mysql | + odbc". mnoGoSearch recherche toutes les URL qui contiennent + soit "mysql", soit "odbc". + </para> + <para> + ~ - NOT, NON logique. Par exemple, "mysql & ~odbc". + mnoGoSearch recherche toutes les URL qui contiennent le + mot "mysql" mais ne contiennent pas le mot "odbc". + Attention : la requête "~odbc" ne trouvera rien! + </para> + <para> + () - Groupage de commandes pour les requêtes complexes : par exemple, + "(mysql | msql) & ~postgres". Le mode par requête est + simple et puissant à la fois. Vous pouvez utiliser les commandes + booléennes habituelles avec ce mode. + </para> + </refsect1> + </refentry> + <refentry id="function.udm_free_agent"> + <refnamediv> + <refname>Udm_Free_Agent</refname> + <refpurpose>Détruit une session mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_free_agent</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_free_res</function> retourne &true; en + cas de succès, &false; sinon. + </para> + <para> + Le paramètre <parameter>res</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. + </para> + <para> + <function>udm_free_agent</function> détruit l'agent de recherche + créé par <function>udm_alloc_agent</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.udm-free-ispell-data"> + <refnamediv> + <refname>udm_free_ispell_data</refname> + <refpurpose>Libère la mémoire allouée pour ispell</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_free_ispell_data</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_free_ispell_data</function> retourne toujours &true;. + </para> + <para> + <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à + <function>udm_alloc_agent</function>. + </para> + <note> <para> <function>udm_free_ispell_data</function> est supportée à partir de la version 3.1.12 de mnoGoSearch et elle ne fait strictement rien avec les versions précédentes. </para> - </note> - </refsect1> - </refentry> - <refentry id="function.udm_free_res"> - <refnamediv> - <refname>Udm_Free_Res</refname> - <refpurpose>Libère un résultat mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_free_res</function></funcdef> - <paramdef>int <parameter>res</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_free_res</function> retourne &true; en - cas de succès, &false; sinon. - </para> - <para> - Le paramètre <parameter>res</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. - </para> - <para> - <function>udm_free_res</function> libère la mémoire de tous - les résultats générés. - </para> - </refsect1> - </refentry> - <refentry id="function.udm-get-doc-count"> - <refnamediv> - <refname>udm_get_doc_count</refname> - <refpurpose>Lit le nombre total de documents dans les bases.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_get_doc_count</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_get_doc_count</function> retourne le nombre de document - dans les bases de données. - </para> - <para> - <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à - <function>udm_alloc_agent</function>. - </para> - <note> + </note> + </refsect1> + </refentry> + <refentry id="function.udm_free_res"> + <refnamediv> + <refname>Udm_Free_Res</refname> + <refpurpose>Libère un résultat mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_free_res</function></funcdef> + <paramdef>int <parameter>res</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_free_res</function> retourne &true; en + cas de succès, &false; sinon. + </para> + <para> + Le paramètre <parameter>res</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. + </para> + <para> + <function>udm_free_res</function> libère la mémoire de tous + les résultats générés. + </para> + </refsect1> + </refentry> + <refentry id="function.udm-get-doc-count"> + <refnamediv> + <refname>udm_get_doc_count</refname> + <refpurpose>Lit le nombre total de documents dans les bases.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_get_doc_count</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_get_doc_count</function> retourne le nombre de document + dans les bases de données. + </para> + <para> + <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à + <function>udm_alloc_agent</function>. + </para> + <note> <simpara> - <function>udm_get_doc_count</function> est supporté à partir de la version - mnoGoSearch 3.1.11 ou plus récent. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.udm_get_res_field"> - <refnamediv> - <refname>Udm_Get_Res_Field</refname> - <refpurpose>Lit un champs de résultat mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_get_res_field</function></funcdef> - <paramdef>int <parameter>res</parameter></paramdef> - <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>int <parameter>field</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_alloc_agent</function> retourne la valeur du - champs <parameter>field</parameter> dans la ligne <parameter>row</parameter>, - du résultat <parameter>res</parameter>, et - &false; sinon. - </para> - <para> - Le paramètre <parameter>res</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. - </para> - <para> - Le paramètre <parameter>row</parameter> est le numéro du lien dans - la page courante. Il peut valoir de 0 jusqu'à - <parameter>UDM_PARAM_NUM_ROWS</parameter>. - </para> - <para> - Le paramètre <parameter>field</parameter> est l'identifiant de - champs, et peut prendre l'une des valeurs suivantes : - </para> - <itemizedlist> - <listitem> - <simpara> - UDM_FIELD_URL - Champs URL + <function>udm_get_doc_count</function> est supporté à + partir de la version mnoGoSearch 3.1.11 ou plus récent. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.udm_get_res_field"> + <refnamediv> + <refname>Udm_Get_Res_Field</refname> + <refpurpose>Lit un champs de résultat mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_get_res_field</function></funcdef> + <paramdef>int <parameter>res</parameter></paramdef> + <paramdef>int <parameter>row</parameter></paramdef> + <paramdef>int <parameter>field</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_alloc_agent</function> retourne la valeur du + champs <parameter>field</parameter> dans la ligne <parameter>row</parameter>, + du résultat <parameter>res</parameter>, et + &false; sinon. + </para> + <para> + Le paramètre <parameter>res</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. + </para> + <para> + Le paramètre <parameter>row</parameter> est le numéro du lien dans + la page courante. Il peut valoir de 0 jusqu'à + <parameter>UDM_PARAM_NUM_ROWS</parameter>. + </para> + <para> + Le paramètre <parameter>field</parameter> est l'identifiant de + champs, et peut prendre l'une des valeurs suivantes : + </para> + <itemizedlist> + <listitem> + <simpara> + UDM_FIELD_URL - Champs URL </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_CONTENT - Champs "Content-type" (par exemple, "text/html"). + </listitem> + <listitem> + <simpara> + UDM_FIELD_CONTENT - Champs "Content-type" (par exemple, "text/html"). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_TITLE - Titre du document. + </listitem> + <listitem> + <simpara> + UDM_FIELD_TITLE - Titre du document. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_KEYWORDS - Mots clés du document (balise META KEYWORDS). + </listitem> + <listitem> + <simpara> + UDM_FIELD_KEYWORDS - Mots clés du document (balise META + KEYWORDS). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_DESC - Description du document (balise META DESCRIPTION). + </listitem> + <listitem> + <simpara> + UDM_FIELD_DESC - Description du document (balise META DESCRIPTION). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_TEXT - Corps du document (balise body, les premières lignes - pour donner une idée du document). + </listitem> + <listitem> + <simpara> + UDM_FIELD_TEXT - Corps du document (balise body, les premières + lignes pour donner une idée du document). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_SIZE - Taille du document. + </listitem> + <listitem> + <simpara> + UDM_FIELD_SIZE - Taille du document. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_URLID - Identifiant unique de l'URL. + </listitem> + <listitem> + <simpara> + UDM_FIELD_URLID - Identifiant unique de l'URL. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_RATING - Score de la page (calculé par mnoGoSearch). + </listitem> + <listitem> + <simpara> + UDM_FIELD_RATING - Score de la page (calculé par mnoGoSearch). </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_MODIFIED - Date de modification au format unixtimestamp. + </listitem> + <listitem> + <simpara> + UDM_FIELD_MODIFIED - Date de modification au format unixtimestamp. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_ORDER - Le nombre de documents trouvés. + </listitem> + <listitem> + <simpara> + UDM_FIELD_ORDER - Le nombre de documents trouvés. </simpara> - </listitem> - <listitem> - <simpara> - UDM_FIELD_CRC - La valeur CRC du document. + </listitem> + <listitem> + <simpara> + UDM_FIELD_CRC - La valeur CRC du document. </simpara> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - <refentry id="function.udm_get_res_param"> - <refnamediv> - <refname>Udm_Get_Res_Param</refname> - <refpurpose>Lit les paramètres de résultats mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_get_res_param</function></funcdef> - <paramdef>int <parameter>res</parameter></paramdef> - <paramdef>int <parameter>param</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_get_res_param</function> retourne les paramètres - de résultat en cas de succès, &false; en cas d'erreur. - </para> - <para> - Le paramètre <parameter>res</parameter> est un identifiant - de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. - </para> - <para> - Le paramètre <parameter>param</parameter> peut prendre les valeurs - suivantes : - </para> - <itemizedlist> - <listitem> - <simpara> - UDM_PARAM_NUM_ROWS - nombre de liens trouvés dans le groupe de résultat courant. - C'est la valeur de UDM_PARAM_PAGE_SIZE pour tous les groupes, sauf le dernier. + </listitem> + </itemizedlist> + </refsect1> + </refentry> + <refentry id="function.udm_get_res_param"> + <refnamediv> + <refname>Udm_Get_Res_Param</refname> + <refpurpose>Lit les paramètres de résultats mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_get_res_param</function></funcdef> + <paramdef>int <parameter>res</parameter></paramdef> + <paramdef>int <parameter>param</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_get_res_param</function> retourne les paramètres + de résultat en cas de succès, &false; en cas d'erreur. + </para> + <para> + Le paramètre <parameter>res</parameter> est un identifiant + de résultat, obtenu après un appel à <parameter>Udm-Find</parameter>. + </para> + <para> + Le paramètre <parameter>param</parameter> peut prendre les valeurs + suivantes : + </para> + <itemizedlist> + <listitem> + <simpara> + UDM_PARAM_NUM_ROWS - nombre de liens trouvés dans le groupe de + résultat courant. C'est la valeur de UDM_PARAM_PAGE_SIZE pour + tous les groupes, sauf le dernier. </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_FOUND - Nombre total de résultats trouvés. + </listitem> + <listitem> + <simpara> + UDM_PARAM_FOUND - Nombre total de résultats trouvés. </simpara> - </listitem> - <listitem> - <simpara> - 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" + </listitem> + <listitem> + <simpara> + 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> - <listitem> - <simpara> - UDM_PARAM_SEARCHTIME - Temps de recherche en secondes + </listitem> + <listitem> + <simpara> + UDM_PARAM_SEARCHTIME - Temps de recherche en secondes </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_FIRST_DOC - le numéro du premier document affiché dans le groupe. + </listitem> + <listitem> + <simpara> + UDM_PARAM_FIRST_DOC - le numéro du premier document + affiché dans le groupe. </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_LAST_DOC - le numéro du dernier document affiché dans le groupe. + </listitem> + <listitem> + <simpara> + UDM_PARAM_LAST_DOC - le numéro du dernier document + affiché dans le groupe. </simpara> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - <refentry id="function.udm-load-ispell-data"> - <refnamediv> - <refname>udm_load_ispell_data</refname> - <refpurpose>Charge les données ispell</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_load_ispell_data</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - <paramdef>int <parameter>var</parameter></paramdef> - <paramdef>string <parameter>val1</parameter></paramdef> - <paramdef>string <parameter>val2</parameter></paramdef> - <paramdef>int <parameter>flag</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_load_ispell_data</function> charge des données ispell. - <function>udm_load_ispell_data</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. - </para> - <para> - <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à - <function>udm_alloc_agent</function>. - </para> - <para> - <parameter>var</parameter> - paramètre indiquant la source des données ispell. - </para> - <para> - Après avoir utilisé cette fonction, pensez à libérer les données de la - mémoire avec <function>udm_free_ispell_data</function>, même si vous - utilisez le mode UDM_ISPELL_TYPE_SERVER. - </para> - <para> - Le mode de plus rapide est UDM_ISPELL_TYPE_SERVER. UDM_ISPELL_TYPE_TEXT est - plus lent, et UDM_ISPELL_TYPE_DB est le plus lent. Ce classement est vrai - pour mnoGoSearch 3.1.10 - 3.1.11. Il est prévu d'accélérer le mode DB dans les - versions futures, et cela sera plus rapide que le mode TEXT. - </para> - <itemizedlist> - <listitem> - <simpara> - UDM_ISPELL_TYPE_DB indique que les données ispell doivent être chargée depuis la - base SQL. Dans ce cas, les paramètres <parameter>val1</parameter> et - <parameter>val2</parameter> sont ignorés et doivent être laissés vides. - <parameter>flag</parameter> doit valoir <literal>1</literal>. + </listitem> + </itemizedlist> + </refsect1> + </refentry> + <refentry id="function.udm-load-ispell-data"> + <refnamediv> + <refname>udm_load_ispell_data</refname> + <refpurpose>Charge les données ispell</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_load_ispell_data</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>int <parameter>var</parameter></paramdef> + <paramdef>string <parameter>val1</parameter></paramdef> + <paramdef>string <parameter>val2</parameter></paramdef> + <paramdef>int <parameter>flag</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_load_ispell_data</function> charge des données ispell. + <function>udm_load_ispell_data</function> retourne &true; + en cas de succès, et &false; en cas d'erreur. + </para> + <para> + <parameter>agent</parameter> - Agent mnoGoSearch obtenu après un appel à + <function>udm_alloc_agent</function>. + </para> + <para> + <parameter>var</parameter> - paramètre indiquant la source des données ispell. + </para> + <para> + Après avoir utilisé cette fonction, pensez à libérer les données de la + mémoire avec <function>udm_free_ispell_data</function>, même si vous + utilisez le mode UDM_ISPELL_TYPE_SERVER. + </para> + <para> + Le mode de plus rapide est UDM_ISPELL_TYPE_SERVER. UDM_ISPELL_TYPE_TEXT est + plus lent, et UDM_ISPELL_TYPE_DB est le plus lent. Ce classement est vrai + pour mnoGoSearch 3.1.10 - 3.1.11. Il est prévu d'accélérer le mode DB dans les + versions futures, et cela sera plus rapide que le mode TEXT. + </para> + <itemizedlist> + <listitem> + <simpara> + UDM_ISPELL_TYPE_DB indique que les données ispell doivent + être chargée depuis la base SQL. Dans ce cas, les + paramètres <parameter>val1</parameter> et + <parameter>val2</parameter> sont ignorés et doivent être + laissés vides. <parameter>flag</parameter> doit valoir + <literal>1</literal>. </simpara> - <note> + <note> <para> <parameter>flag</parameter> indique qu'après le chargement des données ispell - à partir de la source, elles doivent être triées (c'est nécessaire au bon + à partir de la source, elles doivent être triées (c'est nécessaire au bon fonctionnement d'ispell). Dans le cas où vous chargez les données depuis un fichier, - il peut y avoir plusieurs appels à <function>udm_load_ispell_data</function>, + il peut y avoir plusieurs appels à <function>udm_load_ispell_data</function>, et il ne vaut pas la peine de trier les valeurs après chaque appel, mais uniquement à la fin. Etant donné qu'en mode DB, toutes les données sont chargées en une seule fois, ce paramètre doit avoir la valeur de <literal>1</literal>. Dans ce mode, en @@ -715,350 +867,394 @@ &false; et le code d'erreur, avec son message, seront accessibles avec <function>udm_error</function> et <function>udm_errno</function>. </para> - </note> + </note> <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> - <informalexample> - <programlisting role="C"> - if (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_DB,'','',1)) { - printf("Error #%d: '%s'\n",Udm_Errno($udm),Udm_Error($udm)); - exit; - } - </programlisting> - </informalexample> - </listitem> - <listitem> + <informalexample> + <programlisting role="C"> +if (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_DB,'','',1)) { + printf("Error #%d: '%s'\n",Udm_Errno($udm),Udm_Error($udm)); + exit; +} + </programlisting> + </informalexample> + </listitem> + <listitem> <para> - UDM_ISPELL_TYPE_AFFIX indique que les données ispell doivent être chargée - depuis un fichier et initie le chargement. Dans ce cas, <parameter>val1</parameter> - définit le code de langue en deux lettre, et <parameter>val2</parameter> est le chemin - jusqu'aux fichiers. Notez que si vous utilisez un chemin relatif, le module recherche - les fichiers non pas dans UDM_CONF_DIR, mais directement avec le chemin courant, - où le script est exécuté. En cas d'erreur 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 <parameter>flag</parameter>. - </para> - <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> - <informalexample> - <programlisting role="C"> + UDM_ISPELL_TYPE_AFFIX indique que les données ispell doivent être chargée + depuis un fichier et initie le chargement. Dans ce cas, <parameter>val1</parameter> + définit le code de langue en deux lettre, et <parameter>val2</parameter> est le chemin + jusqu'aux fichiers. Notez que si vous utilisez un chemin relatif, le module recherche + les fichiers non pas dans UDM_CONF_DIR, mais directement avec le chemin courant, + où le script est exécuté. En cas d'erreur 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 <parameter>flag</parameter>. + </para> + <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> + <informalexample> + <programlisting role="C"> if ((! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'en','/opt/ispell/en.aff',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'ru','/opt/ispell/ru.aff',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'en','/opt/ispell/en.dict',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'ru','/opt/ispell/ru.dict',1))) { exit; } - </programlisting> - </informalexample> - <note> - <para> - <parameter>flag</parameter> prend la valeur <literal>1</literal> si c'est le dernier appel - à cette fonction. - </para> - </note> - </listitem> - <listitem> - <para> - UDM_ISPELL_TYPE_SPELL indique que les données ispell doivent être chargées - depuis un fichier, et initie le chargement du dictionnaire. Dans ce cas, - <parameter>val1</parameter> définit le code langue sur deux lettres, et - <parameter>val2</parameter> le chemin du fichier. Notez que si vous utilisez - un chemin relatif, le module recherche les fichiers non pas dans UDM_CONF_DIR, - mais directement avec le chemin courant, où le script est exécuté. En cas d'erreur - 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 - <parameter>flag</parameter>. - </para> + </programlisting> + </informalexample> + <note> + <para> + <parameter>flag</parameter> prend la valeur <literal>1</literal> si c'est le dernier appel + à cette fonction. + </para> + </note> + </listitem> + <listitem> + <para> + UDM_ISPELL_TYPE_SPELL indique que les données ispell doivent être chargées + depuis un fichier, et initie le chargement du dictionnaire. Dans ce cas, + <parameter>val1</parameter> définit le code langue sur deux lettres, et + <parameter>val2</parameter> le chemin du fichier. Notez que si vous utilisez + un chemin relatif, le module recherche les fichiers non pas dans UDM_CONF_DIR, + mais directement avec le chemin courant, où le script est exécuté. En cas d'erreur + 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 + <parameter>flag</parameter>. + </para> <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> - <informalexample> - <programlisting role="C"> + <informalexample> + <programlisting role="C"> if ((! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'en','/opt/ispell/en.aff',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'ru','/opt/ispell/ru.aff',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'en','/opt/ispell/en.dict',0)) || (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'ru','/opt/ispell/ru.dict',1))) { exit; } - </programlisting> - </informalexample> - <note> - <para> - <parameter>flag</parameter> prend la valeur <literal>1</literal> si c'est le dernier appel - à cette fonction. - </para> - </note> - </listitem> - <listitem> - <para> - UDM_ISPELL_TYPE_SERVER active le support des serveurs ispell. <parameter>val1</parameter> - indique alors l'adresse de l'hôte qui supporte le serveur ispall. <parameter>val2</parameter> - n'est pas encore utilisé, mais dans les cas futurs, il indiquera le numéro de port - utilisé par le serveur ispell. <parameter>flag</parameter> n'est pas utile, car les - données sont déjà triées. - </para> - <para> - Les serveurs Spelld lisent les données d'orthographe dans une - configuration séparée (par défaut <filename>/usr/local/mnogosearch/etc/spelld.conf</filename>), - 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 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). - </para> - <para> - <function>udm_load_ispell_data</function> en mode UDM_ISPELL_TYPE_SERVER - ne charge pas vraiment les données ispell, mais définit simplement l'adresse - du serveur. En fait, le serveur sera automatiquement utilisé par - <function>udm_find</function> lors des recherches. En cas d'erreur, - (par exemple si le serveur ispell ne fonctionne pas ou que l'hôte indiqué - est invalide), la conversion sera annulée, mais aucun message d'erreur ne - sera affiché. - </para> - <note> - <para> - Cette fonction est disponible à partir de mnoGoSearch 3.1.12. - </para> - </note> - <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> - <informalexample> - <programlisting role="C"> + </programlisting> + </informalexample> + <note> + <para> + <parameter>flag</parameter> prend la valeur <literal>1</literal> si c'est le dernier appel + à cette fonction. + </para> + </note> + </listitem> + <listitem> + <para> + UDM_ISPELL_TYPE_SERVER active le support des serveurs ispell. <parameter>val1</parameter> + indique alors l'adresse de l'hôte qui supporte le serveur ispall. <parameter>val2</parameter> + n'est pas encore utilisé, mais dans les cas futurs, il indiquera le numéro de port + utilisé par le serveur ispell. <parameter>flag</parameter> n'est pas utile, car les + données sont déjà triées. + </para> + <para> + Les serveurs Spelld lisent les données d'orthographe dans une + configuration séparée (par défaut <filename>/usr/local/mnogosearch/etc/spelld.conf</filename>), + 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 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). + </para> + <para> + <function>udm_load_ispell_data</function> en mode UDM_ISPELL_TYPE_SERVER + ne charge pas vraiment les données ispell, mais définit simplement l'adresse + du serveur. En fait, le serveur sera automatiquement utilisé par + <function>udm_find</function> lors des recherches. En cas d'erreur, + (par exemple si le serveur ispell ne fonctionne pas ou que l'hôte indiqué + est invalide), la conversion sera annulée, mais aucun message d'erreur ne + sera affiché. + </para> + <note> + <para> + Cette fonction est disponible à partir de mnoGoSearch 3.1.12. + </para> + </note> + <simpara>Exemple avec <function>udm_load_ispell_data</function></simpara> + <informalexample> + <programlisting role="C"> if (! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SERVER,'','',1)) { - printf("Error loading ispell data from server<br>\n"); - exit; - } - </programlisting> - </informalexample> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - <refentry id="function.udm-set-agent-param"> - <refnamediv> - <refname>udm_set_agent_param</refname> - <refpurpose>Modifie les paramètres de l'agent mnoGoSearch</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>udm_set_agent_param</function></funcdef> - <paramdef>int <parameter>agent</parameter></paramdef> - <paramdef>int <parameter>var</parameter></paramdef> - <paramdef>string <parameter>val</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>udm_set_agent_param</function> retourne &true; en - cas de succès et &false; sinon. <function>udm_set_agent_param</function> - définit les paramètres de l'agent mnoGoSearch. - </para> - <simpara> - Les paramètres suivants et leurs valeurs sont disponibles : + printf("Error loading ispell data from server<br>\n"); + exit; + } + </programlisting> + </informalexample> + </listitem> + </itemizedlist> + </refsect1> + </refentry> + <refentry id="function.udm-set-agent-param"> + <refnamediv> + <refname>udm_set_agent_param</refname> + <refpurpose>Modifie les paramètres de l'agent mnoGoSearch</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>udm_set_agent_param</function></funcdef> + <paramdef>int <parameter>agent</parameter></paramdef> + <paramdef>int <parameter>var</parameter></paramdef> + <paramdef>string <parameter>val</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>udm_set_agent_param</function> retourne &true; en + cas de succès et &false; sinon. <function>udm_set_agent_param</function> + définit les paramètres de l'agent mnoGoSearch. + </para> + <simpara> + Les paramètres suivants et leurs valeurs sont disponibles : </simpara> - <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, commençant à 0, avec UDM_PARAM_PAGE_SIZE - résultats par page). - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_PAGE_SIZE - Nombre de résultats affichés par page. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_SEARCH_MODE - Mode de recherche. Les valeurs suivantes sont disponibles : - UDM_MODE_ALL - recherche tous les mots; - UDM_MODE_ANY - recherche l'un des mots; - UDM_MODE_PHRASE - recherche une phrase; - UDM_MODE_BOOL - recherche booléenne. - Voir <function>udm_find</function> pour plus de détails sur les recherches booléennes. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_CACHE_MODE - Active/désactive le cache. Lorsque le cache est activé, le - moteur de recherche va stocker les résultats sur le disque. Lorque deux - requête seront similaires, il pourra retourner les résultats plus rapidement, - sans recherche. Valeurs disponibles : UDM_CACHE_ENABLED, UDM_CACHE_DISABLED. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_TRACK_MODE - Active le mode de suivi de requête. Depuis la version - 3.1.2, mnoGoSearch dispose d'un suivi de requête. Notez que ce suivi n'est implémenté - qu'avec les versions SQL et n'est pas disponible avec les bases de données - intégrées. Pour utiliser ce suivi, vous devez créer des tables de suivi. Pour mysql, - utilisez le script <filename>create/mysql/track.txt</filename>. Lorsque vous - effectuez une recherche avec l'interface, ces tables stockeront les mots recherchés - ainsi que le nombre de mots trouvés, et la date. Valeurs disponibles : - UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_PHRASE_MODE - indique si les index des bases de données utilise des - phrases( paramètre "phrase" dans indexer.conf). Valeurs disponibles : - UDM_PHRASE_ENABLED and UDM_PHRASE_DISABLED. - Notez bien que si la recherche par phrase est activé (UDM_PHRASE_ENABLED), - il est toujours possible de faire des recherches dans d'autres modes, - (ANY, ALL, BOOL ou PHRASE). En version 3.1.10 de mnoGoSearch, la recherche - par phrase n'est supportée que pour les modes SQL et intégré, tandis qu'en - 3.1.11, la recherche par phrase est supporté par le mode cache. - </simpara> - <simpara> - Exemple de recherche par phrase : - </simpara> - <simpara> - "Arizona desert" - Cette requete retourne tous les documents qui contiennent - les mots "Arizona desert" comme une phrase. Notez que vous devez mettre des - guillemets doubles autour des phrases. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_CHARSET - Définit le jeu de caractères local. Valeurs disponibles : - Tous les jeux supportés par mnoGoSearch. koi8-r, cp1251, ... - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_STOPFILE - Définit le nom et le chemin du fichier de - 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 - script courant. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_STOPTABLE - Charge la liste des mots ignorés depuis une table - SQL. Vous pouvez utiliser plusieurs tables SQL. Cette commande n'a aucun - effet si mnoGoSearch n'a pas été compilé avec le support de base - de données. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_WEIGHT_FACTOR - Représente le poids relatif des différentes - parties d'un document. Actuellement, le corps, titre, mots clés, descriptions - et url sont supportés. Pour activer cette fonctionnalité, utilisez - le degré 2 de *Weight commands, dans le fichier <filename>indexer.conf</filename>. - Imaginons que vous avez choisi les poids suivants : - </simpara> - <simpara>URLWeight 1</simpara> - <simpara>BodyWeight 2</simpara> - <simpara>TitleWeight 4</simpara> - <simpara>KeywordWeight 8</simpara> - <simpara>DescWeight 16</simpara> - <simpara> - 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'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> - La valeur de ce paramètre est une chaîne de chiffres héxadécimaux, sous la - forme ABCDE. Chaque chiffre est un facteur correspondant à un poids - affecté à une partie du document. Por la situation décrite ci-dessus, - </simpara> - <simpara>E est le facteur de poids 1 (URL)</simpara> - <simpara>D est le facteur de poids 2 (Corps)</simpara> - <simpara>C est le facteur de poids 4 (Titre)</simpara> - <simpara>B est le facteur de poids 8 (Mots clés)</simpara> - <simpara>A est le facteur de poids 16 (Description)</simpara> - <simpara> - Exemples: - </simpara> - <simpara> - UDM_PARAM_WEIGHT_FACTOR=00001 ne recherche que dans les URL. - </simpara> - <simpara> - UDM_PARAM_WEIGHT_FACTOR=00100 ne recherche que dans les Titres. - </simpara> - <simpara> - UDM_PARAM_WEIGHT_FACTOR=11100 recherche dans les Titres,Mots-clés,Description mais pas dans - le corps ou les URL. - </simpara> - <simpara> - UDM_PARAM_WEIGHT_FACTOR=F9421 recherche dans : - </simpara> - <simpara>Description avec un poids de 15 (F hex)</simpara> - <simpara>Keywords avec un poids de 9</simpara> - <simpara>Title avec un poids de 4</simpara> - <simpara>Body avec un poids de 2</simpara> - <simpara>URL avec un poids de 1</simpara> - <simpara> - Si UDM_PARAM_WEIGHT_FACTOR est omis, la valeur par défaut est - utilisée. + <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, commençant à 0, avec UDM_PARAM_PAGE_SIZE + résultats par page). + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_PAGE_SIZE - Nombre de résultats affichés par + page. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_SEARCH_MODE - Mode de recherche. Les valeurs suivantes sont + disponibles : UDM_MODE_ALL - recherche tous les mots; UDM_MODE_ANY - + recherche l'un des mots; UDM_MODE_PHRASE - recherche une phrase; + UDM_MODE_BOOL - recherche booléenne. Voir + <function>udm_find</function> pour plus de détails sur les + recherches booléennes. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_CACHE_MODE - Active/désactive le cache. Lorsque le + cache est activé, le moteur de recherche va stocker les + résultats sur le disque. Lorque deux requête seront + similaires, il pourra retourner les résultats plus rapidement, + sans recherche. Valeurs disponibles : UDM_CACHE_ENABLED, + UDM_CACHE_DISABLED. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_TRACK_MODE - Active le mode de suivi de requête. + Depuis la version 3.1.2, mnoGoSearch dispose d'un suivi de + requête. Notez que ce suivi n'est implémenté + qu'avec les versions SQL et n'est pas disponible avec les bases de + données intégrées. Pour utiliser ce suivi, vous + devez créer des tables de suivi. Pour mysql, utilisez le + script <filename>create/mysql/track.txt</filename>. Lorsque vous + effectuez une recherche avec l'interface, ces tables stockeront les + mots recherchés ainsi que le nombre de mots trouvés, et + la date. Valeurs disponibles : UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_PHRASE_MODE - indique si les index des bases de + données utilise des phrases( paramètre "phrase" dans + indexer.conf). Valeurs disponibles : UDM_PHRASE_ENABLED and + UDM_PHRASE_DISABLED. Notez bien que si la recherche par phrase est + activé (UDM_PHRASE_ENABLED), il est toujours possible de faire + des recherches dans d'autres modes, (ANY, ALL, BOOL ou PHRASE). En + version 3.1.10 de mnoGoSearch, la recherche par phrase n'est + supportée que pour les modes SQL et intégré, + tandis qu'en 3.1.11, la recherche par phrase est supporté par + le mode cache. + </simpara> + <simpara> + Exemple de recherche par phrase : + </simpara> + <simpara> + "Arizona desert" - Cette requete retourne tous les documents qui + contiennent les mots "Arizona desert" comme une phrase. Notez que + vous devez mettre des guillemets doubles autour des phrases. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_CHARSET - Définit le jeu de caractères local. + Valeurs disponibles : Tous les jeux supportés par mnoGoSearch. + koi8-r, cp1251, ... + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_STOPFILE - Définit le nom et le chemin du fichier de + 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 script courant. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_STOPTABLE - Charge la liste des mots ignorés depuis + une table SQL. Vous pouvez utiliser plusieurs tables SQL. Cette + commande n'a aucun effet si mnoGoSearch n'a pas été + compilé avec le support de base de données. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_WEIGHT_FACTOR - Représente le poids relatif des + différentes parties d'un document. Actuellement, le corps, + titre, mots clés, descriptions et url sont supportés. + Pour activer cette fonctionnalité, utilisez le degré 2 + de *Weight commands, dans le fichier + <filename>indexer.conf</filename>. Imaginons que vous avez choisi les + poids suivants : + </simpara> + <simpara>URLWeight 1</simpara> + <simpara>BodyWeight 2</simpara> + <simpara>TitleWeight 4</simpara> + <simpara>KeywordWeight 8</simpara> + <simpara>DescWeight 16</simpara> + <simpara> + 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'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> + La valeur de ce paramètre est une chaîne de chiffres + héxadécimaux, sous la forme ABCDE. Chaque chiffre est + un facteur correspondant à un poids affecté à + une partie du document. Por la situation décrite ci-dessus, + </simpara> + <simpara> + est le facteur de poids 1 (URL) + </simpara> + <simpara> + est le facteur de poids 2 (Corps) + </simpara> + <simpara> + est le facteur de poids 4 (Titre) + </simpara> + <simpara> + est le facteur de poids 8 (Mots clés) + </simpara> + <simpara> + est le facteur de poids 16 (Description) + </simpara> + <simpara> + Exemples: </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_WORD_MATCH - Recherche des mots. Vous pouvez utiliser ce - paramètre pour choisir le type de recherche de mots. Cette fonctionnalité - n'est valable qu'en mode "single" et "multi", avec les bases SQL ou intégrée. - Elle ne fonctionne pas en mode intégré, ni avec d'autres modes, car les CRC ne - supportent pas les recherches de sous-chaînes. Les valeurs disponibles sont : - </simpara> - <simpara>UDM_MATCH_BEGIN - début de mot;</simpara> + <simpara> + UDM_PARAM_WEIGHT_FACTOR=00001 ne recherche que dans les URL. + </simpara> + <simpara> + UDM_PARAM_WEIGHT_FACTOR=00100 ne recherche que dans les Titres. + </simpara> + <simpara> + UDM_PARAM_WEIGHT_FACTOR=11100 recherche dans les + Titres,Mots-clés,Description mais pas dans le corps ou les + URL. + </simpara> + <simpara> + UDM_PARAM_WEIGHT_FACTOR=F9421 recherche dans : + </simpara> + <simpara>Description avec un poids de 15 (F hex)</simpara> + <simpara>Keywords avec un poids de 9</simpara> + <simpara>Title avec un poids de 4</simpara> + <simpara>Body avec un poids de 2</simpara> + <simpara>URL avec un poids de 1</simpara> + <simpara> + Si UDM_PARAM_WEIGHT_FACTOR est omis, la valeur par défaut est + utilisée. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_WORD_MATCH - Recherche des mots. Vous pouvez utiliser ce + paramètre pour choisir le type de recherche de mots. Cette + fonctionnalité n'est valable qu'en mode "single" et "multi", + avec les bases SQL ou intégrée. Elle ne fonctionne pas + en mode intégré, ni avec d'autres modes, car les CRC ne + supportent pas les recherches de sous-chaînes. Les valeurs + disponibles sont : + </simpara> + <simpara>UDM_MATCH_BEGIN - début de mot;</simpara> <simpara>UDM_MATCH_END - fin de mot;</simpara> <simpara>UDM_MATCH_WORD - tout le mot;</simpara> <simpara>UDM_MATCH_SUBSTR - une sous-partie de mots.</simpara> - </listitem> - <listitem> - <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 - 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. - </simpara> - </listitem> - <listitem> - <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.. - 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 - utilisé pour des raisons d'orthographe. Pour activer ispell, vous devez charger les - données ispell avec la fonction <function>udm_load_ispell_data</function>. - </simpara> - </listitem> - <listitem> - <simpara> - UDM_PARAM_CROSS_WORDS - Active ou désactive le support "CROSS_WORDS". - Valeurs possibles : UDM_CROSS_WORDS_ENABLED et UDM_CROSS_WORDS_DISABLED. - </simpara> - <simpara> - La fonctionnalité "CROSS_WORDS" vous permet d'effectuer des recherches - dans les balises (entre <a href="xxx"> </a>), pour - utiliser le nom du lien. Ce mode fonctionne avec les bases de données - SQL et n'est pas supporté par les modes intégrés ou le cache. - </simpara> - <note> - <simpara> - CROSS_WORDS est supporté à partir de mnoGoSearch 3.1.11. - </simpara> - </note> - </listitem> - </itemizedlist> - </refsect1> - </refentry> - </reference> + </listitem> + <listitem> + <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 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. + </simpara> + </listitem> + <listitem> + <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.. 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 utilisé pour des + raisons d'orthographe. Pour activer ispell, vous devez charger les + données ispell avec la fonction + <function>udm_load_ispell_data</function>. + </simpara> + </listitem> + <listitem> + <simpara> + UDM_PARAM_CROSS_WORDS - Active ou désactive le support + "CROSS_WORDS". Valeurs possibles : UDM_CROSS_WORDS_ENABLED et + UDM_CROSS_WORDS_DISABLED. + </simpara> + <simpara> + La fonctionnalité "CROSS_WORDS" vous permet d'effectuer des + recherches dans les balises (entre <a href="xxx"> </a>), + pour utiliser le nom du lien. Ce mode fonctionne avec les bases de + données SQL et n'est pas supporté par les modes + intégrés ou le cache. + </simpara> + <note> + <simpara> + CROSS_WORDS est supporté à partir de mnoGoSearch + 3.1.11. + </simpara> + </note> + </listitem> + <listitem> + <simpara> + UDM_PARAM_VARDIR - spécifie un chemin spécifique sur le + disque où l'indexeur enregistre les données lorsqu'il + utilise le cache et les bases de données internes. Par + défaut, le dossier <literal>/var</literal> de l'installation + de <application>mnoGoSearch</application> est utilisé. Ce + paramètre est disponible en PHP 4.0.7 et plus récent. + </simpara> + </listitem> + </itemizedlist> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml