# Manuel de Pauker

30/08/2008
Version 1.8

Pauker est un logiciel d'aide à la mémorisation par cartes recto verso. Il tient compte des spécificités des mémoires à très court terme, court et long terme pour optimiser l'apprentissage avec un minimum d'effort et dans un minimum de temps. Il vous aidera à mémoriser de nombreuses choses comme le vocabulaire d'une langue étrangère, des capitales, des dates importantes, etc... Ce document présente une vue générale du mécanisme des cartes recto-verso, ainsi que le mode d'emploi du logiciel. Des informations utiles à ceux qui voudront participer au développement logiciel sont également fournies.

## Le système de cartes recto-verso

Il est basé sur une méthode de mémorisation très efficace. Cette méthode est très populaires chez les étudiants en médecine, dans les affaires, ou chez les juristes.

Le principe est très simple: Les informations sont décomposées en une partie question et en une partie réponse. La question est placée du coté recto de la carte, tandis que la réponse correspondante est placée coté verso. Lorsque suffisamment de cartes ont été crées, l'apprentissage peut commencer.

Pour commencer, plusieurs cartes sont tirées du lot et mémorisées rapidement. Cette mémorisation rapide ne devrait pas prendre plus de 30 secondes. Cela entraîne votre mémoire à ultra court terme.
Après cela, les cartes sont révisées en montrant le coté question et il faut se rappeler de la réponse. Si la réponse est correcte, la carte est placée dans la pile mémoire à court terme
. Si vous avez déjà oublié la réponse, la carte retourne dans la pile des cartes non apprises. Cette phase de mémorisation rapide ne devrait pas dépasser 15 minutes.

Après cette phase, et en fonction du sujet et de vos capacités d'apprentissage, un certain nombre cartes doivent maintenant êtres mémorisées dans votre mémoire à court terme. En répétant le processus décrit ci dessus, vous déplacez progressivement les cartes de la pile court terme vers la pile long terme
. Si vous répondez correctement, la carte est déplacée sur la pile suivante. Dans le cas contraire, la carte est replacée sur la pile non apprise.

Même les personnes ayant une excellente mémoire à long terme oublient au bout d'un certain temps. C'est pour cette raison que les cartes de la piles long terme ont également une date d'expiration. Les cartes au début de pile à long terme expirent après un délais d'un jour. Une fois expirée, une carte doit être révisée. Si lors de cette révision vous répondez correctement, la carte est déplacée sur la pile suivante, dans la seconde pile à long terme. Comme avant, si vous répondez mal, la carte est replacée dans la pile non apprise Les cartes se trouvant dans la deuxième pile à long terme ont une durée de vie plus longue que celles de la première pile à long terme. Les révisions des cartes à long termes déplacent ainsi les cartes de piles en piles, avec des délais d'expiration toujours croissants.

L'apprentissage avec le système de mémocartes est fun. Ce système est vraiment efficace si le jour de révision de chaque carte est pris en compte. Avec un système de cartes en papier, la gestion des piles et des dates d'expiration alourdit énormément le processus d'apprentissage. Heureusement, Pauker vous soulage de ces fastidieuses et perturbantes taches de gestion, vous pouvez ainsi concentrer toute votre énergie sur l'apprentissage.

## Utilisation

Cette section explique comment démarrer Pauker et comment gèrer les cartes, les lots et les leçons.

### Démarrer Pauker

Après le téléchargement de la version x.y.z de Pauker, démarrez le programme en cliquant sur le fichier pauker.x.y.z.jar. Sur certains systèmes, il faut faire un double clic si aucune des deux méthodes ne fonctionne, vous pouvez lancer la commande

              java -jar pauker-x.y.z.jar

Il y a un espace entre la commande. java et l'option-jar!

### Création d'une nouvelle leçon.

Au démarrage de Pauker, une fenêtre similaire à celle-ci apparaît:

