# Manuel de &appname; :

&appname; est un logiciel d'aide à l'étude biblique.

2003
2010
L'équipe de développement Xiphos
L'équipe de développement Xiphos

## Votre avis

Pour obtenir plus d'informations sur &appname;, visitez le site web du projet à http://xiphos.org.

Les rapports de bogue ou les suggestions à propos de Xiphos ou de ce manuel d'aide sont à envoyer au Tracker de SourceForge ou à la liste de diffusion gnomesword-developers@lists.sourceforge.net

L'autorisation de copier, distribuer et/ou modifier le présent document est soumise aux conditions de la licence relative à la documentation gratuite GNU (GPL), version 2 ou toute version publiée ultérieurement par la Free Software Foundation. Vous pouvez trouver une copie de cette licence à l'adresse suivante : lien ou dans le fichier COPYING distribué avec le présent manuel.

LA DISTRIBUTION DU PRÉSENT DOCUMENT ET DES VERSIONS MODIFIÉES DE CELUI-CI EST RÉGIE PAR LA LICENCE RELATIVE À LA DOCUMENTATION GRATUITE GNU, CE QUI IMPLIQUE QUE :

1. CE DOCUMENT EST FOURNI "TEL QUEL", SANS AUCUNE GARANTIE, EXPLICITE OU IMPLICITE, Y COMPRIS, SANS LIMITATION, TOUTE GARANTIE ASSURANT QUE LE DOCUMENT OU LA VERSION MODIFIÉE DE CELUI-CI EST EXEMPT DE DÉFAUTS, COMMERCIALISABLE, ADAPTÉ À UN USAGE DONNÉ ET N'EST CONTRAIRE À AUCUNE LÉGISLATION. VOUS ASSUMEZ L'ENSEMBLE DES RISQUES ASSOCIÉS À LA QUALITÉ, A L'EXACTITUDE ET A LA PERFORMANCE DU PRÉSENT DOCUMENT OU D'UNE VERSION MODIFIÉE DE CELUI-CI. SI LE DOCUMENT OU UNE VERSION MODIFIÉE DE CELUI-CI DEVAIT S'AVÉRER DÉFECTUEUX A QUELQUE ÉGARD, VOUS (ET NON LE RÉDACTEUR INITIAL, L'AUTEUR OU TOUT AUTRE CONTRIBUTEUR) ASSUMEZ LES COÛTS DE TOUTE MAINTENANCE, RÉPARATION OU CORRECTION NÉCESSAIRE. LA PRÉSENTE CLAUSE DE NON-RESPONSABILITÉ EN MATIÈRE DE GARANTIE CONSTITUE UNE PARTIE ESSENTIELLE DE LA PRÉSENTE LICENCE. AUCUNE UTILISATION DU PRÉSENT DOCUMENT OU D'UNE VERSION MODIFIÉE DE CELUI-CI N'EST AUTORISÉE AU TITRE DE LA PRÉSENTE LICENCE SANS APPLICATION DE LA CLAUSE DE NON-RESPONSABILITÉ.

2. PAR AILLEURS, EN AUCUN CAS ET AU TITRE D'AUCUNE THÉORIE JURIDIQUE, QUE CE SOIT EN VERTU D'UN PRÉJUDICE (EN CE COMPRISE LA NÉGLIGENCE), D'UN CONTRAT OU D'UNE QUELCONQUE AUTRE RAISON, L'AUTEUR, LE RÉDACTEUR INITIAL, TOUT AUTRE CONTRIBUTEUR OU DISTRIBUTEUR DU PRÉSENT DOCUMENT OU D'UNE VERSION MODIFIÉE DE CELUI-CI, OU TOUT FOURNISSEUR D'UNE TELLE PARTIE, NE POURRA ÊTRE TENU POUR RESPONSABLE PAR UN TIERS DE TOUT DOMMAGE DIRECT, INDIRECT, SPÉCIAL, ACCIDENTEL OU CONSÉCUTIF QUEL QU'EN SOIT LE CARACTÈRE, Y COMPRIS, SANS LIMITATION, LES DOMMAGES CAUSÉS PAR UNE PERTE DE CLIENTÈLE, D'ARRÊT DE TRAVAIL, DE PANNE OU DE DYSFONCTIONNEMENT INFORMATIQUE OU POUR TOUT AUTRE DOMMAGE OU PERTE DÉCOULANT DE OU ASSOCIÉ À L'UTILISATION DU PRÉSENT DOCUMENT OU DE VERSIONS MODIFIÉES DE CELUI-CI, ET CE, MÊME SI LADITE PARTIE A ÉTÉ INFORMÉE DE LA POSSIBILITÉ DE TELS DOMMAGES.

Andy
Piper
Pierre
Benz
Dr Peter
von Kaehne
Karl
Kleinpaste
Matthew
Talbert
Dominique
Corbex
L'équipe de développement Xiphos
Traduction française
This manual describes version 3.1.5 of Xiphos.
Xiphos Manual V3.1.5
February 2012

L'équipe de développement Xiphos

L'équipe de développement Xiphos

gnome
xiphos
sword
crosswire
Fenêtre d'aide

## Introduction

&appname; est un logiciel d'étude biblique basé sur le Projet SWORD et les bibliothèques GTK. &appname; permet d'effectuer les tâches suivantes :

- Rechercher un verset particulier de l'Écriture

- Créer des études ou des notes personnelles sur une sélection de passages

- Suivre automatiquement les renvois des notes de bas de pages et des références croisées

- Comparer des traductions différentes en parallèle

- Étudier dans les langues originelles, grec ou hébreu

&appname; a pour but de fournir, à l'aide d'une interface utilisateur simple, épurée, un outil riche, permettant de disposer d'un environnement personnalisé dédié à l'étude biblique.

### Le logo du Projet SWORD

Le logo du Projet SWORD

Le Projet SWORD est hébergé à http://www.crosswire.org. D'autres applications sont disponibles sous ce même emblême : MacSword pour Macintosh, BibleDesktop, une application Java, BibleTime (un autre programme Linux), et The SWORD Project for Windows (BibleCS ou WinSword).

### &appname; en action

&appname; en action

&appname; est en cours de développement, il se peut donc que des différences apparaissent entre le logiciel et le contenu de ce manuel. Si cela est le cas, envoyez un rapport de bogue au site web du projet, ou un email à xiphos-developers@lists.sourceforge.net Toute aide est appréciée et permet d'améliorer &appname;.

## Premiers pas

### Démarrer Xiphos

Vous pouvez démarrer Xiphos en utilisant l'une des méthodes suivantes :

Menu applications

  Sélectionnez Éducation Guide de la Bible Xiphos.

Ligne de commande

  Entrez `xiphos`, puis appuyez sur Entrée.

Windows

  Sélectionnez Tous les programmes Xiphos·Xiphos.

### Démarrer Xiphos la première fois

Au démarrage de &appname; la première fois, Xiphos crée une configuration par défaut des options d'affichage. De plus, si aucune autre application Sword n'a jamais été utilisée auparavant, et donc aucun module Sword n'a pu être installé, Xiphos démarre le gestionnaire de modules afin de permettre de choisir et installer un module de textes bibliques dans la langue souhaitée.

#### Demande de permission de téléchargement par &appname;

figures/first-start.png

&appname; s'ouvre ensuite sur le texte de Romains 8:28 dans un premier onglet. Une fois la fenêtre affichée, il est possible de modifier les options de &appname; en sélectionnant Éditer Préférences.

### Démarrer Xiphos

Au démarrage de Xiphos, la fenêtre suivante est affichée :

#### Interface de Xiphos

L'interface de Xiphos

