<?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-30-search" type="topic" xml:lang="fr">

  <info>
    <desc>Pour effectuer une recherche rapide.</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>

  <!-- ============= Search  ============-->

  <title>Recherche simple</title>

  <p>Pour effectuer une recherche rapide dans le texte Biblique ou le commentaire en cours, la fonction de recherche du volet latéral est en général adéquate. Cliquez sur le menu <guiseq><gui>Éditer</gui><gui>Rechercher</gui></guiseq> ou le bouton <gui>Rechercher</gui> du volet latéral pour l'activer.</p>

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

  <p>Le formulaire <gui>Rechercher</gui> est constitué des éléments suivants :</p>

  <list>
    <item>
      <p>Boite de saisie de l'expression à rechercher</p>
    </item>
    <item>
      <p>Sélecteur du module objet de la requête</p>
    </item>
    <item>
      <p>Sélecteur du type de requête</p>
    </item>
    <item>
      <p>Case à cocher des options de la requête</p>
    </item>
    <item>
      <p>Sélecteur de la plage de versets</p>
    </item>
    <item>
      <p>Affichage des résultats</p>
    </item>
  </list>

  <section id="xiphos-search-key">

    <title>Boite de saisie de l'expression à rechercher</title>

    <p>La boite d'entrée permet de saisir l'expression à rechercher. Cette expression peut être un mot, une partie de mot, plusieurs mots, une phrase, ou une expression rationnelle suivant le type de requête sélectionné. Une fois l'expression à rechercher saisie, et les options définies, un clic sur le bouton <gui>Rechercher</gui> démarre la séquence de recherche.</p>

    <p>Cette requête employe la méthode de recherche optimisée (Voir la section suivante) si le module concerné a été précédemment indexé, et utilise le ET logique par défaut (les versets doivent contenir tous les mots saisis)</p>

  </section>

  <section id="xiphos-search-modselect">

    <title>Sélecteur du module objet de la requête</title>

    <p>Permet la sélection du module sur lequel la requête sera exécutée. Sélectionner <gui>Texte biblique</gui> pour exécuter une requête dans le texte biblique ou <gui>Commentaire</gui> pour le module de commentaires. La requête ne s'exécute que dans les modules en cours de consultation.</p>

  </section>

  <section id="xiphos-search-typeselect">

    <title>Sélecteur du type de requête</title>

    <p>Permet se sélectionner le type de requête. Trois types de requête sont possibles :</p>

    <terms>
      <item>
	<title><gui>Mots multiples</gui></title>

	<p>Ce type retournera les versets contenant tous les mots de l'expression à rechercher, quelque soit l'ordre dans lequel ils apparaissent dans le verset. Par défaut, la recherche rapide de type « Lucène » est utilisée, avec repli sur la variante de recherche ordinaire « multi-mots » plus lente en l'absence d'un index.</p>
      </item>

      <item>
	<title><gui>Expression rationnelle</gui></title>
	<p>Cette requête utilise une expression rationnelle comme clé de recherche. Une expression rationnelle est basée sur un langage et une syntaxe spécifiques permettant de retrouver un mot, une phrase à l'aide de combinaisons complexes. Par exemple l'expression rationnelle <input>\ A[a-z]*iah </input> permet de retrouver les passages qui contiennent les mots Aiah, Ahaziah, Athaliah et Amariah.</p>

	<p>Un exposé complet de l'emploi des expressions rationnelles dépasse le cadre de ce manuel, mais plus d'information à ce sujet peut être obtenu en parcourant le manuel de <cmd>grep</cmd>.</p>
      </item>

      <item>
	<title><gui>Phrase exacte</gui></title>

	<p>Ce type retournera les résultats correspondants à la clé de recherche exactement comme elle a été saisie. Si la phrase à rechercher est <input>en vérité</input>, les passages obtenus contiendront « <em>en vérité</em> », mais pas « <em>en</em> toute <em>vérité</em> ».</p>
      </item>

    </terms>
  </section>

  <section id="xiphos-search-options">

    <title>Case à cocher des options de la requête</title>

    <p>Permet de définir les options de recherche. La seule option disponible est <gui>Respecter la casse</gui>. Cocher cette boîte rend la recherche sensible à la casse des caractères.</p>
  </section>

  <section id="xiphos-search-scopeselect">

    <title>Sélecteur de la plage de versets</title>

    <p>Permet de définir la plage de versets à parcourir dans le module spécifié. Trois plages de recherche sont possibles :</p>

    <terms>
      <item>
	<title><gui>Sans limites</gui></title>

	<p>Ce bouton entraîne une exécution de requête sur l'ensemble des versets.</p>
      </item>

      <item>
	<title><gui>Avec des limites</gui></title>

	<p>En sélectionnant ce bouton, vous ouvrez deux zones supplémentaires de saisie des limites de la recherche. Le premier livre, début de la recherche, est à saisir dans la limite <gui>Basse</gui> et le deuxième livre, fin de la recherche, dans la limite <gui>Haute</gui>. La requête commencera au premier verset du livre indiqué dans la limite <gui>Basse</gui> et se terminera au dernier verset du livre indiqué dans la limite <gui>Haute</gui>, en incluant tous les versets situés entre les deux limites.</p>

	<p>Des numéros de chapitres ou de versets peuvent aussi être saisis dans les deux zones basse et haute afin de mieux cibler la recherche.</p>
      </item>

      <item>
	<title><gui>Dernière requête</gui></title>

	<p>Sélectionner ce bouton pour relancer une recherche uniquement sur les  versets retournés en résultat de la requête précédente. Utilisée avec une nouvelle expression, cette méthode permet de réduire la liste des versets restitués.</p>
      </item>
    </terms>
  </section>

  <section id="xiphos-search-results">

    <title>Affichage des résultats</title>

    <p>Ceci affiche la liste des résultats de la dernière recherche, pour les aperçus, la navigation ou l'enregistrement sous forme de signets.</p>
    <terms>
      <item>
	<title>Aperçu</title>

	<p>Pour visualiser le résultat, un simple clic sur un élément affiche le contenu dans le volet <gui>Aperçu</gui></p>
      </item>

      <item>
	<title>Navigation</title>

	<p>La navigation vers le chapître concerné pour retrouver le contexte s'effectue de deux manières. Un clic du bouton milieu de la souris ouvre le verset dans un nouvel onglet, un double-clic l'ouvre dans l'onget courant.</p>
      </item>

      <item>
	<title>Enregistrer les résultats</title>

	<p>Les résultats de la requête peuvent être enregistrés sous forme de signets. Dans le menu contextuel obtenu à l'aide du bouton droit de la souris, sélectionner <gui>Convertir en signets</gui>, il sera alors demandé le nom du dossier sous lequel la liste sera enregistrée. Ensuite, une fois la liste sauvegardée, il devient possible de retrouver les résultats de la requête en affichant les signets puis en choisissant le dossier précédemment dénommé.</p>
      </item>

    </terms>
  </section>

</page>