Avec le bouton ajouter de nouvelles cartes, de nouvelles cartes sont ajoutées à la leçon courante. Un clic sur ce bouton ouvre une fenêtre similaire à celle-ci:

Les fonctionnalités disponibles pour l'édition des cartes sont les suivantes:

Edition simple.

Il y a les classiques fonctions défaire, refaire, couper, copier et coller.

Sens d'écriture du texte

Le bouton de gauche règle le sens d'écriture de la gauche vers la droite, comme utilisé dans la plupart des langue de l'Europe de l'ouest. Celui de droite règle le sens d'écriture de la droite vers la gauche, comme utilisé par les langues Arabes et en Hebreux.

Insertion de tabulations.

La touche TAB du clavier étant utilisée pour naviguer entre les contrôles de la fenêtre, le bouton TAB sur la barre d'outils est nécessaire pour l'insertion de tabulations.

Disposition des faces de la carte

Ce bouton permet de choisir si les faces sont affichées l'une à coté de l'autre, ou l'une au dessus de l'autre.

Propriétés des polices

Avec ces boutons, la police, la taille du texte, le mode gras, italique et souligné, ainsi que la couleur du texte peuvent être modifiés carte par carte.

Plus bas, il y a deux champs textes qui permettent la saisie du contenu de chaque coté de la carte. La méthode de répétition peut être définie par la liste déroulante Méthode de répétition. Si la méthode Répéter en se souvenant est choisie, lors de l'apprentissage vous aurez seulement à penser à la réponse et à cliquer sur le bouton Oui si vous connaissiez la réponse, ou sur Non si vous l'avez oubliée. Si vous choisissez l'autre méthode Répéter en tapant au clavier, lors des révisions vous devrez taper la réponse en toutes lettres au clavier.

Au bas de cette fenêtre, il y a une liste de cartes qui sont similaires à la carte courante. Cela vous avertit d'éventuelles cartes en doublon ou qui ont trop de similitudes. Si vous ne souhaitez pas voir cela, vous pouvez cacher le bas de la fenêtre en cliquant sur la petite flèche descendante du séparateur horizontal.

L'appuie sur la touche OK ajoutera la carte dans la pile des cartes non apprises de la leçon courante. Pour ajouter plusieurs cartes sans refermer à chaque ajout la fenêtre, vous pouvez cocher la case Laisser cette boite de dialogue ouverte..

### Apprentissage de nouvelles cartes

Lorsque vous aurez ouvert un lot de cartes, la fenêtre principale ressemblera à ceci: Notez que le bouton apprendre de nouvelles cartes est activé uniquement lorsqu'il y a des cartes dans la pile non apprise. L'appuie sur ce bouton démarre la procédure d'apprentissage, comme décrite dans la première section.

La moitié basse de la fenêtre montre les faces recto et verso d'une carte. Au bas de la fenêtre on trouve également un chronomètre.
Lorsque vous avez mémorisé la carte courante, vous pouvez cliquer sur le bouton Carte suivante pour continuer avec une nouvelle carte.

Si la minuterie vous perturbe, vous pouvez la masquer avec la case à cocher Afficher le chronomètre.

Pour faire une pause pendant l'apprentissage, vous pouvez cliquer sur le bouton pause en bas à gauche. Pour arrêter l'apprentissage, cliquez sur le bouton stop à coté du bouton pause. Notez que toutes les cartes se trouvant alors dans les piles ultra court terme et court terme seront déplacées dans la pile non apprises

Un fois que la durée de l'étape ultra court terme est atteinte, Pauker bascule à l'étape suivante, et vous aide à transférer les informations dans la mémoire à court terme.

Ces deux étapes sont alternées jusqu'à ce que toutes les cartes soient apprises.

Lorsque la phase de mémorisation à court terme expire, toutes les cartes sont redemandées encore une fois, après quoi cette phase d'apprentissage sera terminée.

### La répétition des cartes expirées

Pour calculer la durée de validité d'une carte apprise, Pauker utilise la formule suivante

validité = e(numéro de lot)-1 jours