La fenêtre de Xiphos contient les éléments suivants :

Barre de menu

  La Barre de menu permet d'accéder aux fonctions complémentaires de &appname;, comme le bloc-notes où la recherche avancée. Elle permet également d'ajuster les préférences de &appname;.

Barre d'outils

  La Barre d'outils contient des boutons permettant de naviguer rapidement dans le texte biblique.

Volet latéral

  Le Volet latéral présente plusieurs fonctions. Il contient la liste des modules installés, les signets définis par l'utilisateur et il permet d'exécuter des recherches simples.

Textes bibliques

  Le volet des Textes bibliques affiche le texte biblique sélectionné.

Aperçu

  Le volet Aperçu affiche les textes complémentaires des modules de textes bibliques. Ces textes comprennent les nombres de Strong, les notes de bas de page et les étiquettes morphologiques. Il est situé en-dessous du volet des textes bibliques.

Commentaire

  Le volet Commentaire affiche le commentaire relatif au verset sélectionné.

Livre

  Le volet Livre affiche le texte de livres disponibles auprès du Projet SWORD. Ces modules comprennent des textes comme "Calvin's Institutes", "Josephus: The Complete Works" etc. Ce volet est accessible via l'onglet Livre, en dessous du volet Commentaire.

Dictionnaire

  Le volet Dictionnaire situé en-dessous du volet Commentaire affiche la définition des mots sélectionnés dans le volet des Textes bibliques.

Un clic du bouton droit de la souris dans les différents volets de l'interface de &appname; fait apparaître un menu contextuel, il permet d'accéder aux options spécifiques du module concerné, comprenant les options d'affichage et les services d'impression.

## Interface

### Barre de menu

La Barre de menu se situe en haut de la fenêtre de l'application &appname;. Pratiquement toutes les fonctions sont disponibles en utilisant les éléments de menu appropriés. Les différentes fonctions sont regroupées par type. Par exemple, les opérations sur les fichiers sont regroupées dans le menu Fichier.

#### Barre de menu

Barre d'outil de Xiphos

### Barres d'outils

La fonction de la Barre d'outils est de commander le volet des Textes bibliques. et des Commentaires. 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.

#### Barre d'outil

La barre d'outils

La Barre d'outils présente les fonctions suivantes :

- Boutons de déplacement dans l'historique des versets consultés

- Sélecteur de livre de la Bible

- Sélecteur de chapitre de la Bible

- Sélecteur de verset de la Bible

- Zone de saisie d'une référence biblique

#### Boutons de déplacement avant/arrière dans l'historique.

Permettent de se déplacer dans l'historique des passages consultés.

#### Sélecteur de livre de la Bible

Permet de sélectionner un livre de la Bible. Le premier verset du livre est affiché immédiatement dans le volet des textes bibliques et le volet des commentaires.

#### Sélecteur de chapitre de la Bible

Permet de sélectionner un chapitre du livre de la Bible actuellement affichée. Le premier verset du chapitre est affiché immédiatement dans le volet des textes bibliques et le volet des commentaires.

#### Sélecteur de verset de la Bible

Permet de sélectionner rapidement un verset du chapitre en cours de la Bible. Le verset est affiché immédiatement.dans le volet des textes bibliques et le volet des commentaires.

#### Zone de saisie d'une référence biblique

Permet la saisie manuelle d'un passage sous la forme livre chapitre:verset {ex: Jn 3:16}.Le verset est affiché après appui sur la touche Entrée.

Les valeurs de livre, chapitre et verset doivent être correctes, sinon le le résultat obtenu risque d'être différent de celui désiré.

### La barre d'outils

#### Volet latéral

La barre d'outils

Le volet latéral est situé sur la partie gauche de la fenêtre principale de &appname;. Le volet latéral permet de choisir les modules Sword, de gérer et utiliser les signets,d' effectuer des recherches basiques ou d'afficher les listes de versets. Les boutons du volet latéral permettent d'activer ces différentes fonctions.

#### Raccourcis du volet latéral

Raccourcis du volet latéral

### Le volet des textes bibliques

#### Le volet des textes bibliques

Le volet des textes bibliques

À droite du volet latéral, se trouve le volet des textes bibliques. Les différentes versions de la Bible sont affichées dans cette zone. Au démarrage de &appname;, la version utilisée précédemment dans l'onglet le plus à gauche est affichée.

#### Ouvrir une version différente de la Bible

Pour remplacer la version de la Bible en cours d'utilisation par une autre version :

- Faire un clic du bouton droit de la souris dans le volet d'affichage des textes bibliques. Dans le menu qui se présente, choisir Fichier Ouvrir le module et sélectionner la version désirée.

- Ou après avoir activé l'option Modules du volet latéral, choisir Textes bibliques langue de votre choix et sélectionner la version désirée.

#### Utilisation du mode Vue parallèle

Une fonction intéressante de &appname; est la possibilité d'afficher en parallèle plusieurs versions de la Bible. Le mode Vue parallèle est activé en sélectionnant l'onglet Vue parallèle situé juste en-dessous du volet des textes bibliques, à côté de l'onglet Vue simple.

La sélection des modules à afficher dans la vue parallèle se fait dans la boîte de dialogue des Préférences, à ouvrir depuis le menu Édition. 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 affichés dans la vue parallèle. La barre d'outils est munie d'un outil de sélection pour effacer la liste, supprimer un module de la liste, et ajouter des modules à la liste.

Le mode Vue parallèle affiche un seul verset à la fois. Il est possible de changer de verset en utilisant les sélecteurs de la barre d'outils. Notons é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 ne contiennent pas.

##### Volet des textes bibliques, vue parallèle

Volet des textes bibliques, vue parallèle

En outre, une vue parallèle peut être ouverte dans une fenêtre distincte par appel du menu contextuel au moyen d'un clic droit de la souris sur la vue parallèle, puis par sélection de Détacher/Attacher. Le volet des textes bibliques revient alors à la vue simple et une nouvelle fenêtre Vue parallèle s'ouvre affichant le chapitre entier dans les mêmes versions.

##### Vue parallèle - Fenêtre distincte

Vue parallèle - Fenêtre distincte

#### Ouvrir le texte·biblique dans une fenêtre distincte

Pour ouvrir le texte biblique dans une fenêtre distincte de la fenêtre principale de &appname; :

- Dans l'option Modules du volet latéral, choisir Textes bibliques langue de votre choix. Faire un clic droit sur la version souhaitée, puis dans le menu contextuel qui s'affiche, choisir l'option Ouvrir dans une fenêtre.

#### Rechercher les informations à propos de la version courante.

Pour obtenir des informations à propos de la version de la Bible en cours :

- Faire un clic droit à l'aide de la souris dans le volet des textes bibliques. Dans le menu contextuel qui s'affiche, sélectionner À propos.

- Dans l'option Modules du volet latéral, choisir Textes bibliques langue de votre choix. Faire un clic droit sur la version souhaitée, puis dans le menu contextuel qui s'affiche, choisir l'option À propos.

#### Options des modules

De nombreux modules de textes bibliques proposent des options additionnelles à activer suivant les besoins de l'utilisateur :

- Paroles de Christ en rouge

- Nombres de Strong

- Étiquettes morphologiques

- Notes de bas de page

- Références croisées de l'Écriture

- Entêtes

- Afficher les images

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.

pour accéder à ces options :

- Faire un clic du bouton droit à l'aide de la souris dans le volet des textes bibliques. Dans le menu contextuel qui s'affiche, choisir Options du module, puis l'option désirée.

##### Options des modules

Options des modules

#### Options d'affichage

