Getting translation strings right/fr: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		Cette page contient quelques notes sur la manière d'avoir dès le début les chaînes à traduire correctes, à l'usage de leurs auteurs originaux (le plus souvent des programmeurs).
2	2
3	3		Dans ce contexte, cela signifie que les chaînes à traduire ont été prévues pour une traduction facile. et que la version originale est adaptée aux exigences de base pour leur usage.
4	4
5	5		Bien que cette page essaie d'être neutre par rapport au langage initial, elle est en fait légèrement orientée vers l'anglais. Vous êtes libre de compléter, ou d'ignorer ce qui ne s'applique pas à votre situation, et éventuellement de mettre à jour la page.
6	6
7	7		### Généralités
8	8
9	9		Pour éviter des problèmes, assurez-vous en premier lieu que les chaînes originales sont correctes. Il y a plusieurs raisons de les vérifier :
10	10
11	11		- Les chaînes originales sont habituellement employées comme traduction par défaut, et cela peut donner une mauvaise impression à l'utilisateur final s'il lui arrive de tomber sur des chaînes fautives.
12	12		- Au pire, cela rendra inutilement difficile le travail du traducteur. Se rappeler le principe "Garbage in, garbage out", qui s'applique parfaitement ici.
13	13
14	14		Essayez donc de vous assurer que votre orthographe est correcte. Consultez un dictionnaire si vous n'êtes pas sûr de vos compétences en la matière.
15	15
16	16		Utilisez des expressions compréhensibles, d'utilisation courante et de manière cohérente. Si vous avez des doutes, essayez de mettre d'autres programmes dans la même situation et d'examiner leurs réponses. Les fichiers de documentation et d'aide sont souvent un bon modèle pour les expressions ou termes particuliers. Essayez d'être cohérent dans le choix des expressions. Par exemple, les questions :
17	17
18		-	~~`Supprimer le dossier ?`\~~
19		-	~~`Effacer le dossier ?`\~~
20		-	~~`Enlever le dossier ?`\~~
21		-	~~`Retirer le dossier ?`~~
	18	+	```text
	19	+	Supprimer le dossier ?
	20	+	Effacer le dossier ?
	21	+	Enlever le dossier ?
	22	+	Retirer le dossier ?
	23	+	```
22	24
23	25		ont toutes une signification semblable, mais si elles sont échangées sans raison apparente, le lecteur peut en faire des interprétations étranges. Les traducteurs sont particulièrement enclins à cette erreur, puisqu'ils ne connaissent souvent pas le contexte exact d'un message : ils peuvent interpréter de simples variations de vocabulaire comme l'indication de différences importantes, et par conséquent être tentés de choisir une mauvaise traduction.
24	26
25	27		Particulièrement pour des messages d'erreur destinés à l'utilisateur, essayez de décrire le problème avec les mots appropriés. Ce n'est jamais l'état du programme qui a mené au message d'erreur (ceci est seulement utile au programmeur, mais pas à l'utilisateur). Sinon, les utilisateurs vont soit hausser les épaules en ignorant les messages (dans le meilleur cas), soit choisir un autre programme (dans le pire des cas) : l'utilisateur ne pourra pas résoudre le problème et continuer son travail, et tout cela parce que le programme n'en aura pas donné une description appropriée.
26	28
27	29		Donnez une description compréhensible. N'essayez pas d'impressionner vos utilisateurs avec des mots étrangers ou très techniques, juste pour dire que le travail en cours n'a pas encore été enregistré.
28	30
29	31		Essayez particulièrement d'éviter des négations multiples dans un message : elles sont presque toujours plus difficiles à lire que leurs équivalents positifs. Exemple :
30	32
31		-	~~`Ce composant ne peut pas être déposé sur des contrôles non visuels.`~~
	33	+	```text
	34	+	Ce composant ne peut pas être déposé sur des contrôles non visuels.
	35	+	```
32	36
33	37		Sous sa forme non-niée :
34	38
35		-	~~`Ce composant peut seulement être déposé sur des contrôles visuels.`~~
	39	+	```text
	40	+	Ce composant peut seulement être déposé sur des contrôles visuels.
	41	+	```