Quand les cartes d'une leçon ont expirées, le bouton Répéter les cartes expirées peut être utilisé. Cela va lancer la révision des cartes expirées comme décrit plus haut.

### L'édition des cartes

Si vous cliquez sur une pile dans la partie statistiques, les cartes de cette pile seront listées dans le bas de la fenêtre. Un certain nombre d'actions sur les cartes sont alors disponibles grâce aux boutons suivants:

Éditer

Pour éditer une carte, une fois une pile de cartes affichée (voir ici), vous pouvez sélectionner la carte en cliquant dessus, puis cliquer sur le bouton éditer. Vous pouvez aussi double cliquer sur la carte.

Régler la police.

Avec ces boutons, vous pouvez choisir la police des cartes sélectionnées. La fenêtre suivante s'ouvre alors: Avec les boutons du haut, vous pouvez régler la police, la taille du texte, les modes gras, italique, et les couleurs du texte. Pour vérifier l'effet de vos réglages, le champ texte contient un exemple avec toutes les lettre de l'alphabet. Avec les trois boutons du bas, vous choisissez si les réglages doivent êtres appliqués sur le coté recto, verso, ou sur les deux faces.

Définir la méthode de répétition.

Grâce à ce bouton, vous sélectionnez soit la méthode rapide Répéter en se souvenant, soit la méthode Répéter en tapant au clavier, avec laquelle il faut taper les réponses en toutes lettres.

Le déplacement des cartes

Les cartes sélectionnées peuvent êtres librement déplacées dans la pile avec ces deux boutons.

Le tri

Les cartes d'un lot peuvent êtres triées selon différents critères. En cliquant sur le bouton de tri, vous déroulez un menu par lequel vous pouvez choisir parmi de nombreux critères de tri.

Le mélange des cartes

Le bouton Mélanger la pile place les cartes dans un ordre aléatoire.

Répétition immédiate.

Avec ce bouton, les cartes sélectionnées seront révisées immédiatement. Les carte seront déplacées en haut de la première pile et marquées comme expirées.

Non apprises

Un clic sur ce bouton déplace la carte dans la pile des cartes non apprises. C'est utile si vous vous êtes trompé en ayant répondu que vous connaissiez la réponse à une carte oubliée.

Effacement

Les cartes peuvent être supprimées grâce à ce bouton.

Recherche

Ce bouton ouvre une fenêtre de recherche de cartes selon plusieurs critères.

### Les caractères spéciaux

Si vous utilisez Pauker dans l'optique d'apprendre une langue étrangère, vous aurez besoin de saisir des caractères spéciaux. Pour le moment, Pauker ne sait pas gérer cette problématique, mais votre système d'exploitation (Ms windows, OS X, Linux...) peut vous rendre ce service. Nous allons voir une méthode de saisie chacun pour des environnements suivants: MW Windows, MacOSX, Gnome, KDE:

#### GNU/Linux

GNU/Linux est un système d'exploitation pouvant être associé avec de nombreux environnements de bureau. Les plus répandus sont KDE (http://www.kde.org) et GNOME (http://www.gnome.org).

##### KDE

Ce chapitre s'applique à KDE 3.5.8.

Vous pouvez saisir tous les caractères spéciaux sur votre clavier. Il suffit simplement de lancer l'application Centre de configuration de KDE , puis dans Régionalisation et accessibilité disposition de clavier : d'ajouter la disposition de clavier pour la langue de votre choix, puis enfin, cliquez sur Appliquer. Vous trouverez alors l'icône de sélection de disposition du clavier dans la zone de notification de KDE en bas à droite du bureau. Cliquez simplement dessus pour sélectionner la disposition de clavier voulu. Voir la figure suivante:

Si vous ne connaissez pas la disposition des touches du clavier sélectionné, vous pouvez également utiliser un clavier visuel tel xvkbd: Pour obtenir plus d'informations, consultez http://homepage3.nifty.com/tsato/xvkbd