Plusieurs modes supplémentaires peuvent être sélectionnés à l'aide du menu Afficher de la barre de menu.

##### Options d'affichage

Options d'affichage

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 Textes bibliques, Commentaires et Aperçu.

Les options restantes commandent les autres options d'affichage.

- Onglets liés - Par défaut, quand plus d'un onglet est ouvert, chacun permet de naviguer séparément dans les textes bibliques. Quand cette option est activée, tous les onglets sont liés ensemble, et affichent le même verset.

- Synthèse vocale - Quand cette option est activée, &appname; lit à voix haute les versets sélectionnés à l'aide du logiciel de synthèse vocale Festival. Le moteur de synthèse vocale Festival 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 ).

  De même, la synthèse vocale peut être utilisée sur des portions de textes bibliques, commentaires ou livres. Une fois le texte désiré mis en surbrillance, sélectionner Synthèse vocale du texte sélectionné dans le menu contextuel obtenu à l'aide du clic droit de la souris.

- Affiche les numéros de versets - Normalement activée, cette option peut être désactivée pour ne pas afficher les numéros de versets dans le texte.

- Verset en cours contrasté - 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.

#### Annotation personnelle

De nombreux utilisateurs souhaitent ajouter des annotations personnelles à des versets particuliers, sans éprouver pour autant le besoin d'employer un module complet de commentaires personnels. Xiphos offre cette fonctionnalité dans le menu contextuel du volet biblique obtenu par un clic-droit. Une boite de dialogue s'affiche indiquant 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 Annoter, le verset est surligné (par défaut bleu sur jaune) et une marque *u 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.

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.

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.

#### Support de la géographie

Une connection pour naviguer sur le site BibleMap.org est fournie lors de la sélection d'un lieu par la souris dans n'importe quel texte. Sélectionner Définition du mot sélectionné Recherche sur BibleMap.org par un clic-droit dans le menu contextuel. Un navigateur web est alors lancé pour montrer la géographie du nom sélectionné via BibleMap qui affiche le détail biblique superposé sur une interface Google Maps.

#### Définition d'un mot particulier

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 dans le volet dictionnaire.

#### Rechercher un mot spécifique

Pour rechercher un mot spécifique dans un passage :

- Faire un clic droit à l'aide de la souris dans le volet des textes bibliques. Dans le menu contextuel qui s'affiche, choisir Éditer Rechercher. Une fenêtre s'ouvre ensuite, permettant la recherche d'un ou plusieurs mots. Saisir le texte à rechercher, puis ensuite valider à l'aide de Rechercher et Rechercher suivant.

### Aperçu

#### Aperçu

Aperçu

Le volet Aperçu est l'endroit 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 textes bibliques.

Les notes de bas de page s'affichent dans le volet Aperçu quand un indicateur de type *n 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 Aperçu 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 Majuscule) fige l'affichage de la note de bas de page et permet de se déplacer ensuite dans le volet Aperçu.

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

N'importe quel verset surligné indique une annotation personnelle associée avec lui, ces versets incluent une marque *u au début. Survoler cette marque permet d'afficher l'annotation dans le volet Aperçu, de la même façon que les notes de bas de page.

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

### Le volet des commentaires

#### Le volet des commentaires

Commentaire

Le volet d'affichage des commentaires permet la consultation des commentaires relatifs au verset en cours ou de se référer à d'autres commentaires existants. Le commentaire est directement lié au passage affiché dans le volet d'affichage des textes bibliques, ainsi pour consulter le commentaire d'un autre passage, il suffit de changer de verset à l'aide de la Barre d'outils.

Si une image fait partie d'un commentaire, d'un livre ou d'un dictionnaire, elle peut être affichée agrandie dans une nouvelle fenêtre en la sélectionnant par un simple clic. Cette fonctionnalité est particulièrement intéressante si l'option de réduction des images a été activée avec pour résultat des images très rétrécies.

En changeant la référence du passage à l'aide de la Barre d'outils, le contenu du volet d'affichage des textes bibliques et du volet d'affichage des commentaires changent simultanément.

#### Rechercher les informations à propos du module de commentaires

À propos du commentaire actuellement affiché :

- Faire un clic du bouton droit à l'aide de la souris dans le volet d'affichage des commentaires. Dans le menu contextuel qui se présente, sélectionner À propos de.

#### Entêtes des commentaires

De nombreux commentaires incorporent des entêtes avec une note d'introduction sur le livre ou le chapitre en cours d'utilisation dans le volet des textes bibliques. Pour obtenir l'affichage de l'entête :

- Faire un clic du bouton droit à l'aide de la souris dans le volet d'affichage des commentaires. Dans le menu contextuel qui se présente, choisir Afficher l'entête du livre ou Afficher l'entête du chapitre.

### Volet dictionnaire

#### Le volet du dictionnaire

Le volet du dictionnaire

Le volet Dictionnaire 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 Textes bibliques, Commentaires, Livre.

### Raccourcis clavier

Xiphos présente un certain nombre de raccourcis clavier, listés ci-dessous par groupes fonctionnels :

Sélection/ouverture des fenêtres et barre de navigation

- Ctrl-L sélectionne la zone de saisie de référence biblique. Il est ainsi possible de saisir directement une nouvelle référence de verset. Il est à noter que &appname;, comme d'autres applications Sword, accepte de nombreuses abréviations. « G » correspond à Genèse par exemple, et n'importe quel nom de livre saisi seul implique chapitre 1, verset 1.

- Alt-C ramène au premier-plan le volet Commentaire si celui-ci est masqué par le volet Livre.

- Alt-G ramène au premier-plan le volet Livre.

- Alt-D place le focus sur la barre de navigation du volet Dictionnaire.

- Ctrl-t ouvre un nouvel onglet.

Changement de verset et propriétés du texte biblique :

- Ctrl-p/Ctrl-n : Verset précédent/suivant. k/j est équivalent.

- p/n : Chapitre précédent/suivant.

- P/N:·Livre biblique suivant/précédent.

- Maj-F10 appelle le menu contextuel du volet des textes bibliques.

Ouverture de fenêtres spéciales :

- F1 ouvre ce manuel.

- F2: ouvre la fenêtre des Préférences·

- F3 : ouvre la Recherche avancée

- F4 : ouvre le Gestionnaire de modules.

- Alt-B ouvre la fenêtre Ajouter un signet sur le verset en cours

- Ctrl-F ouvre la fenêtre Rechercher .... Le volet sur lequel la recherche est exécutée dépend de leur visibilité : si tous les volets sont affichés, le volet biblique a la préférence, sinon vient ensuite le volet des commentaires puis le livre et enfin le dictionnaire. Ainsi un onglet peut être dédié à n'afficher que le volet livre et la recherche initiée par Ctrl-F ne sera effectuée que dans ce volet livre.

- Alt-P détache / rattache la fenêtre de vue parallèle.

- Alt-Z ouvre l'éditeur de commentaires personnels, nommé Personal (Modules commentaires English Personal).

Règlage des tailles de police :

- Ctrl-Plus/Ctrl-Minus augmente / diminue la taille de police

### Différences d'affichage dans &appname; :

The Xiphos interface has evolved over time, and there are two display libraries with which Xiphos can be built. The older, less featureful version is called "gtkhtml3", and the newer, more capable version is called "webkit". Both of these display libraries render text in a browser-like fashion, using HTML constructs to control display.

Several desirable capabilities are unsupportable in gtkhtml3, and although recent Xiphos is written to take advantage of webkit features, it is possible that the version running on your computer needed to be built with gtkhtml3 instead, either because the version of webkit available for your system is not recent enough to support the needs of Xiphos, or it simply doesn't exist for your system. The following differences will be apparent, depending on whether gtkhtml3 or webkit is the underlying display engine:

- Morphology and Strong's references, enabled via the right-click menu in some modules, are displayed inline with gtkhtml3; with webkit, a blocked display is used, where these references are aligned beneath the word to which they refer, for a much more readable, less cluttered display.

- Footnote and cross-reference markers (*n, *x) are displayed as proper superscripts in webkit, but not in gtkhtml3.

- Links in gtkhtml3 are necessarily both colored and underlined; in webkit, no underlines are needed.

- Under webkit, double-space display is available using the context menu, but not under gtkhtml3.

- Gtkhtml3 ne sait pas interpréter les directives de polices multiples dans une même fenêtre, c'est pourquoi la fenêtre détachée « Vue parallèle » ne permet pas une sélection de police par module.

En utilisant le menu Aide À propos de Xiphos, il est possible de connaître la bibliothèque avec laquelle &appname; a été construit.

#### Comparison, gtkhtml3 -vs- webkit

Comparison, gtkhtml3 -vs- webkit

## Préférences

### Introduction aux préférences

#### La fenêtre des préférences

La fenêtre des préférences

### Polices et couleurs

#### Configurer la couleur des polices

##### Configuration de la couleur des polices

Configuration de la couleur des polices

Le bouton Inverser les paires de couleurs permet, par exemple, de mettre la fenêtre principale en « mode nuit », avec un texte en blanc sur un fond noir.

#### Configuration diverses des polices

##### Configuration diverses des polices

Configuration diverses des polices

Faire un clic droit à l'aide du bouton de la souris dans un des modules affichés. Dans le menu contextuel qui s'affiche, choisir ensuite Options du module Changer de police pour changer la police ou la taille des caractères.

La taille de police standard est la taille par défaut de tous les modules affichés par &appname;. Note: la taille des n° de verset ainsi que la taille de la police sélectionnée individuellement par module sont relatives à cette taille standard.

Le nom et la taille de police utilisés pour l'affichage sont choisis dans cet ordre :

- La sélection faite via le menu contextuel d'un module spécifique, à l'aide de Options du module.

- Les préférences de police, par langue, ici dans les préférences.

- La configuration par défaut du module, définie dans son fichier de configuration.

- La configuration par défaut de l'application.

### Préférences générales

#### Langue, préférences générales et répertoire du bloc-notes.

##### Langue, préférences générales et répertoire du bloc-notes.

Préférences générales et répertoire du bloc-notes.

Pour afficher l'interface de &appname; dans un autre langage, définir cette autre langue ici. Un redémarrage sera néanmoins nécessaire, de sorte que la traduction puisse être initialisée.

Si un Dictionaire par défaut est activé, ce dictionnaire (voir Spécial ci-dessous) sera toujours utilisé lorsqu'un double-click sera exécuté sur n'importe quel mot dans &appname; .

Les Calendriers bibliques sont des modules dictionnaires spécifiques dont les entrées sont de la forme numérique "Mois:Jour" (ex : 12:25). Si un module de ce type a été installé puis déclaré comme Calendrier biblique dans les préférences diverses des modules, &appname; peut présenter le texte du jour lors du démarrage.

Si l'option Réduction des images est activée, &appname; retaille automatiquement les images des commentaires, dictionnaires, livres de façon à ce qu'elles s'adaptent à la taille de la fenêtre où elles sont affichées.

L'option Verset en cours contrasté, une fois activée, permet de remplacer la couleur du verset en cours par une coloration au contraste plus élevée. Les couleurs sont modifiables dans le volet Couleurs (voir au-dessus).

Annotations personnelles surlignées utilise les choix de couleurs du surlignement pour indiquer les versets annotés par l'utilisateur.

Par défaut, les Références croisées sont affichées dans le volet Aperçu. Cocher cette option les fait apparaître dans la liste de versets.

### Configuration des modules

#### Préférences des vues parallèles

Préférences des vues parallèles

#### Préférences diverses des modules

Préférences diverses des modules

## Gérer les modules

### Introduction à la gestion des modules

Le « module » est une unité de contenu dans &appname; et plus généralement dans toute application basée sur Sword ; Un module de Sword est une ressource destinée à être vue dans une application Sword. Les modules sont de plusieurs types : les plus importants, les textes bibliques, puis aussi les dictionnaires et lexiques, les commentaires, les livres, ceux-ci pouvant offrir un contenu graphique (Atlas). Ils sont installés depuis un dépot local (généralement sur média amovible, comme une distribution par CDROM) ou par téléchargement ftp depuis un dépot distant comme celui de Crosswire, hébergeur de Sword, où tous les modules certiifiés par Crosswire sont disponibles. Des modules sont également disponibles auprès d'autres sources. En Particulier, le dépot de Xiphos contient un certains nombre de modules non-officiels produits par les contributeurs à &appname;.

Si d'autres applications basées sur Sword sont installées, elles ont accès aux modules installés par le gestionnaire de modules.

#### La fenêtre de gestion des modules

La fenêtre de gestion des modules

Noter le bouton Voir l'intro ci-dessus. Il affiche une explication introductive au fonctionnement du Gestionnaire de module.

### Configuration des modules de Sword

#### Configurer les dépots de modules

##### Configurer les dépots de modules

Installation de module

Il y a d'autres dépots disponibles en plus de ceux de Crosswire, bien que les modules offerts par ces autres dépots ne présentent pas un contenu officiellement certifié par Crosswire. Sur le web, cette page recense les dépots connus : http://www.crosswire.org/wiki/Module_Repositories.

La liste des dépots standard est maintenue par Crosswire. Xiphos s'auto-synchronise normalement une fois avec cette liste, lorsque l'utilisateur se sert de la première fois du gestionnaire de modules. La liste peut changer, au fur et à mesure que de nouveaux dépots viennent à existence; une resynchronisation occasionnelle avec cette liste est suggérée, ce qui est réalisé en cliquant sur Charger standard.

#### Destination des modules Sword

##### Destination des modules Sword

Installation de module

Après avoir choisi un dépot, sélectionner le bouton Rafraîchir, ce qui conduit &appname; à répertorier les modules disponibles au niveau du dépot.

Note au sujet du « Répertoire d'installation » : dans la plupart des cas, il est proposé le choix entre un espace personnel et un espace système. Ceci est dépendant du système d'exploitation.

##### Linux

À moins d'avoir les privilèges du superutilisateur (via su ou sudo), l'installation n'est possible que dans l'espace personnel, sous le répertoire ~/.sword. En étant superutilisateur, ou en modifiant les permissions de l'espace système (généralement : /usr/share/sword), il est possible d'installer des modules accessibles par tous les utilisateurs. Il a été fait un certain nombre de demandes pour que soit incorporé à &appname; un moyen permettant à un utilisateur ordinaire (non-root) d'obtenir temporairement les droits d'accès à l'espace système pendant l'installation des modules, puis d'annuler ces droits une fois l'installation terminée. Étant donné les différentes gestions des droits du super-utilisateur employées dans l'éventail des distributions Linux, il est plutôt difficile d'établir un moyen de satisfaire cette demande. En ce moment, il n'y a aucun projet en cours essayant de résoudre ce problème, il est donc conseillé aux utilisateurs de gérer les droits d'accès en écriture à l'emplacement système en dehors de &appname;.

##### Windows XP

Les modules peuvent être installés dans un dossier partagé de façon à permettre l'accès à ces modules par tous les utilisateurs. Si le logiciel « The·Sword Project for Windows » a été utilisé précédemment, ce répertoire est « C:\Program Files\Crosswire\The Sword Project\Sword », sinon c'est « C:\Documents and Settings\All Users\Application Data\Sword ». Les modules peuvent être également installés dans un compte d'utilisateur spécifique et seront accessibles à lui seul, ce dossier est « C:\Documents and Settings\{Nom du compte d'utilisateur}\Application Data\Sword »

