


==========================================================================
                        Guide du traducteur KDE
                              Version 0.3
==========================================================================




..........................................................................
Pour toutes remarques, commentaires ou ajouts, contactez de préférence le 
mainteneur par courrier : rjacolin A ifrance POINT com ou bien la liste
kde-francophone@kde.org
..........................................................................




Auteur : Robert Jacolin






===========================================================================
THÈMES ABORDÉS :
===========================================================================


[I]   INTRODUCTION
	# I.1 # Contenu de ce document
	# I.2 # Quelles sont les différentes manières d'aider l'équipe francophone KDE ?
	# I.3 # Les différents sites web

[II]  LA TRADUCTION DES APPLICATIONS
	# II.1 # Que dois-je savoir pour traduire une application ?

[III] LA TRADUCTION DE LA DOCUMENTATION
	# III.1 # Comment connaître les entités utilisables dans les docs ?
	# III.2 # Comment générer une doc. ?

[IV]  TRADUIRE
	# IV.1 # KBabel
		IV.1.a Configurer KBabel
		IV.1.b Traduction automatique (débrouillage)
		IV.1.c Exemple de traduction
		IV.1.d Espace insécable
		IV.1.e Copier la chaîne anglaise
		IV.1.f La chaîne anglaise possède un contenu bizarre
		IV.1.g Utiliser les templates
		IV.1.h Au-delà de la FAQ

	# IV.2 # Le gestionnaire de catalog (catalogmanager)
		IV.2.a Qu'est-ce que le gestionnaire de catalog (catalogmanager) ?
		IV.2.b Configurer catalogmanager

	# IV.3 # Divers
		IV.3.a Dr Klash

[V]   LES PROCESSUS DE TRADUCTION
	# V.1 # Comment récupérer les fichiers de traduction ?
	# V.2 # Comment générer le fichier dictionnaire ?
	# V.3 # Je veux traduire. Comment m'y prendre ?
	# V.4 # Processus de traduction d'un fichier po
	# V.5 # Quel est le processus de relecture ?

[VI]  LES OUTILS CONNEXES
	# VI.1 # checker
	# VI.2 # ispell
	# VI.3 # cvs
	# VI.4 # anoncvs
	# VI.5 # cvsup
	# VI.6 # webcvs

[VII] L'ASSOCIATION KDE-FRANCE




=================================================================================
[I] Introduction
=================================================================================

# I.1 # Contenu de ce document
------------------------------

Chapitre II. Conseils et informations relatifs à la traduction des applications.
Chapitre III. Conseils et informations relatifs à la traduction de la documentation.
Chapitre IV. La traduction elle-même.
Chapitre V. Les processus de traduction (réservation, relecture).
Chapitre VI. Les outils utilisés pour la traduction.
Chapitre VII. L'association KDE-France.

# I.2 # Quelles sont les différentes manières d'aider l'équipe francophone KDE ?
------------------------------------------------------------------------------

Nous avons besoin de :
 o générer régulièrement des paquetages binaires de KDE et des applications KDE 
 pour différentes distributions ;
 o administrer le site web de l'équipe ;
 o écrire des articles sur KDE et les applications faisant parties ou non de la 
 distribution de KDE.

# I.3 # Les différents sites web
--------------------------------

Il y a tout d'abord le site web de kde situé à l'adresse http://www.kde.org/fr
où vous trouverez régulièrement des informations sur le développement et la vie
de KDE.

Ensuite, le site web de l'équipe de traduction qui se situe à l'adresse
http://i18n.kde.org/teams/fr où vous trouverez les informations nécessaire pour
traduire les applications et la documentation de KDE.

Enfin, il reste l'association française de KDE, appelé kde-france, dont le site
est http://www.kde-france.org. Le but de cette association est de promouvoir KDE
en France et de représenter KDE aux salons présent en France.


=================================================================================
[II] La traduction des applications
=================================================================================

# II.1 # Que dois-je savoir pour traduire une application ?
-----------------------------------------------------------

Une fois que vous avez votre fichier po, il suffit de l'ouvrir avec kbabel et de 
parcourir tous les messages pour traduire les messages non traduits ou mettre à
jour ceux qui sont dans l'état fuzzy.

Un certains nombre de pièges sont à éviter. Il faut :
	o éviter de faire phrases sans verbes. Par exemple : « erreur détectée » au 
	lieu de « une erreur a été détectée » ;
	o mettre des espaces insécables (Cf. IV.1.d Espace insécable) ;
	o utiliser les traductions choisies par l'équipe de traduction. Si une traduction
	ne vous convient pas, parlez-en sur la liste, mais ne l'utilisez pas. Vous
	ne ferez que dérouter l'utilisateur (avertie comme non avertie d'ailleurs).


=================================================================================
[III] La traduction de la documentation
=================================================================================