Une troisième alternative est d'utiliser un logiciel de sélection de caractère comme KCharSelect: Vous devrez alors saisir votre texte dans ce logiciel puis le copier coller dans la fenêtre de saisie de Pauker.

##### GNOME

Ce chapitre s'applique à GNOME 2.20.

Pour saisir des caractères spéciaux sur votre clavier, lancez Système Préférences Clavier : Dans l'onglet Agencements vous pouvez ajouter jusqu'à quatre dispositions de claviers. Pour pouvoir changer rapidement la disposition du clavier, faites un click droit dans le panneau Gnome et choisissez Ajouter au tableau de bord... Dans la fenêtre suivante, sélectionnez alors Indicateur de claviers, puis cliquez sur Ajouter et enfin, fermez la fenêtre. Un sélecteur de disposition de clavier apparaît alors dans le panneau de Gnome:

Si vous ne connaissez pas la disposition du clavier, vous pouvez sans doutes préférer utiliser un clavier visuel. Voir plus haut.

La troisième possibilité est l'utilisation d'un outil de selection de caractère. Exécutez Applications Accessoires Table des caractères : Vous pouvez alors saisir le texte avec la table des caractères, et il ne reste qu'à le copier coller dans la fenêtre de saisie de Pauker.

#### OS X

Ce chapitre s'applique à OS X 5 Leopard.

Pour insérer des caractères spéciaux sur OS X, il est nécessaire d'activer le menu Saisie dans la barre de menu. Allez dans le menu Apple Préférences système... . et choisissez « International »: Dans cette fenêtre, choisissez l'onglet Menu Saisie: et activez l'option Afficher le menu Saisie dans la barre des menus . Vous pouvez à présent activer les langues nécessaires dans la liste centrale de la fenêtre. Pour les langues asiatiques, (Coréen, Japonnais, Chinois simple et traditionnel, Tamoul, et Vietnamien) OS X permet de choisir certaines polices et transcriptions dans les paramètres du clavier. Par exemple, il est possible de choisir à la fois les alphabets japonais (Hiragana and Katakana) et deux transcriptions (Romanji) séparément.

Maintenant vous avez activé le Menu Saisie Pour changer la langue de saisie courrante, choisissez la langue correspondante dans le menu. Le clavier fonctionnera alors comme s'il s'agissait d'un clavier de la langue

La palette de caractères peut être activée via the menu clavier. Cliquer sur. Afficher Palette de caractères . Avec cet outil, vous pouvez insérer tous les caractères supportés par le système. Les caractères sont triés par catégories (à gauche) et peuvent être sélectionnés à droite. Avec le bouton Insérer vous pouvez insérer des caractères dans un champ texte. En haut, vous pouvez chaner la vue pour par exemple faciliter la recherche des caracteres asiatiques. En cliquant sur Infos du caractère, vous pouvez obtenir quelques informations générales ainsi que des caractères similaires. Vous pouvez insérer des caractères avec une police différente grâce au boutonVariante de police

La palette de caractères offre beaucoup d'options de configuration. L'explication en détail de tous ces points sort du cadre de cette documentation. Veuillez consulter l'aide en ligne de OS X pour plus d'informations.

Le visualiseur de clavier peut être activée via le menu clavier en cliquant sur Afficher visualiseur de clavier. Le visualiseur de clavier, vous permet de manipuler le clavier dans la langue sélectionnée, sans connaître la disposition du clavier. Pour insérer des symboles, vous pouvez changer la sélection de la police en bas de la fenêtre.

#### Windows

Ce chapitre s'applique à MS Windows XP.

Allez dans Démarrer Paramètres Panneau de configuration Options régionales et linguistiques Onglet langues . Cliquez sur le bouton « Détails » puis sur « Ajouter », sélectionnez alors la nouvelle langue de saisie. Select your new input language. Cliquez sur OK, OK et OK. Une barre de langue est désormais active en bas à droite du bureau: Vous pouvez l'utiliser pour changer la langue de saisie au clavier.

