summaryrefslogtreecommitdiffstats
path: root/tde-i18n-fr/docs/kdeedu/kturtle/getting-started.docbook
blob: 918ac3d5ed3a0cd826585000de7e750bb505d624 (plain)
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
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
<!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
     Thanks a lot in advance.-->
<chapter id="getting-started">
<title
>Démarrage rapide</title>
<para
>Lorsque vous démarrez &kturtle; vous allez voir quelque chose comme cela : <screenshot
> <screeninfo
>Voici une capture d'écran de &kturtle; lorsque vous le lancez pour la première fois</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>La fenêtre principale de &kturtle;</phrase
> </textobject
> </mediaobject
> </screenshot
> Dans ce démarrage rapide nous supposons que la langue des commandes &logo; est le français. Vous pouvez changer cette langue dans <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer &kturtle;...</guimenuitem
></menuchoice
> dans la section <guilabel
>Langue</guilabel
>. Soyez conscient que la langue que vous fixez ici pour &kturtle; est celle que vous utiliserez pour saisir les commandes &logo;.</para>

<sect1 id="first-steps">
<title
>Premières étapes avec le &logo; : faites connaissance avec la tortue !</title>
<para
>Vous avez remarqué que la tortue est au milieu du canevas : vous allez apprendre à la contrôler en utilisant des commandes dans l'éditeur de code.</para>

<sect2 id="the-turtle-moves">
<title
>La tortue bouge</title>
<para
>Commençons par faire bouger la tortue. Notre tortue peut faire trois sortes de mouvements, (1) elle peut avancer et reculer, (2) elle peut tourner à gauche et à droite et (3) elle peut aller directement à une position donnée sur l'écran. Vous pouvez essayer ceci par exemple :</para>
<para>
<screen
>avance 90
tournegauche 90 
</screen>
Vous pouvez soit saisir soit copier/coller ce code dans l'éditeur de code puis l'exécuter (en utilisant <link linkend="file-execute"
><menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Exécuter les commandes</guimenuitem
></menuchoice
></link
>) pour voir le résultat.</para>

<para
>Pendant que vous tapez ou copiez/collez et exécutez les commandes, vous pouvez noter les choses suivantes :</para>
<orderedlist>
<listitem
><para
>Que &mdash; après avoir exécuté les commandes &mdash; la tortue a avancé, a dessiné une ligne puis s'est tournée d'un quart de tour vers la gauche. Ceci est le résultat des commandes <link linkend="forward"
><userinput
>avance</userinput
></link
> et de <link linkend="turnleft"
><userinput
>tournegauche</userinput
></link
>.</para>
</listitem>
<listitem>
<para
>2. Que la couleur du code change pendant que vous le saisir : cette caractéristique est appelée <emphasis
>coloration syntaxique intuitive</emphasis
> &mdash; Différentes sortes de commandes sont colorées différemment. Ceci rend la lecture de grandes parties de code plus facile. Vous pouvez aussi détecter facilement des erreurs typographiques dans le cas où un mot n'est pas coloré.</para>
</listitem>
<listitem>
<para
>3. Que la tortue dessine une fine ligne noire.</para>
</listitem>
<listitem>
<para
>4. Peut-être avez-vous eu un message d'erreur. Cela peut vouloir dire deux choses : vous pouvez avoir fait une erreur en copiant les commandes ou vous n'avez pas fixé la langue qui correspond aux commandes &logo; (vous pouvez faire cela en choisissant <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer &kturtle;...</guimenuitem
></menuchoice
>, dans la section <guilabel
>Langue</guilabel
>).</para>
</listitem>
</orderedlist>

<para
>Vous avez certainement compris que <userinput
>avance 90</userinput
> dit à la tortue d'avancer de 90 pixels en dessinant une ligne et que <userinput
>tournegauche 90</userinput
> commande à la tortue de tourner vers la gauche de 90 <glossterm linkend="degrees"
>degrés</glossterm
>.</para>

<para
>Veuillez suivre les liens suivants vers le manuel de référence pour une explication complète des commandes introduites : <userinput
>avance</userinput
>, <userinput
>recule</userinput
>, <userinput
>tournegauche</userinput
> et <userinput
>tournedroit</userinput
>.</para>
</sect2>

<sect2 id="more-examples">
<title
>Plus d'exemples</title>
<para
>Le premier exemple était très simple, nous allons avancer un peu plus loin !</para>

<para>
<!--translators: if it's not already there, you can copy/paste the translated code below and save it in arrow.logo in your examples folder: tde-i18n/language-code/data/tdeedu/kturtle/ -->
<screen
>taillecanevas 200,200
couleurcanevas 0,0,0
couleurcrayon 255,0,0
taillecrayon 5
nettoietout

va 20,20
direction 135

avance 200
tournegauche 135
avance 100
tournegauche 135
avance 141
tournegauche 135
avance 100
tournegauche 45

