1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
|
<chapter id="translators">
<title
>Guide pour la traduction des fichiers de &kturtle;</title>
<para
>Comme vous le savez probablement déjà, la caractéristique unique du langage de programmation &logo; est que les commandes &logo; sont souvent traduites dans la langue du programmeur. Ceci casse une barrière pour certains apprenants pour comprendre les bases de la programmation. Lorsque &kturtle; est traduit dans une autre langue, quelques fichiers doivent être traduits en plus des chaînes traditionnelles de l'interface graphique et de la documentation. Ces fichiers sont générés automatiquement par les scripts de Rafael Beccar. Ces scripts se trouvent dans <userinput
>tdeedu/kturtle/scripts</userinput
>, et les fichiers à traduire se trouvent dans<userinput
>tdeedu/kturtle/data</userinput
>. Vous trouverez également dans ces dossiers des fichiers README qui contiennent des instructions pour les utiliser et les traduire. </para>
<sect1 id="make_directory">
<title
>Création d'un dossier pour accueillir les fichiers traduits</title>
<para
>Vous devez d'abord créer un dossier afin de stocker les fichiers traduits. Créez un dossier nommé <filename class="directory"
>tde-i18n/<replaceable
>code</replaceable
>/data/tdeedu/kturtle/</filename
> dans votre dossier CVS de KDE, ou <replaceable
>code</replaceable
> est le code de votre pays (le code <acronym
>ISO</acronym
> à deux ou quatre lettres). </para>
<para
>Copiez le fichier <filename
>Makefile.am</filename
> depuis <filename class="directory"
>tdeedu/kturtle/data/</filename
> dans ce dossier. Ouvrez-le avec votre éditeur de texte favori, remplacez toutes les instances de <quote
>en_US</quote
> dans le fichier par le code de votre pays (celui utilisé plus haut) et enregistrez le fichier. </para>
</sect1>
<sect1 id="commands_trans">
<title
>Comment traduire les mots-clés &logo;(commandes)</title>
<para>
<itemizedlist>
<listitem
><para
>Copiez le fichier <filename
>logokeywords.en_US.xml</filename
> depuis <filename class="directory"
>tdeedu/kturtle/data/</filename
> dans le dossier que vous venez juste de créer, en le renommant <filename
>logokeywords.<replaceable
>code</replaceable
>.xml</filename
> où <replaceable
>code</replaceable
> est le code ISO de votre pays (le code <acronym
>ISO</acronym
> de 2 ou 4 lettres). </para>
</listitem>
<listitem
><para
>Traduisez le contenu de la balise <sgmltag class="starttag"
>keyword</sgmltag
> (par exemple l'information entre <sgmltag class="starttag"
>keyword</sgmltag
> et <sgmltag class="endtag"
>keyword</sgmltag
>) dans votre langue chaque fois que c'est possible. Traduisez aussi le contenu de la balise <sgmltag class="starttag"
>alias</sgmltag
>, (par exemple l'information entre <sgmltag class="starttag"
>alias</sgmltag
> et <sgmltag class="endtag"
>alias</sgmltag
>) : ils sont utilisés comme raccourcis pour le mot clé.</para>
<para
>Traduisez par exemple <quote
>while</quote
> dans : <sgmltag class="starttag"
>keyword</sgmltag
>while<sgmltag class="endtag"
>keyword</sgmltag
> </para>
<para
>Merci de ne rien traduire d'autre et veuillez ne pas traduire les mots anglais dans <sgmltag class="starttag"
>command name="mot_anglais"</sgmltag
>. Ceux-ci doivent rester en anglais. </para>
<para
>Dernière chose : ne modifiez pas l'ordre dans ce fichier, ceci est nécessaire pour le script de génération automatique de traduction de Rafael Beccar. </para>
</listitem>
<listitem
><para
>Enregistrez votre fichier avec l'encodage <acronym
>UTF-8</acronym
> (dans &kate;, utilisez <guimenuitem
>Enregistrer sous...</guimenuitem
> et assurez-vous d'avoir <guilabel
>utf8</guilabel
> dans la boîte déroulante à droite du nom de fichier). </para>
</listitem>
<listitem
><para
>Faites un commit de votre fichier (ajouter le nom de fichier dans le fichier <filename
>Makefile.am</filename
>) ou envoyez-le à Anne-Marie. </para>
</listitem>
<listitem
><para
>En cas de doute, merci de contacter Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> pour plus d'information.</para>
</listitem>
</itemizedlist>
</para>
</sect1>
<sect1 id="examples_syntax">
<title
>Comment traduire les fichiers de coloration syntaxique</title>
<para
>Traduire le fichier <filename
>logohighlightstyle.en_US.xml</filename
> est simple comme bonjour en utilisant le script de Rafael Beccar dans <filename class="directory"
>tdeedu/kturtle/data/</filename
>. Nous vous recommandons de lire le fichier README qui se trouve dans ce dossier. </para>
<para
>Pour des raisons de compatibilité descendante avec toutes les personnes qui ne souhaitent pas utiliser les bienfaits du scripts perl mentionné au paragraphe précédent, voici la vieille méthode pour y parvenir : <itemizedlist>
<listitem
><para
>Copiez le fichier <filename
>logohighlightstyle.en_US.xml</filename
> depuis <filename class="directory"
>tdeedu/kturtle/data/</filename
> dans le dossier que vous avez créé pour accueillir les fichiers de mots clés traduits, et renommez-le <filename
>logohighlightstyle.<replaceable
>code</replaceable
>.xml</filename
> où <replaceable
>code</replaceable
> est le code de votre pays (le code <acronym
>ISO</acronym
> de 2 ou 4 lettres). </para>
</listitem>
<listitem
><para
>À la ligne 4 du fichier, se trouvent les mots suivants : <sgmltag class="starttag"
>language name="en_US"</sgmltag
>... : vous changez ici <quote
>en_US</quote
> pour mettre le code <acronym
>ISO</acronym
> de votre pays (2 ou 4 lettres). </para
></listitem>
<listitem
><para
>Traduisez ensuite dans votre langue le contenu des balises <sgmltag class="starttag"
>item</sgmltag
> (par exemple l'information contenue entre <sgmltag class="starttag"
>item</sgmltag
> et <sgmltag class="endtag"
>item</sgmltag
>). Cette traduction doit correspondre à celle du fichier <filename
>logokeyword</filename
>. Par exemple traduisez <quote
>while</quote
> dans : <sgmltag class="starttag"
>item</sgmltag
> while <sgmltag class="endtag"
>item</sgmltag
> et laissez les espaces blancs tels qu'ils sont à l'origine (un au début, un à la fin). Merci de ne rien traduire d'autre. </para
></listitem>
<listitem
><para
>Enregistrez votre fichier avec l'encodage <acronym
>UTF-8</acronym
> (dans &kate;, utilisez <guimenuitem
>Enregistrer sous...</guimenuitem
> et assurez-vous d'avoir <guilabel
>utf8</guilabel
> dans la boîte déroulante à droite du nom de fichier). </para
></listitem>
<listitem
><para
>Faites un commit de votre fichier (ajouter le nom de fichier dans le fichier <filename
>Makefile.am</filename
>) ou envoyez-le à Anne-Marie. </para
></listitem>
<listitem
><para
>En cas de doute, merci de contacter Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> pour plus d'information. </para
></listitem>
</itemizedlist>
</para>
</sect1>
<sect1 id="examples_trans">
<title
>Comment traduire les exemples</title>
<para
>Encore une fois cette tâche est grandement simplifiée par le script de Rafael Beccar dans <filename class="directory"
>tdeedu/kturtle/data/</filename
>. Lisez le fichier README dans ce dossier, puisqu'il reste des choses à faire après la traduction automatique des fichiers d'exemple logo. </para>
<para
>Une fois que vous avez suivi les isntructions, données dans le fichier README que vous avez trouvé dans le dossier des scripts, vous devriez être prêt maintenant. N'oubliez pas de tester le code logo de l'exemple traduit, il arrive souvent qu'une erreur s'y soit glissée. Assurez-vous également que le fichier <userinput
>Makefile.am</userinput
> dans <filename class="directory"
>tde-i18n/<replaceable
>code</replaceable
>/data/tdeedu/kturtle/</filename
> est bien mis à jour par rapport aux nouveaux fichiers. Pour le français, le fichier <userinput
>Makefile.am</userinput
> devrait ressembler à ceci : <screen
>txt_DATA = triangle.logo carre.logo enroule.logo exemple1.logotxtdir = $(kde_datadir)/kturtle/examples/fr_FRxml_DATA = logohighlightstyle.fr_FR.xmlxmldir = $(kde_datadir)/katepart/syntaxkeywords_DATA = logokeywords.fr_FR.xmlkeywordsdir = $(kde_datadir)/kturtle/dataEXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA)
</screen
>
</para>
<para
>Voici une description sur la façon de traduire SANS utiliser les scripts perl de Rafael : <itemizedlist>
<listitem
><para
>Copiez les exemples anglais dans depuis <filename class="directory"
>tdeedu/kturtle/data/</filename
> dans le dossier que vous avez utilisé pour stocker les fichiers de mots clés et de coloration syntaxique traduits. Traduisez les noms de fichiers dans votre dossier : Cela va permettre aux utilisateurs de comprendre facilement et rapidement ce qu'est l'exemple.</para>
</listitem>
<listitem
><para
>Traduisez les mots clés dans les exemples, en utilisant ceux de <filename
>logokeywords.xml</filename
> pour votre langue. Les fichiers de mots clés doit être traduit avant les exemples.</para>
</listitem>
<listitem
><para
>Enregistrez votre fichier avec l'encodage <acronym
>UTF-8</acronym
> (dans &kate;, utilisez <guimenuitem
>Enregistrer sous...</guimenuitem
> et choisissez <guilabel
>utf8</guilabel
> dans le menu déroulant à droite du nom de fichier)</para>
</listitem>
<listitem
><para
>Faites un commit de votre dossier (ajoutez un fichier <filename
>Makefile.am</filename
> dedans) ou envoyez-le à Anne-Marie.</para>
</listitem>
<listitem
><para
>En cas de doute, merci de contacter Anne-Marie Mahfouf, <email
>annemarie.mahfouf@free.fr</email
> pour plus d'information.</para>
</listitem>
<listitem
><para
>Enfin, si vous le voulez, vous pouvez ajouter vos propres exemples dans ce dossier.</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>
|