Si vous ne connaissez pas la disposition des touche du clavier, vous pouvez utiliser le clavier visuel. Allez dans Démarrer Programmes Accessoires Accessibilité Clavier visuel :

En troisième possibilité, vous pouvez utiliser la table des caractères. Aller dans Démarrer Programmes Accessoires Outils systèmes Table des caractères. : Saisissez alors le texte avec la table des caractères, et il ne reste qu'à le copier coller dans la fenêtre de saisie de Pauker.

### Import et export des leçons

Pauker peut importer des leçons depuis le format CSV (champs séparés par des virgules). Le format peut être choisi à l'ouverture d'une leçon dans la fenêtre de sélection de fichier, voir la figure suivante: Les leçons à importer peuvent êtres encodées de différentes manières. Les formats d'encodage supportés par Pauker sont visible dans la liste déroulante Type de fichier, voir figure suivante.
Si vous voulez fusionner deux leçons, vous devez en ouvrir une première, et cocher la case Fusionner les leçons à l'ouverture de la seconde.

Une leçon peut aussi être exportée au format CSV. Pour cela, sélectionnez simplement le Type de fichier CSV (champs séparés par des virgules) lors de l'enregistrement.

### Divers

Si vous avez crée une leçon intéressante ou utile, vous pouvez partager les cartes avec d'autres utilisateurs. Placez toutes les cartes dans la pile non apprise en sélectionnant Fichier Réinitialiser la leçon... .

Pour certains types d'informations, il peut être utile d'inverser les faces des cartes, au lieu de recréer un jeu inversé. Par exemple, c'est intéressant pour les pays et leurs capitales. Pour cela, utilisez le menu: Fichier Inverser les faces des cartes... .
Bien sûr, cela est seulement judicieux avec des leçons pour lesquelles il existe une relation de un vers un entre les questions et les réponses.

L'interface utilisateur de Pauker est principalement conçue pour une utilisation à la souris. Dans quelques cas, par exemple lors de l'apprentissage ou de la révision des cartes, c'est assez gênant de devoir bouger la souris en permanence. C'est pourquoi lors de ces phases, Pauker fonctionne également avec le clavier. L'appuie sur un bouton est fait par la touche Entrée, et le choix du bouton se fait avec la touche TAB.

## Configuration

### Remarque préliminaire.

Un logiciel devrait exécuter une tache d'une manière idéale. La configuration d'options s'écarte de cette philosophie et rend le travail des utilisateurs et des programmeurs plus difficile. Pour cette raison, le nombre d'options dans Pauker a été volontairement limité.

Les options de configurations peuvent êtres modifiées en sélectionant Extra Configurer Pauker... .

### Stratégies

Il y a différentes approches possibles pour apprendre (et oublier) les cartes. Si vous avez un examen qui approche avec seulement du nouveau vocabulaire, vous voudrez apprendre les nouveaux mots en premier. D'un autre coté, si vous voulez tester votre mémoire à long terme, vous voudrez réviser les anciennes cartes d'abord. Une troisième possibilité est l'ordre aléatoire

Si vous oubliez des cartes, vous pouvez les placer en haut de la pile des cartes non apprises, pour tenter de les réapprendre rapidement. Cela peut cependant être ennuyeux, si vous ne pouvez définitivement pas retenir que la capitale du Sri Lanka est Sri Jayawardhenepura. Pauker peut être configuré pour oublier les cartes placées en bas de la pile des cartes non apprises.

Cependant, avec quelques leçons plus petites, il est probable que vous mémorisiez uniquement l'ordre d'apparition des cartes.

Pour résoudre ce problème, vous pouvez configurer Pauker pour placer les cartes incorrectes n'importe où dans la pile des cartes non apprises.

### Le temps