##### Windows Vista

Windows Vista fonctionne sensiblement de la même façon que Windows XP, les dossiers sont cependant différents. L'espace du compte utilisateur se trouve dans « C:\Utilisateurs\{Nom du compte utilisateur}\AppData\Roaming\Sword » et l'espace partagé dans « C:\ProgramData\Sword ».(Ce répertoire fait partie des répertoires cachés).

### Installer, mettre à jour et maintenir les modules

#### Installer, mettre à jour et maintenir les modules

##### Installation et mise à jour de modules

Installation de module

Le gestionnaire de modules génére à la fois une liste de modules classés par type et une liste de modules ordonnés par disponibilité. Cette dernière est destinée à rendre plus rapide la recherche de nouveaux éléments sans avoir à balayer la liste des modules classés par type. Les modules non encore installés ou pour lesquels existe une mise à jour apparaissent dans cette liste.

Une coche indique les modules déjà installés. Si un index de recherche optimisée ("Lucène") a été créé, un symbole représentant une loupe est affiché, sinon un « X » est présenté. La création d'un index de recherche optimisée se fait dans l'onglet Maintenance. Les modules verrouillés, nécessitant l'achat d'une clé de déverrouillage auprès du détenteur des droits d'un module sous copyright sont mentionnés par un symbole en forme de verrou. S'il existe une version plus récente des modules déjà installés, un symbole de rafraîchissement apparaît entre les deux références de version du module. La taille approximative du module est affichée à condition que le dépot de modules fournisse cette information, sinon un point d'interrogation (« ? ») est présenté..

Pour installer de nouveaux modules il suffit de sélectionner la case à cocher des modules à installer, puis de valider à l'aide du bouton Installer. Plusieurs modules peuvent être installés simultanément.

Suite à l'acquisition d'un module crypté et de la clé de déverrouillage associée, le module doit ensuite être déverrouillé. Il suffit simplement d'ouvrir le module dans la fenêtre principale, où il ne s'affiche probablement pas, puis dans le menu contextuel affiché à l'aide du clic droit de la souris, de sélectionner Déverrouiller ce module et de saisir la clé.

#### Maintenance des modules

##### Maintenance des modules

Maintenance des modules

Plusieurs opérations de maintenance sont possibles : Suppression, archivage, indexation et suppression d'index.

Supprimer un module est une opération définitive. Il est impossible de récupérer le module à moins que vous n'ayez une copie de celui-ci.

Tout module peut être archivé, bien que l'archivage soit principalement intéressant dans le cas des modules de commentaires personnels. Une copie du module au format compressé *.zip est placée dans le répertoire local ~/.sword/zip. Il est recommandé d'archiver les commentaires personnels avant de les supprimer de façon à pouvoir les réinstaller si besoin est.

L'indexation est une opération permettant au moteur de recherche de Sword de créer un index nécessaire aux recherches rapides de type « Lucène ». Si cet index n'existe pas, les opérations de recherche sont bien plus lentes. Avec un index en place, les requêtes à travers l'ensemble d'une Bible ne durent que quelques secondes.

Les index peuvent être supprimés.

### Installer des modules manuellement

Des modules au format du Projet SWORD sont disponibles auprès d'autres sources que Crosswire mais pas sous la forme d'un dépot à configurer avec le gestionnaire de modules. Il est donc nécessaire de les installer manuellement.

Ces modules sont ordinairement compressés au format zip. Ils contiennent un fichier de configuration ainsi qu'un certain nombre de fichiers de données. Installer un module présenté sous cette forme implique de se placer dans le répertoire de configuration Sword personnel. Ce répertoire se nomme ~/.sword, et se trouve dans votre répertoire personnel (ce n'est pas celui de &app;) puis de décompresser le fichier zip à cet endroit. Le fichier de configuration sera placé dans le répertoire « mods.d »,et les fichiers de données dans les sous-répertoires de « modules ». Si vous avez les droits en écriture du répertoire général de Sword usr/share/sword, vous pouvez aussi décompresser le fichier zip dans ce répertoire, ce module sera alors accessible à tous les utilisateurs.

Il est nécessaire de redémarrer &appname; après avoir installé un module non-standard de façon à ce que le logiciel détecte le nouveau module en place.

## Fonctions de recherche

### Recherche simple

Pour effectuer rapidement une recherche dans le module Bible ou commentaire en cours, la recherche rapide du volet latéral devrait être suffisante. Cette fonction est activée en sélectionnant le menu Éditer Rechercher ou le bouton Rechercher du volet latéral.

#### La barre de recherche rapide

La barre de recherche rapide

Le formulaire Rechercher est constitué des éléments suivants :

- Boite de saisie de l'expression à rechercher

- Sélecteur du module objet de la requête

- Sélecteur du type de requête

- Case à cocher des options de la requête

- Sélecteur de la plage de versets

- Affichage des résultats

#### Boite de saisie de l'expression à rechercher

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 Rechercher démarre la séquence de recherche.

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)

#### Sélecteur du module objet de la requête

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

#### Sélecteur du type de requête

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

Mots multiples

  Ce type recherche n'importe quel verset 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.

Expression rationnelle

  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 `\ A[a-z]*iah` permet de retrouver les passages qui contiennent les mots Aiah, Ahaziah, Athaliah et Amariah.

  Un exposé complet de l'emploi des expressions rationnelles dépasse le cadre de ce manuel, mais cependant plus d'informations à ce sujet peuvent être obtenues en parcourant le manuel de `grep`.

Phrase exacte

  La requête recherche la phrase exacte contenue dans l'expression à rechercher. Si la phrase à rechercher est `en vérité`, les passages obtenus contiendront « en vérité », mais pas « en toute vérité ».

#### Case à cocher des options de la requête

Permet de définir les options de recherche. L'option disponible est Respecter la casse. Cocher cette boite rend la recherche sensible à la casse des caractères.

#### Sélecteur de la plage de versets

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

Sans limites

  Sélectionner ce bouton implique que la requête s'exécute sur l'ensemble des versets.

Limites définies

  Sélectionner ce bouton provoque l'ouverture de deux zones supplémentaires permettant la saisie des limites de la recherche. La première référence, début de la recherche, est à saisir dans la limite Basse et la deuxième référence, fin de la recherche, dans la limite Haute. La requête commencera au verset indiqué dans la limite Basse et se terminera au verset indiqué dans la limite Haute en incluant tous les versets situés entre les deux limites.

  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.

Dernière requête

  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.

#### Affichage des résultats

La liste des résultats est affichée permettant d'obtenir un aperçu du verset retourné, la navigation vers le chapître concerné ou l'enregistrement sous forme de signets.

Aperçu

  Pour visualiser le résultat, un simple clic sur un élément affiche le contenu dans le volet Aperçu

Navigation

  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.

Enregistrer les résultats

  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 Convertir en signets, 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 nommé.

### Recherche avancée

Des recherches plus élaborées peuvent nécessiter l'utilisation des fonctions de recherche avancée, activées par l'utilisation du menu Éditer Recherche avancée.

#### La fenêtre de recherche avancée

La fenêtre de recherche avancée

