tde-i18n/tde-i18n-fr/docs/tdeedu/kturtle/getting-started.docbook

<!--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>