Chaque personne a une mémoire différente. Ce qui semble être un court instant pour une personne peut être beaucoup plus long pour une autre. C'est pourquoi les durées d'expiration des chronomètres des mémoires à ultra court terme et court terme peuvent êtres personnalisées. En pressant le bouton Valeurs par défaut vous pouvez annuler votre réglage et rétablir la valeur par défaut.

### Divers

Certaines personnes veulent que Pauker contrôle exactement la correspondance de la réponse tapée au clavier. D'autres ne le souhaitent pas, et sont harassées par les messages d'avertissement. Pauker peut être configuré pour satisfaire ces différents besoins, pour la satisfaction du plus grand nombre.

Certaines personnes créent des cartes avec de très longues lignes, bien qu'elles aient un petit moniteur. Pour ces personnes, il est intéressant d'activer la césure automatique des mots, pour qu'elles n'aient pas à faire défiler le contenu des cartes en permanence. Si vous créez des cartes avec un formatage méticuleux, la présentation peut être dégradée par la césure automatique. Il convient alors de la désactiver.

Parfois, certaines notions ou abréviations apparaissent de nombreuses fois dans une même leçon. La liste de cartes similaires peut ainsi rapidement devenir très longue.

Si vous éditez de telles leçons, vous pouvez restreindre la probabilité de trouver des cartes similaires.

Cette restriction s'effectue par le nombre de lettres minimal qu'un mot doit contenir pour qu'il soit utilisé pour la recherche de similarité.

Quand vous attendez qu'un chronomètre expire, Pauker vous prévient par une sonnerie dès que la temporisation arrive à son terme. Cette sonnerie faisant tomber certaines personnes de leur chaise, sachez que vous pouvez la désactiver.

## Contribuer à Pauker

Il y a plusieurs moyens de contribuer à Pauker. L'un est le soutien financier par le lien PayPal sur la page d'accueil du projet.

Un autre est de travailler sur le projet lui même.

Il n'est pas nécessaire d'être programmeur, mais ca ne fait pas de mal non plus.

Une contribution peut se traduire par l'ajout d'une fonctionnalité manquante à Pauker, des corrections de bogues, ou la traduction de l'interface utilisateur, ou de la documentation en d'autres langues.

### Prérequis

Pour pouvoir modifier Pauker, vous avez besoin du JDK courant et de Netbeans. Vous pouvez les télécharger ici http://java.sun.com/javase/downloads/index.jsp

Si vous avez déjà un Kit de développement java, vous avez uniquement besoin d'installer Netbeans ( http://www.netbeans.org).

### Préparatifs

Pauker nécessite l'installation un plugin supplémentaire dans NetBeans. Cliquez sur Tools Plugins . Si aucune mise à jour n'est disponible, la fenêtre suivante doit s'afficher: Si des mises à jour de Netbeans sont disponibles, la fenêtre s'ouvrira sur son onglet Updates. Dans ce cas, il faut d'abord faire les mises à jour, puis réessayer.

Cliquez sur l'entête de colonne Name pour trier par ordre alphabétique. Recherchez le plugin Jemmy Module, cliquez sur la case à cocher du module puis sur le bouton Install. Cliquez alors sur le bouton Next, puis sur le bouton radio: I accept the terms in all of the license agreements, puis sur le bouton Install. Après l'installation du module Jemmy, cliquez sur Finish et fermez la fenêtre des plugins.

### Accès au code source via CVS

Le code source de Pauker est accessible via CVS. Des information sur le sujet sont disponibles à l'adresse: http://sourceforge.net/cvs/?group_id=40334

Un client CVS très pratique est intégré à NetBeans. Pour l'utiliser pour télécharger Pauker, les étapes suivantes sont à suivre.

1. Aller dans le menu Versioning CVS Check Out... . La fenêtre suivante s'ouvre alors:

2. À la premiere étape de la boite de dialogue Checkout, vous insérez :pserver:anonymous@pauker.cvs.sourceforge.net:/cvsroot/pauker dans le champ CVS Root puis pressez sur le bouton Next.