# III.1 # Comment connaître les entités utilisables dans les docs ?
--------------------------------------------------------------------

Consulter le fichier kdebase/kioslave/help/customization/fr/user.entitie


# III.2 # Comment générer une doc. ?
------------------------------------

Les manuels sont traduits sous la forme de fichier po. Ces fichiers seront 
convertis en fichier docbook qu'il faut ensuite convertir pour HTML.

Génération du modèle à partir de la version anglaise :
$ mv index.docbook index_en.docbook
$ xml2pot knetworkconf.pot index_en.docbook

Génération du manuel français en docbook :
$ po2xml index_en.docbook knetworkconf.po > index.docbook

Génération du manuel français en HTML :
$ meinproc index.docbook

Il est possible de générer le cache, utilisé par khelpcenter
$ meinproc --cache index.cache.bz2 index.docbook

=================================================================================
[IV] Traduire
=================================================================================

# IV.1 # Kbabel
---------------

KBabel est l'outil utilisé pour traduire KDE.

IV.1.a Configurer KBabel
------------------------

b. Informations sur l'auteur
Nom complet de la langue : français
Liste de diffusion : kde-francophone@kde.org
Il est utile que tout le monde mette son nom dans l'en-tête afin de 
faciliter le travail avec le gestionnaire de catalogue.

c. Enregistrement
N'oubliez pas de décocher la case "Enregistrer les entrées 
périmées"

Description : traduction de @PACKAGE@.po en @LANGUAGE@

Cocher la case intitulée « Conserver l'encodage du fichier ».

d. Source (facultatif)
Définir le dossier de base pour le code source

e. Génération de la bdd de traduction.
Menu Configuration / Configurer le dictionnaire Base de données

Onglet Base de données.
Cliquez sur « Examiner les dossiers & sous-dossiers... » puis choisissez le 
dossier de base kde-i18n/fr/messages


IV.1.b Traduction automatique (débrouillage)
-----------------------------------------------

De plus, vous pourrez utiliser la "rough translation", qui traduit 
automatiquement un fichier po entier à partir de ce qu'il connaît déjà (mets
les messages en fuzzy).

Ça permet de gagner du temps pour les messages standard (loading...) : Ctrl-U 
pour virer le fuzzy.


IV.1.c Exemple de traduction
----------------------------
Si un mot ou une expression anglaise vous pose problème ou que vous désiriez
connaître la traduction utilisée par les autres membres de l'équipe, vous 
pouvez lancer une recherche. Pour cela, il faut utiliser la base de données
de traductions.

Vous pouvez soit sélectionner un mot / une expression et utiliser le raccourci
CTRL+SHIFT+1, soit utiliser le raccourci CTRL+1 pour chercher la chaîne
entière.

----------------------------------------------------------
   Raccourci  | Type de recherche
----------------------------------------------------------
 CTRL+SHIFT+1 | Recherche d'une expression sélectionnée
----------------------------------------------------------
 CTRL+1       | Recherche sur un message
----------------------------------------------------------



IV.1.d Espace insécable
-----------------------

(avant :, ?, !, %, », après « ou n'importe où quand un retour chariot est 
indésirable, par exemple entre un chiffre et une unité, dans les lignes de commande),
il faut faire dans KBabel

ALT + Espace

IV.1.e Copier la chaîne anglaise
--------------------------------
Parfois certaines chaînes originale (msgid) ont un format qui peut dérouter. 
Pour voir ce qu'il faut traduire, vous pouvez copier la chaîne par le raccourci
CTRL+espace. Tous ce qui ne doit pas être traduit est enlevé.

IV.1.f La chaîne anglaise possède un contenu bizarre
----------------------------------------------------
Les formes pluriels ont un formalisme particulier :
_n: 1 file to remove\n
%1 files to remove.

Faite une copie de la chaîne anglaise dans la version française (voir question 
précédente).

Vous devez ensuite tout traduire, excepté le « _n: ». Ainsi la traduction française
deviendra :
_n: 1 fichier à supprimer\n
%1 fichiers à supprimer.


IV.1.g Utiliser les templates
-----------------------------

IV.1.h Au-delà de la FAQ
------------------------

Nous vous conseillons vivement de lire la documentation de KBabel qui contient des conseils
tout aussi importants sur la traduction (typographie, ...).


# IV.2 # Le gestionnaire de catalog (catalogmanager)
----------------------------------------------------

IV.2.a Qu'est-ce que le gestionnaire de catalog (catalogmanager) ?
-----------------------------------------------------------------

C'est une application qui permet de gérer les fichiers de traduction. Vous pouvez
avoir l'état de chaque fichier (nombre de fuzzy, nombre de messages non traduit, 
...). Vous pouvez aussi lancer kbabel en double-cliquant sur le fichier à traduire.
Enfin, il permet aussi de gérer l'envoie des fichiers pour relecture et publication 
sur le CVS.