La Recherche avancée permet de construire des requêtes 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.

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 Gestionnaire de modules pour la création d'index. En l'absence d'index, le repli se fait sur une recherche multi-mots, quelque peu lente et rustique, ou elle peut ê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 :

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 « + ». Ainsi la requête « +L'Eternel +mon +berger » trouve le Psaume 23. Pour rechercher une phrase entière, il suffit de l'entourer de guillemets, comme dans " Il me fait reposer dans de verts pâturages ".

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

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

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 « AND » 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 « ?saïe AND proph* ».

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.

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.

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 « lemma », par exemple pour rechercher le nombre de Strong grec 140, saisir « lemma:G140 ». Le bouton radio Optimisée Lucene doit être sélectionné pour que cette requête fonctionne.

Des explications sur la syntaxe de recherche sont disponibles quand soit Optimisée lucène ou Attributs sont sélectionnés.

Comme spécifié dans l'infobulle, le bouton Rechercher stoppe aussi une requête en cours d'exécution.

Les résultats sont affichés dans l'onglet Résultats. Pour inclure les nombres de Strong, les étiquettes morphologiques ou les notes de bas de page, sélectionner ces options dans l'onglet Attributs. Un simple clic sur un résultat affiche le contenu dans le volet Aperçu de la fenêtre Recherche Avancée. Un survol des nombres de Strong, étiquettes morphologiques ou notes de bas de page affiche le contenu dans le volet Aperçu 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 ces volets soient visibles.

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 volet latéral mais pas l'inverse.

### Syntaxe des expressions rationnelles utilisées en clé de recherche

La recherche au moyen d'expressions rationnelles permet d'effectuer des recherches simples ou complexes sur des chaînes de caractères qui correspondent à un motif ou un ensemble de motifs séparés par une barre verticale « | ». Alors qu'un motif peut être crée pour rechercher un mot ou une phrase, un motif simple composé d'un seul mot ne permettra pas de rechercher seulement ce mot, mais toute séquence de caractères contenant ce mot. Une recherche du mot « droit » ne retournera pas seulement la liste des versets contenant le mot « droit » mais aussi ceux contenant les mots « adroit », « droite ». La recherche de « ne pas » ne retournera pas les versets contenant les mots « ne » ET « pas » mais les versets contenant la séquence « ne pas » avec une espace entre les deux mots. Une recherche de « ne pas » trouvera aussi les versets contenant « ne passe ».