3. Remplissez ensuite correctement les champs à l'étape 2:

   Dans le champs Module, vous devez insérer project.

   Dans le champs Local Folder vous devez afficher le répertoire dans lequel vous voulez récupérer le code source de Pauker. Le bouton Browse... vous aide à choisir ce répertoire.

4. Télécharger les fichiers

   Si vous avez correctement rempli les champs, un clic sur Finish va télécharger tout le code source de Pauker depuis Sourceforge, voir la figure suivante:

5. Ouverture du projet

   Après le téléchargement du code source de Pauker, Netbeans vous demande si vous voulez ouvrir le projet. faites le en cliquant sur le bouton Open Project

   Nous y sommes, Pauker est maintenant un projet Netbeans fonctionnel.

### Modification du code source

Maintenant, vous pouvez modifier le code source. Le code java est rangé dans les packages pauker.program et pauker.program.gui.swing.

L'appuie sur F6 compile automatiquement le logiciel et lance Pauker.

### Traductions dans d'autres langues

#### Mise à jour des traductions

Les textes de l'application ne sont pas codés en dur, mais sont placés dans des fichiers property. Ainsi, programmeurs et traducteurs peuvent travailler d'une façon relativement indépendante.

Pauker a déjà été traduit en quelques langues, mais on peut faire mieux. La figure suivante montre à quels endroits sont rangés les fichiers des textes de l'application dans les différentes langues.

Pour éditer les traductions, vous devez faire un clic droit sur le fichier `Strings.properties` et choisir le menu option Open . Attention! Ni le double clic sur `Strings.properties`, ni le clic-droit->Edit ne fonctionnent comme attendu!

Après avoir ouvert le fichier `Strings.properties`, un nouveau formulaire apparaît, dans lequel toutes les traductions sont affichées (voir figure suivante). Vous pouvez maintenant éditer les traductions. Malheureusement, cette vue n'est pas présentée très clairement. En double cliquant sur l'onglet Strings.properties, vous pouvez maximiser le formulaire. Si vous voulez éditer une traduction précise, vous pouvez réduire les colonnes des autres langues (Voir figure suivante). Maintenant, nous pouvons travailler à la traduction avec cet outil.

Notez qu'il n'est pas utile de traduire les textes qui sont identiques dans votre langue aux textes de la colonne de langue par défaut. Par exemple, en Anglais, le mot Status est identique à sa traduction en Allemand Status, il ne sera pas traduit. (voir figure suivante). La même règle s'applique aux différentes variantes de langues: Par exemple, l'allemand en Allemagne et en Suisse s'écrivent exactement de la même manière, excepté le caractère ß qui est remplacé par ss. Ainsi, la traduction de de_CH - German (Switzerland) est presque vide, sauf pour quelques exceptions. Par exemple: Größe est traduit par Grösse

En plus des textes du logiciel, vous pourrez traduire le fichier `credits_<votre_code_de_langue>.html` (voir figure suivante): Ce fichier est affiché via le menu Aide À propos... de Pauker.

Un autre fichier à traduire est celui concernant l'information de licence de Pauker. Ce fichier est nommé `license_<your language code>.html` (voir figure suivante): Il y a déjà quelques traductions non officielles de la licence sur le site web suivant: http://www.gnu.org/licenses/translations.html

Un autre document devant être traduit est le fichier d'aide. Cette documentation est écrite au format DocBook. Pour plus d'informations sur ce format, veuillez consulter le site suivant: http://www.docbook.org

Le code source de ce document est dans le répertoire doc du répertoire Pauker. (voir figure suivante): Vous pouvez éditer le fichier `Pauker.docbook` directement dans NetBeans. Il est vivement conseillé de configurer NetBeans pour éditer les fichiers .docbook comme des fichiers XML. NetBeans affichera alors la coloration syntaxique, et offrira la possibilité de valider en ligne le document. Pour cela, ajoutez l'élément docbook dans Tools Options Advanced Options IDE Configuration System Object Types XML Objects Extensions and MIME Types

