/usr/share/doc/kde/HTML/fr/kturtle/getting-started.docbook is in kde-l10n-fr 4:4.14.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 301 302 303 304 305 306 | <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
>&kturtle; tout juste démarré</phrase
> </textobject
> </mediaobject
> </screenshot
> Dans ce démarrage rapide, nous supposons que la langue des commandes &turtlescript; est le français. Vous pouvez modifier cette langue dans <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Langue du code</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 &turtlescript;, non la langue utilisé par &kde; sur l'ordinateur et utilisée pour afficher l'interface et les menus de &kturtle;.</para>
<sect1 id="first-steps">
<title
>Premières étapes avec le &turtlescript; : 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 (sauter) à une position donnée sur l'écran. Vous pouvez essayer ceci par exemple :</para>
<para>
<screen
>avance 90
tournegauche 90
</screen>
Saisissez ou copier / coller ce code dans l'éditeur puis exécutez-le (en utilisant <link linkend="run-execute"
><menuchoice
><guimenu
>Exécuter</guimenu
><guimenuitem
>Exécuter</guimenuitem
></menuchoice
></link
>) pour voir le résultat.</para>
<para
>Pendant que vous saisissez et exécutez les commandes comme celles ci-dessus dans l'éditeur, vous pouvez remarquer les choses suivantes :</para>
<orderedlist>
<listitem
><para
>après avoir exécuté les commandes, 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 <link linkend="turnleft"
><userinput
>tournegauche</userinput
></link
> ;</para>
</listitem>
<listitem>
<para
>la couleur du code change pendant que vous le saisissez : cette caractéristique est appelée <emphasis
>coloration syntaxique intuitive</emphasis
>. 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
>la tortue dessine une fine ligne noire ;</para>
</listitem>
<listitem>
<para
>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 de &turtlescript; (vous pouvez faire cela en choisissant <menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Langue du code</guisubmenu
></menuchoice
>).</para>
</listitem>
</orderedlist>
<para
>Vous avez certainement compris que <userinput
>avance 100</userinput
> dit à la tortue d'avancer en dessinant une ligne et que <userinput
>tournegauche 90</userinput
> demande à 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 nouvelles commandes : <link linkend="forward"
><userinput
>avance</userinput
></link
>, <link linkend="backward"
><userinput
>recule</userinput
></link
>, <link linkend="turnleft"
><userinput
>tournegauche</userinput
></link
>, et <link linkend="turnright"
><userinput
>tournedroite</userinput
></link
>.</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>
<screen
>initialise
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>
Encore une fois, vous pouvez saisir ou copier / coller le code dans l'éditeur ou aussi ouvrir le fichier exemple <filename
>flèche</filename
> dans le menu <guimenu
>Exemples</guimenu
> et l'exécuter (en utilisant <link linkend="run-execute"
><menuchoice
><guimenu
>Exécuter</guimenu
><guimenuitem
>Exécuter</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 remarqué que cet exemple utilise beaucoup plus de code. Vous y trouvez aussi de nouvelles commandes. Voici une courte explication des nouvelles commandes :</para>
<para
>Après avoir lancé la commande <userinput
>initialise</userinput
>, tout s'affiche comme si &kturtle; venait juste de démarrer.</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 RVB</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 RVB</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"
>combinaisons RVB</glossterm
></para>
<para
><userinput
>largeurcrayon 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
>largeurcrayon</userinput
> pour une autre valeur.</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
> et <userinput
>tournedroite</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 suivre les liens vers le manuel de référence. Celui-ci 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>
|