Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:search [2013-08-12 14:26] – [L'opérateur OU (or)] 90.83.102.195
+++ fr:search [2023-11-29 11:20] (Version actuelle) – update searchindex mechanism, various improvements... schplurtz
@@ Ligne 1: / Ligne 1: @@
 ====== Recherche ======
-La recherche se fait dans la boîte prévue à cet effet, en haut à droite pour [[template|le modèle]] de DokuWiki installé par défaut.
+La recherche se fait dans la boîte prévue à cet effet, en haut à droite pour [[fr:template|le thème]] de DokuWiki installé par défaut.
 ===== Syntaxe =====
-Fondamentalement, DokuWiki effectue la recherche par un « ET » logique. Cela signifie que tous les mots que vous avez mis dans la requête seront utilisés. La recherche est insensible à la casse.
+Fondamentalement, DokuWiki effectue la recherche par un « ET » logique. Cela signifie que tous les mots que vous avez mis dans la requête seront utilisés. La recherche est insensible à la casse.
-Les syntaxe concernant la recherche avancée de DokuWiki sont décrites ci-dessous. Toutes les syntaxes peuvent être combinées ensembles. Dans cette section, nous allons utiliser les crochets ''[…]'' pour représenter les caractères inscrits dans la requête.
+Les syntaxes concernant la recherche avancée de DokuWiki sont décrites ci-dessous. Toutes les syntaxes peuvent être combinées ensembles. Dans cette section, nous allons utiliser les crochets ''[…]'' pour représenter les caractères saisis dans la requête.
 ==== Termes à exclure (-) ====
-Vous pouvez placer un tiret ''-'' juste avant un mot-clé pour exclure de vos résultats de recherche les pages qui contiennent ce mot-clé. Par exemple, la requête ''%%[ dokuwiki -plugin ]%%'' trouvera les pages qui contiennent « DokuWiki » mais pas « plugin ».
+Vous pouvez placer un signe moins ''-'' juste avant un mot-clé pour exclure de vos résultats de recherche les pages qui contiennent ce mot-clé. Par exemple, la requête ''%%[ dokuwiki -plugin ]%%'' trouvera les pages qui contiennent « DokuWiki » mais pas « plugin ».
 Vous pouvez utiliser cette syntaxe ''-'' pas seulement pour un mot-clé, mais aussi pour tout autre type de recherche décrit ci-dessous.
-Par exemple, vous pouvez utiliser la requête ''%%[ -"expression à exclure" ]%%'' pour exclure une expression.
+Par exemple, vous pouvez utiliser la requête ''%%[ -"phrase à exclure" ]%%'' pour exclure des résultats les pages contenant la suite exacte de mot « phrase à exclure ».
 ==== Correspondance partielle (*) ====
 Vous pouvez effectuer une correspondance partielle en préfixant ou suffixant un astérisque * à un mot.
-Par exemple, la recherche de ''[ wiki ]'' ne trouvera que des « wiki », mais la recherche de ''[ *wiki ]'' trouvera également « DokuWiki » (suffixe correspondant).
+Par exemple, la recherche de ''[ wiki ]'' ne trouvera que des « wiki », mais la recherche de ''[ *wiki ]'' trouvera également « DokuWiki » (suffixe correspondant).
 Vous pouvez également utiliser ''[ doku* ]'' (préfixe correspondant) et ''[ *okuwik* ]'' (correspondance partielle).
-Notez que * n'est pas un « joker », vous ne pouvez pas l'utiliser dans un mot : la recherche ''[ doku*iki ]'' ne trouvera rien.
+Notez que * n'est pas un « joker », vous ne pouvez pas l'utiliser dans un mot : la recherche ''[ doku*iki ]'' ne trouvera rien.
-==== Recherche d'expressions ("") ====
+==== Recherche d'expressions exactes ("") ====
-Vous pouvez rechercher des expressions exactes en mettant des guillemets américains (doubles quotes) autour d'un ensemble de mots, par exemple ''%%[ "installer dokuwiki" ]%%''.
+Vous pouvez rechercher des expressions exactes en mettant des guillemets droits (doubles quotes) autour d'un ensemble de mots, par exemple ''%%[ "installer dokuwiki" ]%%''.
-==== Recherche au sein d'un espace de noms (@) ====
+==== Recherche au sein d'une catégorie (@) ====
-Vous pouvez restreindre la recherche aux espaces de noms. Pour cela, préfixez l'espace de nom par ''@'' ou par ''ns:''. Pour ne pas rechercher des pages au sein d'un espace de noms, préfixez par ''^'' ou par ''-ns:''.
+Vous pouvez restreindre la recherche à certaines [[namespaces|catégories]]. Pour cela, préfixez la catégorie d'un ''@'' ou de ''ns:''. Pour ne pas rechercher des pages au sein d'une catégorie,
+préfixez la de ''^'' ou de ''-ns:''.
-Par exemple, la requête ''[ dokuwiki @wiki ^wiki:docs ]'' trouvera les pages qui contiennent le mot « dokuwiki », sont situées dans l'espace de noms « wiki » mais pas dans l'espace de noms « wiki:docs ». La requête ''[ dokuwiki ns:wiki -ns:wiki:docs ]'' fera la même chose.
+Par exemple, la requête ''[ dokuwiki @wiki ^wiki:docs ]'' trouvera les pages qui contiennent le mot « dokuwiki », sont situées dans la catégorie « wiki » mais pas dans
+la catégorie « wiki:docs ». La requête ''[ dokuwiki ns:wiki -ns:wiki:docs ]'' fera la même chose.
-==== L'opérateur OU (or / |) ====
+==== L'opérateur OU ( or / | ) ====
+Par défaut, DokuWiki effectue un ET logique pour la recherche, mais vous pouvez également utiliser un OU logique à l'aide de ''|'' ou de ''OR'' comme séparateur des termes que vous
+recherchez. Par exemple, la requête ''[ plugin | template ]'' trouvera les pages contenant « plugin » ou « template ».
+La requête ''[ plugin or template ]'' fera la même chose. Vous pouvez utiliser OR comme alternative simple à la [[#correspondance_partielle|correspondance partielle (*)]], par exemple
+pour trouver des pages sur des personnes avec des variations orthographiques comme ''[ Frank | Franck ]''.
+L'opérateur OU a une plus faible priorité que celle de l'opérateur ET. Autrement dit, la requête ''[ dokuwiki plugin | template ]'' peut être représentée comme ''[ (dokuwiki plugin) | template ]'', mais pas comme ''[ dokuwiki (plugin | template) ]'' en utilisant un groupement de syntaxe (décrit ci-dessous).
+Si vous voulez [[#Recherche au sein d'une catégorie (@)|restreindre votre recherche à une catégorie]], vous devez grouper votre recherche avec "()", sinon une recherche du type [plugin | template @plugin] se comportera comme [ (plugin) | (template @plugin)], c'est-à-dire recherchera "plugin" OU "template @plugin" dans toutes les catégories, et non ce que vous pouvez obtenir avec l'expression correcte  (plugin | template) @plugin] soit "plugin" OU "template" dans l'espace de noms //plugin//.
-Par défaut DokuWiki effectue un ET logique pour la recherche, mais vous pouvez également utiliser un OU logique à l'aide de ''|'' ou de ''OR'' comme séparateur des termes que vous recherchez.
-Par exemple, la requête ''[ plugin | template ]'' trouvera les pages contenant « plugin » ou « template ».
-La requête ''[ plugin or template ]'' fera la même chose.
-L'opérateur OU a une plus faible priorité que celle de l'opérateur ET.
-Autrement dit, la requête ''[ dokuwiki plugin | template ]'' peut être représenté comme ''[ (dokuwiki plugin) | template ]'', mais pas comme ''[ dokuwiki (plugin | template) ]'' en utilisant un groupement de syntaxe (décrit ci-dessous).
 ==== Groupement de recherche ====
@@ Ligne 50: / Ligne 57: @@
 Ayant la plus haute priorité, les parenthèses peuvent être utilisées pour forcer la priorité.
-Par exemple, la requête ''[ dokuwiki -(plugin | @plugin) ]'' trouvera les pages qui contiennent le mot « DokuWiki » mais pas celles qui contiennent « plugin » ou qui sont dans l'espace de noms « plugin ».
+Par exemple, la requête ''[ dokuwiki -(plugin | @plugin) ]'' trouvera les pages qui contiennent le mot « DokuWiki » mais pas celles qui contiennent « plugin » ou qui sont dans la catégorie « plugin ».
 ===== Recherche rapide =====
-Vous pouvez entrer le début d'un [[pagename|nom de page]] dans la case de recherche et attendre une demi-seconde.
+Vous pouvez entrer le début d'un [[fr:pagename|nom de page]] dans la case de recherche et attendre une demi-seconde. Dans la plupart des navigateurs modernes, vous verrez automatiquement une boîte listant les pages trouvées.
-Dans la plupart des navigateurs modernes, vous verrez automatiquement une boite listant les pages trouvées.
 ===== OpenSearch =====
@@ Ligne 61: / Ligne 67: @@
 {{ :opensearch.png|OpenSearch dans Firefox}}
-[[http://www.opensearch.org/|OpenSearch]] est une norme facilitant l'intégration de la recherche d'un site web dans votre navigateur. Il est pris en charge par tous les navigateurs web modernes. DokuWiki permet la recherche avec OpenSearch.
+[[http://www.opensearch.org/|OpenSearch]] est une norme facilitant l'intégration dans votre navigateur de la fonction de recherche d'un site web. Il est pris en charge par tous les navigateurs web modernes. DokuWiki permet la recherche avec OpenSearch.
-Voici comment ajouter votre recherche wiki pour Firefox (le procédé est probablement similaire dans d'autres navigateurs) :
+Voici comment ajouter à Firefox la recherche dans votre wiki (le procédé est probablement similaire dans d'autres navigateurs) :
   - ouvrez votre wiki dans le navigateur ;
   - cliquez sur la petite flèche à gauche de votre zone de recherche ;
-  - choisissez //Ajouter « DokuWiki »// ((Il peut être nommé différemment si votre wiki est nommé différemment.))
+  - choisissez //Ajouter « DokuWiki »// ((Il peut être nommé différemment si votre wiki est nommé différemment.))
 ===== Quelques rappels sur l'index de recherche =====
-La version actuelle de DokuWiki intègre un index pour effectuer des recherches très rapidement même sur de très gros wikis. Pour pouvoir trouver quelque chose l'index doit être à jour. Les informations contenues dans une page sont intégrées dans l'index de recherche quand cette page est visualisée par un visiteur. Ainsi chaque page possède son double invisible appelé par le processus de recherche en cas de nécessité.
+La version actuelle de DokuWiki intègre un index pour effectuer des recherches très rapidement même sur de gros wikis. Pour pouvoir trouver quelque chose l'index doit être à jour.
+Les informations contenues dans une page sont intégrées dans l'index de recherche quand cette page est visualisée par un visiteur. Chaque page possède une image invisible, un [[wpfr>Pixel_espion]] dont le chargement déclenche le processus de mise à jour de l'index en cas de nécessité ((Notez que le pixel invisible est également utilisé pour d'autres
+tâches. Voir http://forum.dokuwiki.org/post/3116)), c'est à dire si la date de modification de la page est plus récente que la date de modification du fichier d'index.
+L'index est constitué de fichiers nommés ''page.idx'', ''i//[n]//.idx'',  et ''w//[n]//.idx'' situés dans le dossier ''index''. ''w//[n]//.idx''
+contient la liste de tous les mots (à l'exception des mots écartés) d'une longueur de //n// qui apparaissent sur les pages du wiki. Pour chaque ligne du fichier ''w//[n]//.idx''
+il y a une ligne dans le fichier ''i//[n]//.idx'' correspondant qui contient des références de pages sous la forme  ''pn*freq''. ''pn'' est l'offset en ligne dans le fichier ''page.idx'' et
+''freq'' indique à quelle fréquence le mot apparaît sur la page. Les références de plusieurs pages sont séparées par deux points.
+Certains mots sont écartés de l'index. Le programme d'[[taskrunner|indexation]] utilise des fichiers spécifiques à chaque langue contenant une liste de mots très communs (comme l'article ''le'' en Français). Ces mots sont écartés de l'index, la recherche
+sur un tel mot ne retourne aucun résultat. Vous pouvez éditer le fichier ''stopwords.txt'' situé dans le dossier de la langue d'installation de DokuWiki : <dokuwiki>/inc/lang/<language>/stopwords.txt
+pour ajouter ou supprimer des mots qui ne sont pas indexés dans votre langue. Malheureusement, ces modifications sont perdues lors des mises à jour de DokuWiki.
+Si vous faites une mise à jour d'une ancienne version de votre wiki sans index, vos recherches ne renverrons rien tant que l'index ne sera pas mis à jour. Vous pouvez mettre à jour
+l'index en visitant manuellement chaque page de votre wiki ou en installant l'extension [[plugin:searchindex]] qui le fera pour vous. Un script en [[cli|ligne de commande]] est également
+fourni avec DokuWiki.
+===== Voir aussi =====
-L'index est constitué de 3 fichiers nommés respectivement ''index.idx'', ''page.idx'' et ''word.idx'' situés dans le répertoire « cache ».
+  * [[fr:faq:searchindex|Problème d'indexation (pour la recherche de pages)]]
+  * [[fr:config:search_fragment|Paramètre de configuration: search_fragment]]
+  * [[fr:config:search_nslimit|Paramètre de configuration: search_nslimit]]
+  * [[fr:config:readdircache|Paramètre de configuration: readdircache]]
+  * [[plugintag>search|Extensions avec l'étiquette "search"]]
-Les programmes d'[[fr:indexer|indexation]] utilisent des fichiers spécifiques à chaque langue contenant une liste de mots très communs (comme l'article ''le'' en Français). La recherche sur un tel mot ne retourne aucun résultat.
+===== Crédits =====
-Si vous faites une mise à jour d'une ancienne version de votre wiki sans index, vos recherches ne renverrons rien tant que l'index ne sera pas mis à jour. Vous pouvez mettre à jour l'index en visitant manuellement chaque page de votre wiki ou bien en utilisant un script en [[cli|ligne de commande]] fourni avec DokuWiki.
+  * Mise à jour :  --- [[user>Digitalin|Digitalin]] //2018-10-28 20:05//
+  * Mise à jour :  --- [[user>schplurtz|schplurtz]] //2023-11-29 05:38//