La puissance des expressions rationnelles provient des motifs utilisés pour définir une recherche. Un motif est constitué de caractères ordinaires et de quelques caractères spéciaux qui sont interprétés suivant des règles précises. Les caractères spéciaux sont \[^*$?+. Les autres caractères sont des caractères ordinaires. L'antislash « \ », est utilisé pour convertir les caractères spéciaux en caractères ordinaires et inversement les caractères ordinaires en caractères spéciaux.

Exemple : le motif « .amour\. » retournera les phrases qui se terminent par « son amour » ou « l'amour » ou « d'amour » suivi d'un point. Le premier point dans .amour\. est un caractère spécial dont la signification est de remplacer n'importe quel caractère à cette position. L'antislash dans .amour\. indique que le point suivant ne doit pas être considéré comme un caractère spécial, mais comme un point ordinaire.

#### Règles des requêtes de recherche à l'aide des expressions rationnelles

- « . » Le point remplace n'importe quel caractère.

- « * » L'astérisque correspond à toute répétition de caractères d'une chaîne ou d'une expression rationnelle la précédant, incluant zéro caractère.

- « + » Le signe plus correspond à une répétition ou plus de la précédente expression régulière. Il joue un rôle similaire à « * » (astérisque), mais ne correspond pas à zéro occurrence.

- « ? » Le point d'interrogation correspond à aucune ou une instance de la précédente expression rationnelle. Il est généralement utilisé pour correspondre à des caractères uniques.

- « [...] » Les crochets englobent un ensemble de caractères pour réaliser une correspondance dans une seule expression rationnelle.

- « ^ » La puissance comme premier caractère à l'intérieur d'accolades inverse la signification de l'ensemble des caractères de l'expression rationnelle.

- « ^ » La puissance en dehors d'accolades correspond au début d'une ligne.

- « $ » Le signe dollar à la fin d'une expression rationnelle correspond à la fin d'une ligne.

- « | » La barre verticale signifie OU logique

- « () » Les parenthèses servent à regrouper des expressions. Non supporté dans &appname;

- « \ » L'antislash échappe un caractère spécial, ce qui signifie que le caractère est interprété littéralement.

- « \ » L'antislash utilisé devant un caractère ordinaire, le transforme en caractère spécial..

##### Le point

Le point « . » remplace n'importe quel caractère y compris l'espace et d'autres caractères non alphabétiques. Par exemple : « 13. » correspond à 13 plus au moins un caractère (incluant une espace), ce qui retourne 1133, 11333 mais pas 13 (un caractère supplémentaire est manquant).

##### L'astérisque

L'astérisque « * » correspond à toute répétition de caractères d'une chaîne ou d'une expression rationnelle la précédant, incluant zéro caractère. Par exemple : « 1133* » correspond à 11 plus un ou plus de 3 ainsi que d'autres caractères : 113, 1133, 111312 et ainsi de suite.

##### Le signe plus

Le signe plus « + » correspond à une répétition ou plus de la précédente expression rationnelle. Il joue un rôle similaire à « * » (astérisque), mais ne correspond pas à zéro occurrence.

##### Le point d'interrogation.

Le point d'interrogation « ? » correspond à aucune ou à une instance au·plus·de la précédente expression rationnelle. Il est généralement utilisé pour correspondre à des caractères uniques.

##### Les crochets

Les crochets « [...] » englobent un ensemble de caractères pour réaliser une correspondance dans une seule expression rationnelle. « [xyz] » correspond aux caractères x, y ou z. « [c-n] » correspond à tout caractère compris entre c et n. « [B-Pk-y] » correspond à tout caractère compris entre B et P et entre k et y. « [a-z0-9] » correspond à toute lettre en minuscule et à tout chiffre. « [^b-d] » correspond à tous les caractères sauf ceux compris entre b et d. Ceci est un exemple de l'inversion de la signification de l'expression rationnelle suivante grâce à l'opérateur « ^ » (prenant le même rôle que « ! » dans un contexte différent). Les séquences combinées de caractères entre crochets correspondent à des modèles de mots communs. « [Oo][Uu][Ii] » correspond à oui, Oui, OUI, oUi et ainsi de suite.

##### La puissance en premier caractère entre des crochets

Si la puissance « ^ » est le premier caractère d'une expression entre crochets, il inverse la signification de l'ensemble des caractères de l'expression rationnelle.

##### La puissance correspond au début d'une ligne

La puissance « ^ » correspond au début d'une ligne. Toutes les réponses correspondront au début d'une ligne comportant la séquence recherchée. Cependant, comme certains modules de textes contiennent des caractères non filtrés en début de ligne, cette fonction ne retourne pas toujours les résultats escomptés. Ajouter quelques points après la puissance, permet de contourner le défaut de format de certains textes. « ^Au commencement » recherche les phrases commençant par « Au commencement ». (Mais il est préférable d'utiliser : « ^....Au commencement »).

##### Le signe dollar recherche en fin de ligne

Le signe dollar « $ » à la fin d'une expression régulière correspond à la fin d'une ligne. « XXX$ » correspond à XXX à la fin d'une ligne. « ^$ » correspond à des lignes blanches. Cependant, comme certains modules de textes contiennent des caractères non filtrés en fin de ligne, cette fonction ne retourne pas toujours les résultats escomptés. Ajouter quelques points après le dollar, permet de contourner ce défaut de format de certains textes. « Amen\.$ » retourne les phrases qui se terminent par « Amen. » (Il est préférable d'utiliser « Amen\....$ », «Amen\..........$ », ou même « Amen\....................$ »).

##### La barre verticale

La barre verticale « | » correspond à l'opérateur logique OU et permet donc de définir une alternative. « Jean | Pierre » retrouve les phrases contenant « Jean » ou « Pierre ». De même, « Jean.*Pierre | Pierre.*Jean » retourne « Jean ... Pierre » ou « Pierre ... Jean ». (* ralentit la recherche). « douleur | souffrance | tourment » retourne douleur ou souffrance ou tourment.

##### Les parenthèses

L'usage des parenthèses « () » n'est pas prévu.

##### L'antislash précédant un caractère spécial

L'antislash précédant un caractère spécial « \* » indique que ce caractère n'a plus de signification spéciale, mais devient un caractère ordinaire. amen\. retourne amen. mais pas ament et ne trouvera donc pas firmament.

##### L'antislash précédant un caractère ordinaire

L'antislash précédant un caractère ordinaire « \o » indique que ce caractère n'est plus utilisé comme tel mais prend une signification spéciale.

- \b ce symbole d'ancrage indique une limite de mot obligatoire, à l'endroit où il est inséré dans le motif. Par contre, s'il est utilisé entre crochets, il correspond au caractère « retour arrière ». \bjuste\b retourne juste mais pas injuste ou justesse.

- \B indique qu'il n'y a pas de limite de mot \Bleur\B trouve chaleureuse mais pas chaleur ou leurre.

- \d représente un chiffre, identique à [0-9].

- \D signifie non-numérique, identique à [^0-9].

- \s représente une espace.

- \S signifie pas d'espace.

- \w signifie alphanumérique, identique à [a-zA-Z0-9_].

- \W signifie non alphanumérique, identique à [^a-zA-Z0-9_].

## Bloc-notes

### Usage du bloc-notes :

Le Bloc-notes peut être ouvert en sélectionnant Fichier Ouvrir le bloc-notes

Présentation du bloc-notes :

#### Bloc-notes

Bloc-notes

Le bloc-notes enregistre les données dans votre répertoire de travail, ce qui est pratique pour échanger des informations avec d'autres applications.

Barre d'outils 1

- Taille de police

- Type de plice

- Gras, italique, souligné, barré

- Aligné à gauche, au centre et àdroite

- Décalage d'un paragraphe à droite ou à gauche

- Choix des couleurs

Barre d'outils 2

- Nouveau, enregistrer, supprimer et imprimer

- Couper, copier, coller et défaire

- Chercher et remplacer

- Vérification de l'orthographe

Pour que la vérification orthographique fonctionne, une des langues du menu Éditer Langues actuelles doit être sélectionnée.

## Commentaires personnels

Pour construire son propre commentaire personnel, il est nécessaire d'installer le module Sword « Personal », depuis la liste des modules Commentaires en anglais. Ensuite, pour ajouter ses commentaires, appeler le menu contextuel par un clic du bouton droit à l'aide de la souris sur le volet des commentaires, puis sélectionner Édition Modifier le commentaire.

Un éditeur semblable au bloc-notes va apparaître. Votre commentaire est à éditer puis à enregistrer. Il apparaîtra plus tard comme commentaire personnel au verset correspondant.

### L'éditeur de commentaires personnels

Commentaires personnels

Barre d'emplacement

- Bouton de synchronisation

- Sélecteurs de livres, chapitres et versets de la Bible

- Référence de l'emplacement

Le bouton Synchroniser permet de remplacer l'adresse du verset affiché par celle du verset en cours dans le volet des textes bibliques. Sinon, l'utilisation des sélecteurs de Livre, Chapitre, Verset permet d'éditer le commentaire d'un autre verset.

Barre d'outils 1

- Taille de police

- Type de plice

- Gras, italique, souligné, barré

- Aligné à gauche, au centre et àdroite

- Décalage d'un paragraphe à droite ou à gauche

- Choix des couleurs

Barre d'outils 2

- Enregistre, supprime et imprime

- Couper, copier, coller et défaire

- Chercher et remplacer

- Vérification de l'orthographe

Pour que la vérification orthographique fonctionne, une des langues du menu Éditer Langues actuelles doit être sélectionnée.

Pour créer un lien vers d'autres versets, faire un clic droit à l'aide de la souris sur la partie texte. Puis dans le menu contextuel qui s'affiche, choisir Lien, saisir ensuite l'adresse et le nom du module à lier.

Le nom du commentaire personnel peut être modifié de façon à l'accorder à une étude ou un sujet particulier. Il est ainsi possible de disposer de plusieurs commentaires personnels de la façon suivante : renommer premièrement le commentaire personnel en cours, puis ensuite ré-installer le module de commentaire personnel standard (Personal), et ainsi de suite. Note : les nouveaux noms de commentaires personnels ne peuvent contenir que des lettres et des chiffres, et ne doivent pas être identiques au nom d'un autre module existant. Un clic du bouton droit de la souris dans le volet Commentaire fait apparaître le menu contextuel permettant de renommer le commentaire personnel.

Si une étude faisant partie d'un commentaire personnel n'est plus utile, il est possible, avant de la supprimer, d'archiver le commentaire personnel à l'aide du gestionnaire de modules, ceci permettra éventuellement de le réinstaller plus tard. Utiliser pour cela le bouton Archiver du volet Gérer du gestionnaire de modules. Tout type de module peut être archivé, l'archivage n'est pas réservé aux commentaires personnels.

Bien que dans le schéma de versification le plus courant la Bible compte 31192 versets, il est peu probable que plus d'une petite fraction de l'ensemble des versets contienne des commentaires personnels. Une liste signalant les versets avec commentaire personnel s'obtient à l'aide du choix Liste des versets commentés du menu contextuel obtenu par un clic droit de la souris.

Le commentaire crée sera associé à un verset seulement. Pour écrire des commentaires rattachés à de plus longues portions de texte, utiliser la fonction Lien pour relier les commentaires entre eux.

## Listes de prières et Journaux

Xiphos accepte la création et l'édition par l'utilisateur de modules contenant du texte. Originellement conçus pour l'édition de simples listes de prières, ces modules incluent désormais des journaux quotidiens et des thêmes structurées. Il est ainsi possible de tenir à jour des listes de prières, de préparer des sermons, ou d'écrire n'importe quel contenu structuré.

Pour activer le support des journaux et listes de prières, ouvrir la fenêtre des Préférences. Dans le menu Général Options, sélectionner l'élément indiquant Activer les listes de prières. Une nouvelle entrée Liste de prières / Journal apparaît dès cet instant dans la liste de modules du volet latéral.

Un clic droit de la souris sur cette entrée présente un menu contextuel permettant de créer de nouveaux modules. Toutes les options présentées sont du même type mais avec des modèles différents à partir desquels travailler. Il existe 5 modèles pour le moment.

### Créer une note ou une liste de prières

Nouvelle note ou liste de prières

Le type de module reste le même, cependant les modèles présentés donnent quelques d'idées au niveau des différentes façons d'organiser les contenus. Liste simple peut être considérée comme une note basique. Liste ordonnée par sujet est une version plus structurée de la précédente. Journal mensuel présente une structure dans laquelle il est possible de faire un suivi mensuel. Journal quotidien est un calendrier annuel dans lequel enregistrer un journal ou des prières en cours. Et finalement, Note structurée présente une arborescence conçue pour inclure des sujets, des sous-sujets, etc..

Les journaux et listes de prières ont la structure d'un module de type livre. Lorsqu'ils sont sélectionnés depuis la liste de modules, ils se trouvent donc affichés dans le volet Livre.

Éditer un journal ou une liste de prières se fait à l'aide de la souris en cliquant du bouton droit sur le module choisi pour faire apparaître le menu contextuel, puis en sélectionnant le menu Ouvrir dans l'éditeur. Les sections et sous-sections sont affichées dans le volet de gauche. Sélectionner une section permet de la modifier dans l'éditeur. Le menu contextuel activé par un clic droit sur une section permet d'ajouter, supprimer et modifier les noms des sections et sous-sections.

Si le volet Livre affiche une liste de prières ou un journal en cours d'édition, le contenu est mis à jour dès que le bouton Enregistrer est activé.

Comme précédemment mentionné, les modules créés et édités par l'utilisateur sont en fait des des modules de type Livre. Ces modules sont donc utilisables immédiatement dans n'importe quelle application utilisant l'architecture logicielle du Projet SWORD, comme par exemple BibleTime. Il est possible également à l'aide de l'onglet Gérer du gestionnaire de modules de réaliser un archivage au format zip, puis de copier le fichier ainsi obtenu sur un sytème Windows puis d'installer le module pour une application Windows utilisant le Projet SWORD. Peu d'autres applications utilisant l'architecture logicielle du Projet SWORD offrent des outils d'édition de tels modules, ceci implique qu'ils apparaitront simplement comme des livres ordinaires.

Il est prévu, dans le futur, de mettre à disposition une fonction de partage de modules, ou de tels modules créés par l'utilisateur seront téléchargés et rendus disponible à une large audience. L'actuelle fonction d'installation de modules sera enrichie pour autoriser ce partage. Les utilisateurs pourront alors partager leurs sermons, études bibliques, ou tout autre contenu composé personnellement, avec d'autres utilisateurs d'applications utilisant l'architecture logicielle du Projet SWORD.

## Obtenir de l'aide en ligne

### Liste de diffusion des utilisateurs

Une façon d'obtenir de l'aide au sujet de &appname; est d'utiliser nos listes de diffusion à faible trafic. il suffit de s'abonner en sélectionnant ce lien. Une fois inscrit, un simple e-mail envoyé sur la liste décrivant les problèmes rencontrés amènera une réponse des autres utilisateurs ou des développeurs généralement dans la journée.

[NDT : La liste de diffusion est en langue anglaise]

### Discussion en ligne

Une autre façon d'obtenir de l'aide est d'utiliser le chat en ligne. &appname; a un canal IRC ouvert sur freenode, #xiphos;. Un moyen simple de se connecter est de sélectionner ce lien. (Ceci ouvre la fenêtre du navigateur Internet). Ensuite, saisir un pseudo ou accepter celui par defaut, et sélectionner « Click to join chatroom ». Ceci ouvre l'accès au salon où les développeurs et d'autres utilisateurs sont prêts à discuter des problèmes rencontrés. Généralement, les réponses aux questions sont immédiates, mais parfois cela peut prendre quelques minutes voire plus longtemps.

[NDT : Le chat en ligne est en langue anglaise]

## Étude des textes originaux

### Installer les modules nécessaires

Xiphos convient parfaitement à l'étude des textes originaux en grec ou hébreu. Pour commencer, il est recommandé d'installer les modules suivants :

Dépot Crosswire

- Dictionnaire StrongsHebrew (ou le StrongsRealHebrew du dépot &appname;)

  [NDT : dictionnaires en langue anglaise]

- Dictionnaire StrongsGreek (ou le StrongsRealGreek du dépot &appname;)

  [NDT : dictionnaires en langue anglaise]

- Dictionnaire Robinson (codes morphologiques)

  [NDT : dictionnaire en langue anglaise]

- Bible Louis Segond 1910 avec codes Strong et étiquettes morphologiques

Dépot &appname;

- Dictionnaire StrongsRealGreek (identique au StrongsGreek, mais avec caractères grecs, transliteration B-Greek, et liens de renvois)

  [NDT : dictionnaire en langue anglaise]

- Dictionnaire StrongsRealHebrew (identique au StrongsHebrew, mais avec caractères hébreu et liens de renvois)

  [NDT : dictionnaire en langue anglaise]

- Dictionnaire InvertedStrongsRealGreek définitions des mots grecs

  NDT : dictionnaire en langue anglaise]