IV.2.b Configurer catalogmanager
--------------------------------

Ouvrez la boîte de dialogue de configuration de l'application. Dans le premier
onglet vous avez deux chemins à saisir :
	o le dossier de base des fichiers po traduits en français. Par exemple :
	/data/cvs/kde-i18n/fr/messages ;
	o le dossier des modèles (fichier pot). Par exemple :
	/data/cvs/kde-i18n/templates

# IV.3 # Divers
---------------

IV.3.a Dr Klash
---------------

Vous éditez le fichier ~/.kde/share/config/kdeglobals:

Vous y mettez quelque chose du genre :

| [Development]
| CheckAccelerators=<keyname>

Par exemple :

| [Development]
| CheckAccelerators=F8

Relancez KDE


=================================================================================
[V] Les processus de traduction
=================================================================================

# V.1 # Comment récupérer les fichiers de traduction ?
------------------------------------------------------

Pour récupérer le module (mode opératoire complet) :
$ cvs co kde-i18n/fr/
$ cvs co -l kde-i18n
$ cvs co kde-common
$ cd kde-i18n
$ ln -s ../kde-common/admin .
 changer le contenu du fichier subdirs (virer toutes les lignes sauf
'fr')
$ make -f Makefile.cvs


# V.2 # Comment générer le fichier dictionnaire ?
----------------------------------------------

Pour les utilisateurs de kbabel (que vous devriez tous être) et SURTOUT pour 
les débutants dans la traduction.

Utiliser la BDD des traductions, générée à partir de kbabel. Cette base de données nécessite DB4.

Ainsi, lorsque vous hésiterez sur une traduction, kbabel vous fournira toutes 
les traductions déjà existantes des messages contenant les mêmes mots.


# V.3 # Je veux traduire. Comment m'y prendre ?
--------------------------------------------

1. Installer kbabel

2. Installer le checker

3. Récupérer une version CVS de KDE et la compiler

4. Traduire un fichier, pas trop gros ni trop important :
 o les gros fichiers nécessitent un fort investissement qui peux décourager tout traducteurs débutant
 o la traduction d'un fichier peu important peut être abandonnée sans entraîner de grande conséquence.
 
Chacune de ces étapes est décrite de façon plus approfondie dans un autre chapitre.


# V.4 # Processus de traduction d'un fichier po
--------------------------------------------

1. Consulter la page http://fr.i18n.kde.org/apps/wip-apps.php3 pour réserver
une application ou http://fr.i18n.kde.org/apps/wip-docs.php3 pour réserver une
doc sur le site web du groupe de traduction.


2. Réserver un fichier en envoyant un courrier sur la liste de 
discussions kde-francophone@kde.org
Pensez à préciser le module contenant le fichier choisi.

3. Attendre une réponse de la personne qui gère les réservations

4. Traduire.

N'hésitez pas à poser des questions sur la liste de dicussions pour tous problème 
de traudction, elle est faite pour ça.

5. Passer le fichier au vérificateur d'orthographe + au checker (voir Chapitre 
Outils), contrôler la traduction en manipulant l'application.

6. Envoyer le fichier à guikdefr@free.fr pour une traduction d'une interface 
graphique et à dockdefr@free.fr pour une traduction d'un document pour commit 
et envoi d'un courrier à relecturekdefr@free.fr pour relecture. Le courrier 
doit être sous la forme :
SUJET : {[BRANCHE-CVS]} [MODULE] [FICHIER] {[NEW]}

CONTENU :
Tous messages sur l'état de la traduction.

{} : mention facultative
Par défaut :
 o branche : HEAD
 o état    : UPDATE

Exemple :
SUJET   : [KDE-3.1] [KDEUTILS] [kcalc.po]
CONTENU :
Je n'ai pas passé le fichier au correcteur ortho. / au checker / pas utilisé dans 
l'appli. car je n'ai pas pu compiler kde, ...

7. Attendre

8. Répercuter ou non les remarques du relecteur (dans ce cas aller au 6). Si 
aucune remarques importantes n'est signalées, le fichier est commité directement.

Si on est mainteneur d'un fichier, on peut envoyer plusieurs mise à jours. La 
relecture se fera toujours sur le dernier fichier commité, les modifications 
seront fusionnées.


# V.5 # Quel est le processus de relecture ?
-----------------------------------------

0 - Bien entendu, installer la version de KDE que l'on traduit avant toute chose

1 - Réserver le fichier en copiant le courrier présent dans la boîte aux lettres 
dans un répertoire à vous (généralement votre nom) sur le serveur IMAP.