36	42
37	43		La dernière formulation est sans doute plus facile à lire et à comprendre.
38	44
39	45		### Questions techniques
40	46
41	47		Dans cette section, nous donnons une vue d'ensemble des questions techniques, tout particulièrement des possibilités existantes. Celles-ci incluent la construction de resourcestring, GNU gettext() et la fonction format().
42	48
43	49		#### Resourcestrings, et GNU gettext
44	50
45	51		Free Pascal dispose de quelques fonctions de langue intégrées de manière à manipuler les chaînes. Il y a une section spéciale d'une unité appelée "resourcestring" qui a été spécifiquement étudiée pour cette raison. Voir la section appropriée du manuel de FPC (prog.pdf, pg. 89ff ou [ici](http://www.freepascal.org/docs-html/prog/progch9.html#x184-1870009)) pour les détails.
46	52
47	53		GNU gettext est un ensemble spécial d'utilitaires pour fournir des traductions de vos programmes : voir le manuel de FPC une fois de plus (prog.pdf, pg. 91ff ou [ici](http://www.freepascal.org/docs-html/prog/progse41.html#x210-2130009.4)).
48	54
49	55		Note: GNU gettext a une faille conceptuelle qui ne permet pas de faire correspondre une chaîne originale simple à de multiples chaînes traduites.
50	56
51	57		#### ResourceStrings dans l'IDE
52	58
53	59		- Lazarus a un outil pour créer facilement des chaînes de ressources. Voir [[IDE Window: Make ResourceString/fr\|Faire des ResourceStrings]]
54	60
55	61		- Pour chaque section resourcestring, FPC crée un fichier .rst, mais il n'y a aucun éditeur pour ces fichiers. Lazarus peut automatiquement créer un fichier .po du fichier .rst. Il y a beaucoup d'outils d'édition de fichier .po (par exemples: kbabel et poEdit).
56	62
57	63		Pour créer les fichiers .po pour un paquet, opérez ainsi :
58	64
59		-	~~` * Créez un sous-répertoire ``languages`` (ou ``locale``, ou autre chose) ;`\~~
60		-	~~` * Ouvrez le composant. Puis Options -> Intégration de l'EDI -> Répertoire des fichiers ``.po`` que vous fixerez à ``languages`` (ou tout répertoire adapté).`~~
	65	+	```text
	66	+	* Créez un sous-répertoire languages (ou locale, ou autre chose) ;
	67	+	* Ouvrez le composant. Puis Options -> Intégration de l'EDI -> Répertoire des fichiers .po que vous fixerez à languages (ou tout répertoire adapté).
	68	+	```
61	69
62	70		La prochaine fois que vous compilerez le paquet, l'EDI créera les fichiers .po. Note: Les fichiers .rst doivent appartenir aux unités de paquet. Sinon, l'EDI ignore les autres fichiers .rst.
63	71
64	72		Le même fonctionnement pour des projets. Le répertoire est placé dans projet -\> Options du Projet -\> i18n -\> Répertoire des fichiers .po.
65	73
66	74		- Pour créer une traduction allemande : copier le fichier unit1.po vers unit1.de.po. Employer alors un éditeur de texte ou un éditeur de fichier .po pour traduire toutes les chaînes.
67	75
68	76		- L'IDE chargera automatiquement des fichiers .po pour les composants installés, s'ils existe. Par exemple voir lazarus/components/projecttemplates/languages/.
69	77
70	78		- ToDo: Implémenter et documenter la mise à jour du fichier .po traduit quand de nouvelle resourcestrings sont ajoutés .
71	79
72	80		- ToDo: Implémenter et documenter rassemblement de tous les fichiers .po des paquets statiquement liés .
73	81
74	82		#### ResourceStrings dans votre application
75	83
76	84		Vous pouvez charger les fichiers .po à l'initialisation pour traduire les resourcestrings. Ajoutez ceci à votre fichier .lpr:
77	85
78	86		``` pascal
79	87		...
80	88		uses
81	89		...
82	90		Translations, gettext;
83	91
84	92		procedure TranslateLCL;
85	93		var
86	94		PODirectory, Lang, FallbackLang: String;
87	95		begin
88	96		PODirectory:='/path/to/lazarus/lcl/languages/';
89	97		Lang:='';
90	98		FallbackLang:='';
91	99		GetLanguageIDs(Lang,FallbackLang); // in unit gettext
92	100		Translations.TranslateUnitResourceStrings('LCLStrConsts',
93	101		PODirectory+'lclstrconsts.%s.po',Lang,FallbackLang);
94	102		// ... add here a TranslateUnitResourceStrings call for every po file ...
95	103		end;
96	104
97	105		begin
98	106		TranslateLCL;
99	107		Application.Initialize;
100	108		Application.CreateForm(TForm1, Form1);
101	109		Application.Run;
102	110		end.
103	111		```
104	112
105	113		#### La fonction format()
106	114
107	115		Pour ne pas utiliser des chaînes complètement statiques dans les traductions, vous pouvez employer la méthode [[doc:rtl/sysutils/format.html\|format()]] dans l'unité sysutils. Il peut remplacer des paramètres donnés dans un texte par leur valeur réelle donnée comme paramètre secondaire dans un ensemble. Exemple:
108	116
109	117		``` pascal
110	118		format('Demain %0:s il y aura du %1:s.', ['dimanche', 'soleil']);
111	119		```
112	120
113	121		restituant Demain dimanche il y aura du soleil. Dans ce cas-ci %0:s est un paramètre pour le premier (index 0) argument dans l'ensemble de valeurs réelles (Soleil), et de même %1:s. Pour une définition exacte des paramètres permis et leur syntaxe voir le manuel de référence de FPC.
114	122
115	123		Quelques directives pour l'utilisation de la fonction format()
116	124
117	125		- Essayer d'employer des paramètres classés dans les chaînes originales, même si ils sont facultatifs. Une fois utilisé, ils permettent au traducteur de déplacer les paramètres facilement dans la phrase lui permettant des expressions plus normales(en déplaçant réellement les paramètres dans la phrase vous pouvez créer des phrases appropriées dans cette langue).
118	126
119	127		- Ne jamais composer une phrase de plus d'une chaine. Employer toujours la méthode format() à partir de l'unité sysutils pour construire la chaine correcte en utilisant des paramètres pendant le temps d'exécution. Les traducteurs ne pourront habituellement pas reconstruire la phrase entière, donc incapable de donner une bonne traduction; considérer seulement qu'il y a souvent des centaines de chaînes dans une base de données de traduction...
120	128
121	129		- Ne pas composer en utilisant des espaces. Déplacer simplement votre Label à la position appropriée en premier lieu. Il peut y avoir des problèmes avec des changements de police, et les espaces apparemment superflus seront difficile à équilibré par le traducteur.
122	130
123	131		~~Note: Puisque format() n'interprète pas les caractères d'échappements (par exemple C's "\n", "\t", etc) et GNU gettext pour toute ses raisons étant le système de traduction de choix (et ses outils ne pouvant pas interpréter non plus les caractères d'échappements), on exige aux programmeurs d'insérer les coupures de ligne.~~Dans la version courante de Lazarus, "\n" et "\t" dans les chaines traduites sont remplacés par le caractère nouvelle ligne et tabulation.
124	132
125	133		#### Convertir le jeu de caractères d'une traduction
126	134
127	135		Par exemple : convertir un fichier de ISO-8859-1 à UTF-8:
128	136
129		-	~~` iconv --from-code=ISO-8859-1 --to-code=UTF-8 ancienfichier.po > nouveaufichier.po`~~
	137	+	```text
	138	+	iconv --from-code=ISO-8859-1 --to-code=UTF-8 ancienfichier.po > nouveaufichier.po
	139	+	```