### Configurer

Ouvrir le gestionnaire de modules et créer un index pour tous les modules installés. Ensuite fermer le gestionnaire de modules et ouvrir la fenêtre des préférences comme suit : Éditer·Préférences·et aller dans·Modules Spécial. Définir ensuite les lexiques hébreu et grec en fonction de ceux installés. Fermer la fenêtre des préférences. Dans la fenêtre principale, choisir la Bible Louis Segond 1910, afficher le menu contextuel par un clic droit de la souris et sélectionner Options du module Nombres de ·Strong·et·Options du module Étiquettes morphologiques. L'affichage du texte biblique change de façon à afficher les nombres de Strong sous les mots appropriés. Un survol des nombres de Strong (ou des étiquettes morphologiques) à l'aide de la souris fait apparaître la définition dans le volet Aperçu. Un clic sur le lien affiche la définition dans le volet Dictionnaire.

### Rechercher des Nombres de Strong

Ouvrir la fenêtre Recherche avancée par Éditer Recherche avancée ou·en pressant·F3. Dans Type de requête, choisir Optimisée Lucene. Ensuite sélectionner l'onglet Attributs, et cocher la case Nombres de Strong. Il est maintenant possible de rechercher un nombre de Strong dans la zone de saisie en le faisant précéder de « lemma: » accompagné de « G » pour la langue grecque et « H » pour la langue hébraïque. Ainsi pour rechercher le mot hébreu tsad-deek (6662), entrer : « lemma:G662 ». Une fois la recherche terminée et les résultats affichés, un clic sur un résultat fait afficher le contenu dans la zone Aperçu ainsi que les nombres de Strong suivant immédiatement les mots associés. Noter que survoler ces nombres avec la souris fait apparaitre la définition dans le volet Aperçu de la fenêtre principale.

### Modules additionnels

Pour des recherches approfondies, les modules suivants sont aussi disponibles :

- 2TGreek (Dépot &appname;) : Ce module contient la Bible entière en langue grecque. Il combine les modules LXX et Tischendorf8·NT en un seul module avec nombres de Strong, étiquettes morphologiques et accents grecs

- Elzevir Textus Receptus (Source: Crosswire beta) édition 1624 avec nombres de Strongs et étiquettes morphologiques

- LXX (Dépot Crosswire) : La Septante avec nombres de Strong, étiquettes morphologiques et notes de bas de page.

- MorphGNT (Dépot Crosswire beta) : Nouveau Testament grec dérivé du texte avec analyse des formes du Center for Computer Analysys of Texts de l'Université de Pennsylvanie. Il a été reformatté et corrigé par James Tauber. Inclut les accents grecs et les codes morphologiques.

- TR (Dépot Crosswire) : Le Textus Receptus avec codes Strong et étiquettes morphologiques.

- TischMorph (Dépot &appname;) : Ce module contient les étiquettes morphologiques, les accents grecs et les variantes du texte

- WHNU (Dépot Crosswire) : Wescott-Hort de 1881 avec codes Strongs et étiquettes morphologiques

- GreekHebrew (Dépot Crosswire) : Dictionnaire des nombres de Strong. Il contient des mots de la LXX qui se trouvent aussi dans le Nouveau-Testament. Additionnellement, il contient les mots équivalents en hébreu et les nombres de Strong associés.

- Didache (Répertoire Crosswire Beta) : La Didaché est un ancien traité chrétien grec datant de la fin du premier ou du début du deuxième siècle. Sont inclus les codes Strong, les étiquettes morphologiques et les accents grecs.