2 - Lancer check_doc_po pour vérifier l'orthographe (ispell) et notre
autocorrection (les règles d'ortho + le dico de kword). Si check_doc_po
détecte des erreurs "en trop", _ne pas_ corriger.

3 - Lancer check_gui_texts pour vérifier que les éléments de menus, les
messages et autres éléments de l'interface utilisateur correspondent bien
entre la doc et l'application. Si au passage on découvre que l'erreur est
aussi en anglais, le noter dans un coin de fichier pour envoyer en bloc à
l'équipe anglophone. Ne pas tenter de corriger l'erreur par le biais de la
traduction.

4 - Ouvrir khelpcenter et l'application en même temps, et relire la doc
Ne pas ouvrir la doc dans le fichier po ni dans le fichier  docbook :
uniquement dans le centre d'aide ! Vérifier au passage que les copies d'écran
sont traduites. Sinon, les  effectuer :
	- Image semblable à l'original, de même nom
	- Résolution 24 bits (mais 16 sont très bien)
	- Enregistrement png
	- Thème Keramik, couleurs par défaut
	- Tenir compte du texte pour faire la capture.
Ne pas modifier le texte de la doc s'il est difficile ou impossible de faire
une capture d'écran qui correspond, mais le noter dans un coin de fichier, pour
l'envoyer en bloc à l'équipe anglophone.

5 - À la fin, fournir au committeur qui distribuera :
        . la liste des erreurs dans le po de l'application
        . la liste des erreurs de la version anglaise
        . la liste des erreurs dans le po de la documentation




=================================================================================
[VI] Outils connexes
=================================================================================


# VI.1 # checker
----------------

Aller sur ftp.i18n.kde.org/teams/fr/tools/checker.tgz pour récupérer l'archive et 
décompressez-la dans un répertoire (/opt/checker par exemple).

Pour utiliser cet outils, il suffit de lancer :
| $ /opt/checker/check_gui_po kdeutils/kcalc.po
pour une application,
| $ /opt/checker/check_doc_po docs/kdeutils/kcalc.po
pour une documenation, ou encore
| $ /opt/checker/check_gui_po kdeutils/*.po
pour contrôler tous les fichiers d'un répertoire.

Si la correction orthographique vous gènes, vous pouvez l'enlever en ajoutant 
le paramètre --no-ispell.
Consultez l'aide en ligne d'ortho pour connaître d'autre paramètres disponibles.

# VI.2 # ispell
--------------



# VI.3 # cvs
------------
D'abord il vous faut installer le client cvs (archive appelée cvs-**). Vous pouvez
éventuellement installer une interface graphique comme cervisia.

1. Définition du serveur CVS :
$> export CVSROOT=:pserver:<nom>@cvs.kde.org:/home/kde

Remplacer <nom> par votre nom de connexion.

2. Connexion au serveur :
$> cvs login
puis saisissez votre mot de passe.

3. Récupération du référenciel :
$> cvs co kde-i18n/fr
$> cvs co kde-i18n/templates
$> cvs co -l kde-i18n

4. Récupération de fichiers nécessaires :
$> cvs co kde-common
$> cd kde-i18n
$> ln -s ../kde-common/admin

5. Metter à jour les fichiers
$> cvs up


Les 4 premières étapes ne sont nécessaires d'être effectuées qu'une seule fois.

# V1.4 # anoncvs
----------------
L'utilisation du CVS anonyme est identique au CVS normal. Seul le compte change:

$> export CVSROOT=:pserver:anonymous@anoncvs.kde.org:/home/kde
$> cvs login
le mot de passe est vide, il suffit d'appuyer sur la touche entrée pour valider
l'ouverture de la session.

# VI.5 # cvsup
--------------
1. Créer un fichier param.cvsup contenant :
*default host=cvsup.kde.org
*default base=~/kde-traduc/3_2_BRANCH
*default prefix=~/kde-traduc/3_2_BRANCH
*default release=cvs
*default delete
*default compress
*default tag=KDE_3_2_BRANCH
*default use-rel-suffix
kde-common
kde-i18n

2. Créer un fichier refuse dans le répertoire où vous désirez récupérer les
fichiers du CVS (par exemple : ~/kde-traduc/sup) :
kde-i18n/af/*
... plein de trucs... :)
kde-i18n/ven/*

3. Récupérer les fichiers :
$> cvsup param.cvsup

# VI.6 # webcvs
---------------
webcvs est une interface HTML qui permet de parcourir l'arborescence du répertoire
de référence de CVS. L'URL pour nos traductions est :
http://webcvs.kde.org/cgi-bin/cvsweb.cgi/kde-i18n/

Vous pouvez voir les différences entre deux versions d'une traduction, récupérer 
une version d'uen traduction, ...

=================================================================================
[VII] KDE-France
=================================================================================

L'équipe KDE francophone.