va 40, 100
</screen>
Vous pouvez à nouveau saisir ou copier/coller le code dans l'éditeur de code ou aussi ouvrir le fichier <filename
>exemple1.logo</filename
> dans le dossier <guimenu
>Ouvrir les exemples</guimenu
> et l'exécuter (en utilisant <link linkend="file-execute"
><menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Exécuter les commandes</guimenuitem
></menuchoice
></link
>) pour voir le résultat. Pour l'exemple suivant, je supposerai que vous connaissez la procédure.</para>

<para
>Vous pouvez avoir noté que cet exemple utilise beaucoup plus de code. Vous y trouvez aussi de nouvelles commandes. Voici une courte explication des nouvelles commandes :</para>

<para
><userinput
>taillecanevas 200,200</userinput
> fixe la largeur et la hauteur du canevas à 200 <glossterm linkend="pixels"
>pixels</glossterm
> chacune. La largeur et la hauteur sont ici égales en taille ce qui signifie que le canevas est un maintenant un carré.</para>

<para
><userinput
>couleurcanevas 0,0,0</userinput
> fixe la couleur du canevas à noire. <userinput
>0,0,0</userinput
> est une <glossterm linkend="rgb"
>combinaison RGB</glossterm
> où toutes les valeurs sont mises à <userinput
>0</userinput
> ici ce qui donne un résultat de noir.</para>

<para
><userinput
>couleurcrayon 255,0,0</userinput
> fixe la couleur du crayon à rouge. <userinput
>255,0,0</userinput
> est une <glossterm linkend="rgb"
>combinaison RGB</glossterm
> où ici seule la valeur pour rouge est fixée au maximum à <userinput
>255</userinput
> pendant que les autres valeurs (vert et bleu) sont mises à <userinput
>0</userinput
>, ce qui résulte en un rouge brillant.</para>

<para
>Si vous ne comprenez pas les valeurs des couleurs, lisez le glossaire sur les <glossterm linkend="rgb"
>combinaison RGB</glossterm
></para>

<para
><userinput
>taillecrayon 5</userinput
> fixe la largeur (la taille) du crayon à <userinput
>5</userinput
> <glossterm linkend="pixels"
>pixels</glossterm
>. À partir de maintenant, chaque ligne que va dessiner la tortue aura une épaisseur de <userinput
>5</userinput
>, jusqu'à ce que nous changions à nouveau la valeur de <userinput
>taillecrayon</userinput
> pour une autre valeur.</para>

<para
><userinput
>nettoietout</userinput
> nettoie le canevas, c'est tout ce que cela fait.</para>

<para
><userinput
>va 20,20</userinput
> commande à la tortue d'aller à un certain endroit sur le canevas. Ceci est compté depuis le coin en haut à gauche, cet endroit est donc à 20 <glossterm linkend="pixels"
>pixels</glossterm
> depuis la gauche et 20 <glossterm linkend="pixels"
>pixels</glossterm
> depuis le haut du canevas. Veuillez noter que l'utilisation de la commande <userinput
>va</userinput
> ne dessinera pas de ligne.</para>

<para
><userinput
>direction 135</userinput
> fixe la direction de la tortue. Les commandes <userinput
>tournegauche</userinput
> and <userinput
>tournedroit</userinput
> changent l'angle de direction de la tortue en partant de sa direction actuelle. La commande <userinput
>direction</userinput
> change l'angle de direction de la tortue en partant toujours de zéro et donc ne dépend pas de la direction précédente de la tortue.</para>

<para
>Après la commande <userinput
>direction</userinput
> suivent beaucoup de commandes <userinput
>avance</userinput
> et <userinput
>tournegauche</userinput
>. Ces commandes font le dessin que vous voyez.</para>

<para
>Enfin, une autre commande <userinput
>va</userinput
> est utilisée pour bouger la tortue sur le côté.</para>

<para
>Veuillez vous assurez de suivre les liens vers la référence. La référence explique chaque commande plus en détails.</para>


</sect2>
</sect1>



<!--        EXTRA SECTIONS CAN BE ADDED TO THE "GETTING STARTED"

<sect1 id="calculations">
<title
>Simple Calculations</title>
<para>
Not yet written
</para>
</sect1>
<sect1 id="using_variables">
<title
>Using Variables: creating 'number containers'</title>
<para>
Not yet written
</para>
</sect1>
<sect1 id="using_strings">
<title
>Using strings: creating 'text containers'</title>
<para>
Not yet written
</para>
</sect1>
<sect1 id="logic">
<title
>Logic: asking the computer simple questions</title>
<para>
Not yet written
</para>
</sect1>
<sect1 id="recursion">
<title
>Recursion: the Turtle is using itself</title>
<para>
Draw a maze for example
</para>
</sect1>
-->


</chapter>