Pauker utilise JavaHelp pour afficher l'aide en ligne. Pour plus d'information, veuillez consulter le site web: https://javahelp.dev.java.net

Pour transformer le fichier `Pauker.docbook` au format JavaHelp, nous utilisons XSLT. Voir le site suivant: http://www.w3.org/TR/xslt

La transformation des fichiers docbook de Pauker en JavaHelp dans toutes les langues est un processus relativement complexe. C'est pourquoi, une cible Ant 1_create-docs a été écrite pour faire tout cela automatiquement. (voir figure suivante): Cette tache Ant doit fonctionner sur toutes les distributions Linux si vous avez installé le logiciel xsltproc Pour plus d'information sur l'écriture d'une cible Ant, consultez le site: http://ant.apache.org

Pour pouvoir visualiser le résultat, vous devez lancer Pauker avec la traduction mise à jour. Appuyez simplement sur la touche F6.

Pour voir Pauker avec la nouvelle traduction, votre system d'exploitation peut être démarré dans la langue de votre nouvelle traduction. Si vous ne pouvez ou ne voulez pas changer la langue de votre système d'exploitation, vous pouvez configurer le project Pauker dans netbeans comme ceci: Faites un clic droit sur le projetPauker et choisissez le menu Properties .

Dans les propriétes du projet, catégorie Run vous pouvez soit choisir une langue déjà existante à partir de la liste déroulante en haut de la fenêtre, ou si votre langue cible n'existe pas encore, vous pouvez ajouter une nouvelle configuration et régler les options de la machine virtuelle java ( VM-Options) comme ceci: `-Duser.language=<language code>` et `-Duser.country=<country code>`. Après cela, vous pouvez relancer Pauker en pressant la touche F6.

Vous pouvez facilement permuter les différentes configurations de langue en utilisant la liste déroulante suivante sur la barre d'outils de netbeans:

#### Ajout de traductions

Si vous ne voulez pas juste étendre ou corriger une traduction mais plutôt ajouter une nouvelle langue, faites un clic droit sur `Strings.properties` et sélectionnez le menu Add Locale... . Pour être utilisé dans tous les pays où la langue est parlé, vous ne devriez pas utiliser d'autres spécialisations comme le code pays ou des variantes.

En complément de l'ajout d'un fichier `Strings_<langue>.properties` vous devrez également créer et traduire un nouveau fichier de remerciements en suivant les étapes décrites:

1. sélectionner `credits.html`

2. copier le fichier, ex: en faisant Ctrl+C

3. sélectionner le package pauker

4. coller le fichier ex: en faisant Ctrl+V

5. renommer le fichier `credits_1.html`, ex: clic droit et selection du menu Rename... puis changer le nom du fichier en `credits_<langue>.html`

Dans votre nouveau fichier `Strings_<langue>.properties` vous devez régler la traduction du texte About_Message_File pour qu'il pointe sur votre nouveau fichier de remerciements `credits_<language>.html`.

Le fichier à traduire suivant est celui contenant les informations de licence `license.html`. Copiez le puis renommez le en suivant les mêmes étapes que pour le fichier de remerciements. (voir plus haut). Veuillez noter qu'il existe déjà un certain nombre de traductions non officielles. Voir sur le site: Unofficial GNU License Translations Page: http://www.gnu.org/licenses/translations.html

Dans votre nouveau fichier `Strings_<langue>.properties` vous devez régler la traduction du texte License_File pour qu'il pointe sur votre nouveau fichier de licence `license_<langue>.html`.

Enfin, il ne reste plus qu'à traduire le fichier d'aide. Pour cela, vous devez:

1. Créer un nouveau répertoire pour votre langue dans le répertoire `doc/docbook/`.

2. Copier le fichier `Pauker.docbook` à partir d'une autre langue dans votre répertoire.

3. Traduire votre copie de `Pauker.docbook`.

4. Modifier la cible Ant 1_create-docspour gérer la transformation docbook vers javahelp.