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

  <info>
    <desc>Une description des différentes zones de la fenêtre principale de Xiphos.</desc>

    <link type="guide" xref="index#getting-started"/>

    <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>

  <title>Fenêtre principale de Xiphos</title>

  <section id="menubar">
    <!-- ============= Menubar  ============-->

    <title>Barre de menu</title>
    <p>Tout en haut de la fenêtre principale de <app>Xiphos</app> se situe la <gui>Barre de menu</gui>. Pratiquement toutes les fonctions sont activables en utilisant l'un ou l'autre des éléments appropriés du menu. Les différentes fonctions sont regroupées par type. Par exemple, les opérations sur les fichiers sont regroupées dans le menu  <gui>Fichier</gui>.</p>
    <media type="image" mime="image/png" src="figures/interface_menubar.png"/>
  </section>

  <section id="toolbars">
    <!-- ============= Toolbars  ============-->

    <title>Barres d'outils</title>
    <p>La fonction de la <gui>Barre d'outils</gui> est de commander le volet des <gui>Textes bibliques.</gui> et des <gui> Commentaires</gui>. Les commandes sont activées par un clic de la souris sur un des boutons de la barre d'outils. Si le curseur de la souris est déplacé au-dessus d'un des boutons, à ce moment-là une bulle d'aide apparaît, décrivant la fonction de ce bouton.</p>
    <media type="image" mime="image/png" src="figures/interface_toolbar.png"/>

    <p>La <gui>Barre d'outils</gui> présente les fonctions suivantes :</p>
    <list>
      <item>
	<p>Boutons de déplacement dans l'historique des versets consultés</p>
      </item>
      <item>
	<p>Sélecteur de livre de la Bible</p>
      </item>
      <item>
	<p>Sélecteur de chapitre de la Bible</p>
      </item>
      <item>
	<p>Sélecteur de verset de la Bible</p>
      </item>
      <item>
	<p>Zone de saisie d'une référence biblique</p>
      </item>
    </list>

    <section id="xiphos-selector">
      <title>Boutons de déplacement avant/arrière dans l'historique.</title>
      <p>Permettent de se déplacer dans l'historique des passages consultés.</p>
    </section>

    <section id="xiphos-toolbar-book">
      <title>Sélecteur de livre de la Bible</title>
      <p>Sélectionne un livre de la Bible à afficher dans le volet des <gui>textes bibliques</gui> et celui des <gui>Commentaires</gui>. Le changement prend effet immédiatement.</p>
    </section>

    <section id="xiphos-toolbar-chapter">
      <title>Sélecteur de chapitre de la Bible</title>
      <p>Sélectionne un chapitre du livre de la Bible actuelle à afficher dans le volet des <gui>textes bibliques</gui> et celui des <gui>Commentaires</gui>. Le changement prend effet immédiatement.</p>
    </section>

    <section id="xiphos-toolbar-verse">
      <title>Sélecteur de verset de la Bible</title>
      <p>Sélectionne un verset du chapitre en cours à afficher dans le volet des <gui>textes bibliques</gui> et celui des <gui>Commentaires</gui>. Le changement prend effet immédiatement.</p>
    </section>

    <section id="xiphos-toolbar-summary">
      <title>Zone de saisie d'une référence biblique</title>
      <p>Permet la saisie manuelle d'un passage à afficher dans le volet des <gui>textes bibliques</gui> et celui des <gui>Commentaires</gui>. Le changement prend effet immédiatement après appui sur la touche <key>Entrée</key>.</p>
      <note style="warning">
	<p>Bien s'assurer que les valeurs de livre, chapitre et verset sont correctes, sans quoi le résultat obtenu sera erroné voire simplement absent.</p>
      </note>
    </section>

  </section>

  <section id="xiphos-sidebar">
    <!-- ============= Sidebar  ============-->

    <title>La barre d'outils</title>
    <media type="image" mime="image/png" src="figures/interface_sidepane.png"/>

    <p>Sur la partie gauche de la fenêtre principale de <app>Xiphos</app> vous trouverez le <gui>volet latéral</gui>. Il vous permet de faire votre sélection de modules Sword, de gérer et utiliser les signets, d'effectuer des recherches basiques ou encore d'afficher les listes de versets. Dans la liste des modules, la sélection d'un module affiche son contenu dans la fenêtre principale. En ouvrant le menu contextuel par un click droit sr le module, d'autres possibilités sont permises comme ouvrir le module dans un nouvel onglet, l'ouvrir dans une fenêtre distincte, ou consulter l'information «_À propos » du module.</p>

    <p>Pour basculer entre toutes les fonctions du volet latéral, les boutons ont été placés au sommet du volet latéral.</p>
    <media style="image" mime="image/png" src="figures/interface_shortcut.png"/>
  </section>


  <section id="xiphos-bible">

    <!-- ============= Bible Text Pane  ============-->
    <title>Le volet des textes bibliques</title>
    <media style="image" mime="image/png" src="figures/interface_biblepane.png"/>
    <p>Sur la droite du volet latéral, vous trouverez le volet des <gui>textes bibliques</gui>. Les traductions de la Bible sont affichées dans ce volet. Au démarrage de <app>Xiphos</app>, la version utilisée dans l'onglet situé précédemment le plus à gauche est affichée par défaut.</p>

    <section id="xiphos-bible-open">
      <title>Ouvrir une version différente de la Bible</title>
      <p>Pour remplacer la version de la Bible en cours d'utilisation par une autre version :</p>
      <list>
	<item>
	  <p>Un clic du bouton droit de la souris dans le volet d'affichage des <gui>textes bibliques</gui> ouvre le menu contextuel. Dans ce menu, choisir <guiseq><gui>Fichier</gui><gui>Ouvrir le module</gui></guiseq> et ensuite vous pouvez sélectionner la version que vous souhaitez étudier.</p>
	</item>
	<item>
	  <p>Ou après avoir activé l'option <gui>Modules</gui> du <gui>volet  latéral</gui>, choisir <guiseq><gui>Textes  bibliques</gui><gui>langue de votre choix </gui></guiseq> et vous pouvez ensuite sélectionner la version désirée.</p>
	  </item>
      </list>
    </section>

    <section id="xiphos-bible-parallel">
      <title>Utilisation du mode Vue parallèle</title>

      <p>A nice function in <app>Xiphos</app> is the ability to view your
      specified bible text in several parallel translations of your choice. The
      Parallel View mode can be accessed by selecting <gui>Parallel View</gui> 
      just below the <gui>Bible Text Pane</gui>, next to the <gui>Standard View
      </gui> tab.</p>

      <p>Vous devez choisir au préalable quels modules afficher en parallèle dans la boîte de dialogue <gui>Préférences</gui>, à ouvrir depuis le menu <gui>Édition</gui>. Dans la boîte de dialogue, sélectionner Modules, puis en parallèle. Il est possible d'ajouter ou de soustraire de la liste les modules qui seront ensuite affichés dans la vue parallèle. La barre d'outils est munie des outils de sélection pour effacer la liste, supprimer un module de la liste, et ajouter des modules à cette liste.</p>

      <p>Le mode <gui>Vue parallèle</gui> affiche un seul verset à la fois. Il est possible de changer de verset, chapitre ouo livre en utilisant les sélecteurs de la barre d'outils. Il est à noter également que les modules de texte contenant seulement le Nouveau Testament ou seulement l'Ancien Testament (ex. Westminster Leningrad Codex, Byzantine Majority Text) n'afficheront pas les livres, chapitres, versets qu'ils n'ont pas.</p>
      <media style="image" mime="image/png" src="figures/interface_parallel.png"/>

      <p>Par ailleurs, une fenêtre spécifique de vue parallèle peut être ouverte au moyen du menu contextuel obtenu par un clic droit de la souris sur la vue parallèle, et sélection de <gui>Détacher/Attacher</gui>. Votre volet des <gui>textes bibliques</gui> revient alors à la vue simple et la nouvelle fenêtre <gui>Vue parallèle</gui> s'ouvre affichant cette fois le chapitre courant en entier dans la même sélection de versions.</p>
      <media style="image" mime="image/png" src="figures/interface_parallel-separate.png"/>
    </section>

    <section id="xiphos-bible-open-separate">
      <title>Ouvrir le texte·biblique dans une fenêtre distincte</title>
      <p>Pour ouvrir un texte biblique dans une fenêtre distincte de la fenêtre principale de <app>Xiphos</app>, choisissez dans l'option <gui>Modules</gui> du <gui>volet latéral</gui>, <guiseq><gui>Textes bibliques</gui><gui>langue de votre choix</gui></guiseq>. Faites ensuite un clic droit sur la version souhaitée, puis dans le menu contextuel qui s'affiche, choisissez l'option <gui>Ouvrir dans une fenêtre</gui>. Le module s'ouvrira alors dans une fenêtre séparée.</p>

      <p>Les fenêtres séparées de texte biblique ou de commentaire ont un bouton de synchronisation dans le coin supérieur gauche à côté de la barre de navigation. Lorsque ce bouton est activé, le texte biblique et le commentaire de la fenêtre principale sont synchronisés avec le contenu de la fenêtre distincte. La synchronisation se fait dans les deux sens: Toute fenêtre indépendante permettra de synchroniser la navigation avec toutes les autres fenêtres individuelles plus la fenêtre principale, et la fenêtre principale synchronisera tous les textes bibliques et commentaires des fenêtres distinctes dont le bouton de synchronisation est activé.</p>
    </section>

    <section id="xiphos-bible-about">
      <title>Rechercher les informations à propos de la version courante.</title>
      <p>Pour obtenir des informations à propos de la version de la Bible en cours :</p>
      <list>
	<item>
	  <p>Cliquer du bouton droit de la souris dans le volet des <gui>textes bibliques</gui>. Dans le menu contextuel qui s'affiche, sélectionner <gui>À propos</gui>.</p>
	</item>
	<item>
	  <p>Dans l'option <gui>Modules</gui> du <gui>volet latéral</gui>, choisir <guiseq><gui>Textes bibliques</gui><gui>langue de votre choix</gui></guiseq>. Cliquer du bouton droit de la souris sur la version souhaitée, puis dans le menu contextuel qui s'affiche, choisir l'option <gui>À propos</gui>.</p>
	</item>
      </list>
    </section>

    <section id="xiphos-bible-options">
      <title>Options des modules</title>
      <p>De nombreux modules de textes bibliques proposent des options additionnelles que vous pouvez activer suivant vos besoins.</p>
      <list>
	<item>
	  <p>Paroles de Christ en rouge</p>
	</item>
	<item>
	  <p>Nombres de Strong</p>
	</item>
	<item>
	  <p>Étiquettes morphologiques</p>
	</item>
	<item>
	  <p>Notes de bas de page</p>
	</item>
	<item>
	  <p>Références croisées de l'Écriture</p>
	</item>
	<item>
	  <p>Entêtes</p>
	</item>
	<item>
	  <p>Afficher les images</p>
	</item>
      </list>
      <note>
	<p>Les versions en d'autres langues tel le grec ou l'hébreu offrent des options particulières qui ne s'appliquent qu'à ces langues.</p>
      </note>
      <p>pour accéder à ces options :</p>
      <list>
	<item>
	  <p>Cliquer du bouton droit de la souris dans le volet des <gui>textes bibliques</gui>. Dans le menu contextuel qui s'affiche, choisir <gui>Options du module</gui>, et vous pouvez ensuite sélectionner l'option désirée.</p>
	</item>
      </list>
      <media style="image" mime="image/png" src="figures/interface_biblepane-options.png"/>
    </section>

    <section id="xiphos-view-options">
      <title>Options d'affichage</title>
      <p>Plusieurs modes supplémentaires peuvent être sélectionnés à l'aide du menu <gui>Afficher</gui> de la barre de menu.</p>
      <media style="image" mime="image/png" src="figures/interface_menubar-view.png"/>

      <p>Les 4 premières options commandent l'affichage des différents volets de l'interface. L'état d'affichage de chaque volet est spécifique à un onglet. Ceci permet, par exemple, d'avoir un onglet dédié à l'affichage des cartes (module dictionnaire avec les lieux triés alphabétiquement), en suspendant l'affichage des volets <gui>Textes bibliques</gui>, <gui>Commentaires</gui> et <gui>Aperçu</gui>.</p>

      <p>Les options restantes commandent les autres options d'affichage.</p>
      <list>
	<item>
	  <p><gui>Onglets liés</gui> - Par défaut, quand plus d'un onglet est ouvert, il est permis dans chacun de naviguer individuellement dans les textes bibliques. Quand cette option est activée, tous les onglets sont liés ensemble, et affichent le même verset.</p>
	</item>
	<item>
	  <p><gui>Synthèse vocale</gui> - Quand cette option est activée, <app>Xiphos</app> lit à voix haute les versets sélectionnés à l'aide du logiciel de synthèse vocale <app>Festival</app>. Le moteur de synthèse vocale <app>Festival</app> est largement utilisé et souvent installé par défaut dans les distributions Linux. (NDT: En général, les résultats sont meilleurs en anglais ).</p>

	  <p>De même, vous pouvez utiliser la synthèse vocale sur des portions de textes bibliques, commentaires ou livres mis en surbrillance. Cliquer du bouton droit de la souris dans le texte sélectionné, puis activer <gui>Synthèse vocale du texte sélectionné</gui> dans le menu contextuel obtenu, ceci indépendamment de l'option <gui>Synthèse vocale</gui>.</p>
	</item>
	<item>
	  <p><gui>Affiche les numéros de versets</gui> - Normalement activée, cette option peut être désactivée pour ne pas afficher les numéros de versets dans le texte. </p>
	</item>
	<item>
	  <p><gui>Verset en cours contrasté</gui> - Désactivée par défaut, cette option permet de remplacer la couleur du verset en cours par une coloration au contraste plus élevée. Les couleurs sont modifiables dans la fenêtre de préférences.</p>
	</item>
      </list>
    </section>

    <section id="xiphos-default-css">
      <title>Contrôle de l'affichage avec les CSS</title>
      <p>Les utilisateurs familiers des feuilles de style en cascade (CSS) peuvent créer le fichier "default-style.css" dans le répertoire .xiphos et inclure dans ce fichier tout contrôle CSS souhaité. Attention, il est très facile de se tirer une balle dans le pied avec les CSS, et une erreur aura une incidence sur l'affichage de tous les modules. Cette disposition existe pour fournir aux utilisateurs avancés les moyens qu'ils souhaitent."</p>
    </section>

    <section id="xiphos-user-annotation">
      <title>Annotation personnelle</title>
      <p>De nombreux utilisateurs souhaitent ajouter des annotations personnelles sur certains versets, sans éprouver pour autant le besoin d'employer un module complet de commentaires personnels. <app>Xiphos</app> offre cette possibilité <gui>Annoter le verset</gui> dans le menu contextuel du volet biblique obtenu par un clic-droit. Une boite de dialogue s'affiche alors, elle indique la référence du verset en cours et offre une zone de saisie où entrer une brève annotation personnelle. Dès que la boite de dialogue est refermée avec <gui>Annoter</gui>, le verset est surligné (par défaut bleu sur jaune) et une marque <gui>*u</gui> est insérée au début du verset. Ceci est métaphoriquement similaire aux utilisateurs qui soulignent des versets dans leurs Bibles papier avec un surligneur jaune, et inscrivent des notes personnelles dans la marge.</p>

      <p>La sélection d'un verset déjà annoté, fait apparaître (dans le cas habituel) le contenu existant prêt pour être re-édité. L'annotation d'un verset peut être retirée; le verset cesse alors d'être affiché en surbrillance.</p>

      <p>Si l'utilisateur retire le nom du module de la référence affichée en haut de la boite de dialogue, l'annotation s'applique alors à n'importe quel module Biblique pour le verset sélectionné. Toutefois, dans ce cas, une nouvelle sélection du verset annoté ne fait pas afficher le contenu existant, car le contenu est lié à la référence du module original.</p>
    </section>

    <section id="xiphos-geography-support">
      <title>Support de la géographie</title>
      <p>Un lien pour naviguer sur le site BibleMap.org est fourni lors de la sélection au moyen de la souris d'un nom de lieu dans n'importe quel texte. Cliquez du bouton droit pour ouvrir le menu contextuel, puis sélectionnez <guiseq><gui>Définition du mot sélectionné</gui><gui>Recherche sur BibleMap.org</gui></guiseq>. Le navigateur web est alors démarré pour afficher le lieu géographique du nom sélectionné via BibleMap, qui donne des détails bibliques superposés sur une carte Google Maps.</p>
    </section>

    <section id="xiphos-bible-dictionary">
      <title>Définition d'un mot particulier</title>
      <p>Pour obtenir la définition d'un mot particulier, faire un double-clic à l'aide de la souris sur le mot désiré. Le mot se met en surbrillance et sa définition, si le mot est répertorié, s'affiche ensuite immédiatement dans le volet <gui>dictionnaire</gui>.</p>
    </section>

    <section id="xiphos-bible-find">
      <title>Rechercher un mot spécifique</title>
      <p>Pour rechercher un mot spécifique dans un passage :</p>
      <list>
	<item>
	  <p>Faire un clic droit à l'aide de la souris dans le volet des <gui>textes bibliques</gui>. Dans le menu contextuel qui s'affiche, choisir <guiseq><gui>Éditer</gui><gui>Rechercher</gui></guiseq>. Une fenêtre s'ouvre ensuite, permettant la recherche d'un ou plusieurs mots. Saisir le texte à rechercher, puis ensuite valider à l'aide de <gui>Rechercher</gui> et <gui>Rechercher suivant</gui>.</p>
	</item>
      </list>
    </section>
  </section>

  <section id="xiphos-viewer">
    <!-- ============= Previewer	================ -->

    <title>Aperçu</title>
    <media style="image" mime="image/png" src="figures/interface_viewer.png"/>

    <p>Le volet Aperçu est l'emplacement où sont affichés les nombres de Strong, les étiquettes morphologiques et les références croisées présentées dans le volet des <gui>textes bibliques</gui>.</p>

    <p>Les notes de bas de page s'affichent dans le volet <gui>Aperçu</gui> quand un indicateur de type <gui>*n</gui> est survolé par la souris dans un texte biblique; Elles restent visibles jusqu'à ce que le curseur de la souris survole un autre indicateur. Cependant, dans certains cas, il peut être souhaitable de figer le texte pour déplacer ensuite le curseur de la souris dans le volet <gui>Aperçu</gui> pour sélectionner un lien ou lire une longue note. Dans ce cas, un clic sur le de bouton du milieu à l'aide de la souris (ou un appui sur la touche <gui>Majuscule</gui>) fige l'affichage de la note de bas de page et permet de se déplacer ensuite dans le volet <gui>Aperçu</gui>.</p>

    <p>Les références croisées <gui>*x</gui> fonctionnent sensiblement de la même façon. Un clic à l'aide du bouton de la souris sur l'indicateur <gui>*x</gui> provoque l'affichage des références croisées dans la liste de <gui>Versets</gui> du <gui>volet latéral</gui>, où ensuite sélectionnés un par un, ils peuvent être lus dans le volet <gui>Aperçu</gui>. Alternativement, une option des Préférences permet que la liste des références croisées soit envoyée directement dans le volet <gui>Aperçu</gui>.</p>

    <p>N'importe quel verset surligné indique qu'une annotation personnelle est associée avec lui, ces versets incluent une marque <gui>*u</gui> au début. Si vous survolez cette marque, elle permet d'afficher l'annotation dans le volet Aperçu, de la même façon que pour les notes de bas de page.</p>

    <p>Si un calendrier biblique a été défini dans les Préférences, alors la méditation biblique du jour sera affichée dans le volet Aperçu, soit au démarrage du programme ou soit lorsque l'utilisateur le demande via le menu <gui>Affichage</gui>.</p>
  </section>

  <section id="xiphos-commentaries">
    <!-- ============= Commentary Pane  ============-->

    <title>Le volet des commentaires</title>
    <media style="image" mime="image/png" src="figures/interface_commentarypane.png"/>

    <p>Le volet <gui>Commentaire</gui> permet l'affichage des modules de commentaires. Il permet la consultation, le référencement, l'accès aux différents commentaires installés. Le passage affiché dans le <gui>Commentaire</gui> est directement lié au passage actuellement vu dans le volet des <gui>textes bibliques</gui>, ainsi pour consulter le commentaire realtif à un autre passage, il suffit de changer de verset à l'aide de la <gui>Barre d'outils</gui>.</p>

    <p>Si une image fait partie d'un commentaire, d'un livre ou d'un dictionnaire, elle peut être affichée agrandie dans sa propre fenêtre simplement en la sélectionnant par un clic. Cette fonctionnalité est particulièrement intéressante si l'option de réduction des images a été activée, ce qui a pour résultat de donner des images très rétrécies dans les petites fenêtres.</p>
    <note>
      <p>En changeant la référence du passage à l'aide de la <gui>Barre d'outils</gui>, le contenu des volets <gui>Texte biblique</gui> et <gui>Commentaire</gui> changent simultanément.</p>
    </note>

    <section id="xiphos-commentary-about">
      <title>Rechercher les informations à propos du module de commentaires</title>
      <p>À propos du commentaire actuellement affiché :</p>
      <list>
	<item>
	  <p>Cliquer du bouton droit de la souris dans le volet <gui>Commentaire</gui>. Dans le menu contextuel qui se présente, sélectionner <gui>À propos de</gui>.</p>
	</item>
      </list>
    </section>

    <section id="xiphos-commentary-headings">
      <title>Entêtes des commentaires</title>
      <p>De nombreux commentaires intégrent des entêtes additionnels avec une note d'introduction sur le livre ou le chapitre en cours dans le volet <gui>Texte biblique</gui>. Pour obtenir l'affichage de cet entête :</p>
      <list>
	<item>
	  <p>Cliquer du bouton droit de la souris dans le volet <gui>Commentaire</gui>. Dans le menu contextuel qui se présente, choisir <gui>Afficher l'entête du livre</gui> ou <gui>Afficher l'entête du chapitre</gui>.</p>
	</item>
      </list>
    </section>
  </section>

  <section id="xiphos-dictionary">
    <title>Volet dictionnaire</title>
    <media style="image" mime="image/png" src="figures/interface_dictionary.png"/>

    <p>Le volet <gui>Dictionnaire</gui> est piloté à l'aide des flèches haut/bas, en saisissant un mot dans la zone de saisie ou en double-cliquant sur des mots dans les volets <gui>Textes bibliques</gui>, <gui>Commentaires</gui>, <gui>Livre</gui>.</p>
  </section>

</page>
