<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" id="xiphos-31-advanced-search" type="topic" xml:lang="fr">

  <info>
    <desc>Pour des recherches complexes dans la fenêtre de Recherche Avancée.</desc>

    <link type="guide" xref="index#search-function"/>

    <revision pkgversion="4.1.0" date="2018-04-24" status="draft"/>
    <revision pkgversion="4.1.0" date="2018-05-28" status="candidate"/>

    <title type="link" role="trail"/>
    <title type="text">Xiphos</title>

    <credit type="author" its:translate="no">
      <name>Andy Piper</name>
    </credit>
    <credit type="author" its:translate="no">
      <name>Pierre Benz</name>
    </credit>
    <credit type="author" its:translate="no">
      <name>Dr Peter von Kaehne</name>
    </credit>
    <credit type="author" its:translate="no">
      <name>Karl Kleinpaste</name>
    </credit>
    <credit type="author" its:translate="no">
      <name>Matthew Talbert</name>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

  </info>

  <!-- xiphos-advanced-search -->

  <title>Recherche avancée</title>

  <p>Des recherches plus élaborées peuvent nécessiter l’utilisation des fonctions de recherche avancée, activées par l’utilisation du  menu <guiseq><gui>Éditer</gui><gui>Recherche avancée</gui></guiseq>.</p>

  <media style="image" mime="image/png" src="figures/search_search.png"/>

  <p>La <gui>Recherche avancée</gui> permet de construire des requêtes bien plus élaborées. Les  limites du texte et les listes de modules peuvent être  enregistrées pour servir ultérieurement. Les requêtes peuvent s’effectuer sur les attributs du texte comme les notes de bas de page ou les références de Strong des dictionnaires grec et hébreu.</p>

  <p>La requête par défaut utilise une méthode de recherche rapide de type « Lucène ». C’est une recherche optimisée nécessitant au préalable la construction d’un index; Voir la page « Maintenance » du <gui>Gestionnaire de modules</gui> pour la création d’index. En l’absence d’index, la recherche se fait en mode multi-mots, plus lente, elle peut d’alleurs être sélectionnée délibérement. Une recherche sur Internet fournira plusieurs références sur la syntaxe nécessaire pour mettre à profit la puissance des requêtes optimisées Lucene. Quelques exemples suivent :</p>

  <p>Requêtes simples : saisir simplement les mots recherchés. Pour obtenir seulement les versets contenant tous les mots, il suffit de faire précéder les mots du signe « <em>+</em> ». Ainsi la requête « <em>+L’Eternel +mon +berger</em> » trouve le Psaume 23. Pour rechercher une phrase entière, il suffit de l’entourer de guillemets, comme dans " <em>Il me fait reposer dans de verts pâturages</em> ".</p>

  <p>Caractère de substitution unique ( ? ) : Le «­­ ? » représente un caractère quelconque. Par exemple, « <em>cri?</em> » permet de rechercher « <em>cris</em> », « <em>crie</em> »,·« <em>crié</em> » etc.. Ceci est pratique pour retrouver les noms qui peuvent avoir plusieurs écritures ainsi, « <em>?saïe</em> » retournera « Ésaïe » ou « Isaïe ».</p>

  <p>Caractère de substitution multiple ( * ) : « * » remplace toute une série de caractères. Ainsi « <em>proph*</em> » retrouve « prophète », « prophétiser », « prophétie » etc..</p>

  <p>Syntaxe AND : Dans la recherche avancée, pour retourner les résultats pour tous les termes d’une requête, il est nécessaire de placer l’opérateur logique « <em>AND</em> » entre les termes. Ainsi pour retrouver les occurences de « Isaïe » ou « Esaïe » qui font mention également de « prophète » ou « prophétie », la requête appropriée est « <em>?saïe AND proph*</em> ».</p>

  <p>Par défaut, deux plages de versets sont définies, correspondant à l’Ancien Testament et au Nouveau Testament. D’autres limites peuvent être définies à volonté par l’utilisateur comme par exemple les « Évangiles » ou les « Épîtres de Paul ». Une liste des modules contenant seulement le premier module de texte biblique installé est définie par défaut. Si besoin, de nouvelles requêtes peuvent être réalisés sur la plage des versets obtenu par la requête précédente. Des listes de modules peuvent être crées en incluant tout module, ce qui permet d’exécuter des requêtes sur les livres ou les dictionnaires, dans n’importe quelle combinaison.</p>

  <p>Noter la bulle d’aide dans la capture d’écran ci-dessus, Cette option est utilisée pour exécuter des requêtes sur les attributs relatifs à des versets et non sur le contenu des versets. Les attributs sont par exemple les notes de bas de page ou les nombres de Strong grec et hébreu. Si cette option est sélectionnée, les qualificatifs d’attribut doivent être saisis dans  l’onglet Attribut, situé à droite des autres onglets. Les références de Strong  sont identifiées par le nombre de Strong précédé par la lettre « H » (Hébreu) ou la lettre « G » (Grec). Ainsi une requête sur le nombre de Strong grec n° 140, en utilisant « G140 », retourne  Matthieu 12:18 comme résultat.</p>

  <p>Si vos modules sont indexés, il existe un moyen beaucoup plus rapide pour rechercher des références de Strong. Une requête doit être précédée du mot « <em>lemma</em> », par exemple pour rechercher le nombre de Strong grec 140, saisir « <em>lemma:G140</em> ». Le bouton radio <gui>Optimisée Lucene</gui> doit être sélectionné pour que cette requête fonctionne.</p>

  <p>Des explications sur la syntaxe de recherche sont accessibles quand soit « Optimisée lucène » ou « Attributs » sont sélectionnés.</p>

  <p>Comme spécifié dans l’infobulle, le bouton <gui>Rechercher</gui> stoppe aussi une requête en cours d’exécution.</p>

  <p>Les résultats sont affichés dans l’onglet <gui>Résultats</gui>. Pour inclure les nombres de Strong, les étiquettes morphologiques ou les notes de bas de page, sélectionnez ces options dans l’onglet <gui>Attributs</gui>. Un simple clic sur un résultat affiche le contenu dans le volet <gui>Aperçu</gui> de la fenêtre <gui>Recherche Avancée</gui>. Un survol des nombres de Strong, étiquettes morphologiques ou notes de bas de page affiche le contenu dans le volet <gui>Aperçu</gui> de la fenêtre principale. Un double-clic fait naviguer l’onglet courant à la portion du texte contenant le résultat, ceci s’applique également aux commentaires et aux livres à la condition que les respectifs volets soient visibles.</p>

  <note style="warning">
    <p>Les changements d’options (étendue de la recherche, modules à rechercher, etc) dans la fenêtre de recherche avancée sont reportés au niveau des options de la recherche simple du <gui>volet latéral</gui> mais pas l’inverse.</p>
  </note>

</page>