130	140
131	141		Ne pas oublier de changer la ligne
132	142
133		-	~~` "Content-Type: text/plain; charset=ISO-8859-1\n"`~~
	143	+	``` pascal
	144	+	"Content-Type: text/plain; charset=ISO-8859-1\n"
	145	+	```
134	146
135	147		par
136	148
137		-	~~` "Content-Type: text/plain; charset=UTF8\n"`~~
	149	+	``` pascal
	150	+	"Content-Type: text/plain; charset=UTF8\n"
	151	+	```
138	152
139	153		### Particularités liées à l'anglais
140	154
141	155		Cette section contient les notes qui s'appliquent en particulier quand l'anglais est la langue originale :
142	156
143	157		- Veillez à réserver assez d'espace pour les textes : en anglais les textes sont presque toujours plus courts (en caractères) que leurs traductions. Prévoyez donc assez d'espace. L'expérience prouve que les chaînes très courtes (quelques caractères) doublent souvent de taille; ce rapport diminue pour les chaînes plus longues.
144	158
145	159		- Évitez les abréviations en anglais; en plus du fait que ceci raccourcit encore des chaînes déjà courtes, il y a des problèmes graves avec, par exemple, les langues qui emploient les caractères idéographiques, où ces abréviations n'existent pas.
146	160
147	161		- Puisque c'est souvent une question : Dans les signes de ponctuation anglaise (point, virgule, ...) font partie des mots précédents. Particulièrement après un point-virgule il devrait toujours y avoir un espace. La lecture est plus difficile quand la ponctuation est erronée.
148	162
149		-	~~`There was an error!Please check file settings,compiler settings,...to fix this issue.`~~
	163	+	```text
	164	+	There was an error!Please check file settings,compiler settings,...to fix this issue.
	165	+	```
150	166
151	167		Considérez aussi que les algorithmes prévus pour couper les lignes trop longue provoqueront probablement une coupure arbitraire s'il n'y a pas d'espaces.
152	168
153		-	~~`There was an error! Please check file settings, compiler settings, ... to fix this issue.`~~
	169	+	```text
	170	+	There was an error! Please check file settings, compiler settings, ... to fix this issue.
	171	+	```
154	172
155	173		Avec des espaces le résultat sera meilleur.
156	174
157	175		---
158	176		From the Free Pascal wiki, page "Getting translation strings right/fr", as it stood on 2020-02-16 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history