<para>La fenêtre principale de &kturtle; comprend deux parties principales: <link linkend="the-code-editor">l'éditeur de code</link> (3) sur la gauche où vous saisissez les commandes &logo; et <link linkend="the-canvas">le canevas</link> (4) sur la droite où les instructions sont visualisées. <link linkend="the-canvas">Le canevas</link> est la cour de récréation de la tortue, c'est sur le canevas que la tortue se déplace et dessine. Les trois autres lieux sur la fenêtre principale sont: <link linkend="the-menubar">la barre de menus</link> (1) de laquelle toutes les actions peuvent se faire, <link linkend="the-toolbar">la barre d'outils</link> (2) qui vous permet de sélectionner rapidement les actions les plus utilisées et <link linkend="the-statusbar">la barre d'état</link> (5) qui vous fournit des informations sur l'état de &kturtle;.</para>
<para>Dans l'éditeur de code vous tapez les commandes &logo;. Il a toutes les caractéristiques que vous attendez d'un éditeur moderne. La plupart de ses caractéristiques se trouvent dans les menus <link linkend="the-edit-menu">Éditer</link> et <link linkend="the-tools-menu">Outils</link>. L'éditeur de code peut être accroché de chaque côté de la fenêtre principale ou il peut se détacher pour être placé n'importe où sur votre bureau.</para>
<para>Il existe plusieurs façons d'introduire du code dans l'éditeur. Le moyen le plus facile est d'utiliser un exemple déjà codé. Pour cela, allez dans <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Ouvrir les exemples</guimenuitem></menuchoice> dans le <link linkend="the-file-menu">menu Fichier</link> et cliquez sur un fichier. Le nom du fichier va vous indiquer ce qu'illustre l'exemple (par exemple <filename>carré.logo</filename> va dessiner un carré). Le fichier que vous avez choisi va être ouvert dans <link linkend="the-code-editor">l'éditeur de code</link>, vous pouvez ensuite exécuter le code avec <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Exécuter les commandes</guimenuitem></menuchoice>.</para>
<para>Vous pouvez ouvrir des fichiers &logo; en choisissant <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Ouvrir...</guimenuitem></menuchoice>.</para>
<para>Le troisième moyen est de saisir directement votre propre code dans l'éditeur ou encore de le copier/coller depuis ce manuel. </para>
<para>La position du curseur est indiquée dans <link linkend="the-statusbar">la barre d'état</link>, sur la droite, avec le numéro de ligne et le numéro de colonne. </para>
<para>Le canevas est la partie où les commandes sont visualisées, où les commandes <quote>dessinent</quote> une image. En d'autres mots, c'est l'aire de jeu de la tortue. Après avoir mis du code dans <link linkend="the-code-editor">l'éditeur de code</link>, et après l'avoir exécuté avec <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Exécuter les commandes</guimenuitem></menuchoice>, deux choses peuvent se produire: soit le code s'exécute sans erreur et vous verrez sûrement un changement sur le canevas, soit il y a une erreur dans votre code, un message va s'afficher vous disant quelle erreur vous avez faite.</para>
<para>Ce message devrait vous aider à résoudre votre erreur.</para>
<para>L'image qui est dessinée peut être enregistrée comme une image (en utilisant <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Enregistrer le canevas</guimenuitem></menuchoice>) ou imprimée (en utilisant <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Imprimer...</guimenuitem></menuchoice>).</para>
<para>Dans la barre de menus, vous trouverez toutes les actions de &kturtle;. Elles se trouvent dans les menus suivants: <guimenu>Fichier</guimenu>, <guimenu>Édition</guimenu>, <guimenu>Affichage</guimenu>, <guimenu>Outils</guimenu>, <guimenu>Configuration</guimenu> et <guimenu>Aide</guimenu>. Ce chapitre les décrit tous.</para>
<term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>E</keycap></keycombo> </shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Ouvrir les exemples...</guimenuitem> </menuchoice></term>
<listitem><para>Montre le contenu du dossier avec les programmes exemples de &logo;. Les exemples devraient être traduits dans votre langue favorite que vous pouvez choisir dans <menuchoice><guimenu>Configuration</guimenu><guimenuitem>Configurer &kturtle;...</guimenuitem></menuchoice>.</para></listitem>
<listitem><para>Présente une liste des vitesses d'exécution possibles: pleine vitesse, lent, plus lent et le plus lent. Lorsque la vitesse d'exécution est réglée sur «pleine vitesse» (valeur par défaut), vous pouvez difficilement vous rendre compte de ce qu'il se passe. Ce comportement est parfois voulu, mais il arrive que vous souhaitiez suivre l'exécution du programme. Dans ce cas, utilisez une vitesse d'exécution «lente», «plus lente» ou « la plus lente». Lorsqu'un des modes lents est choisi, la position actuelle dans le programme est affichée dans l'éditeur.</para></listitem>
<listitem><para>Avec cette action vous basculez sur le mode plein écran.</para>
<para>Note: lorsque le code est exécuté en mode plein écran tout est caché sauf le canevas. Cela permet d'écrire des programmes <quote>plein écran</quote> dans &kturtle;.</para></listitem>
<term><menuchoice><shortcut> <keycombo><keysym>F11</keysym></keycombo> </shortcut> <guimenu>Affichage</guimenu> <guimenuitem>Afficher les numéros de ligne</guimenuitem> </menuchoice></term>
<listitem><para>Cette action vous permet d'afficher les numéros de lignes dans l'éditeur de code. Ceci peut être très pratique pour trouver des erreurs.</para></listitem>
<term><menuchoice><shortcut> <keycombo>&Alt;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Outils</guimenu> <guimenuitem>Code de couleur</guimenuitem> </menuchoice></term>
<listitem><para>Cette action ouvre le dialogue de code de couleur. En l'utilisant, vous pouvez facilement sélectionner un <glossterm linkend="rgb">code de couleur</glossterm> et l'insérer dans <link linkend="the-code-editor">l'éditeur de code</link>.</para></listitem>
<listitem><para>Cette action <quote>indente</quote> (ajoute des espaces blancs au début) des lignes sélectionnées. Lorsque l'<quote>indentation</quote> est correctement utilisée, cela peut rendre le code bien plus facile à lire. Tous les exemples utilisent l'indentation, veuillez les regarder.</para></listitem>
<listitem><para>Cette action supprime l'<quote>indentation</quote> (supprime tous les espaces blancs au début) des lignes sélectionnées.</para></listitem>
<listitem><para>Cette action ajoute des caractères de commentaires (#) au début des lignes qui sont sélectionnées. Les lignes qui débutent déjà avec un caractère de commentaire sont ignorées lorsque l'action est exécutée. Les commentaires permettent au programmeur d'expliquer un peu son code et ils peuvent aussi être utilisés pour empêcher temporairement certaines parties du code d'être exécutées.</para></listitem>
<listitem><para>Ici vous pouvez changer les éléments que vous n'avez normalement pas à changer. Le menu de <guisubmenu>Configuration avancée</guisubmenu> comprend trois sous menus: <guimenuitem>Configurer l'éditeur...</guimenuitem> (la boîte de dialogue de configuration standard de l'éditeur &kate;), <guimenuitem>Configurer les raccourcis clavier...</guimenuitem> (la boîte de dialogue standard de configuration des raccourcis clavier de &kde;) et <guimenuitem>Configurer les barres d'outils...</guimenuitem> (la boîte de dialogue de configuration standard des barres d'outils de &kde;).</para></listitem>
<listitem><para>Ceci est utilisé pour configurer &kturtle;. Ici vous pouvez changer la langue des commandes &logo; ou fixer une nouvelle taille pour le canevas au prochain démarrage.</para></listitem>
<term><menuchoice><shortcut> <keycombo>&Maj;<keysym>F1</keysym></keycombo> </shortcut> <guimenu>Aide</guimenu> <guimenuitem>Qu'est ce que c'est? </guimenuitem> </menuchoice></term>
<listitem><para>Lorsque vous avez activé cette action, le curseur de la souris se change en un <quote>point d'interrogation</quote>. Lorsque celui-ci est utilisé pour cliquer sur des parties de la fenêtre principale de &kturtle;, une description de cette partie s'affiche.</para></listitem>
<listitem><para>Ceci est une fonction très utile: elle fournit de l'aide sur le mot-clé dans le code là où le curseur se trouve. Aussi, par exemple, vous avez utilisé la commande <userinput>imprimer</userinput> dans votre code et vous voulez lire dans le manuel ce qui est indiqué pour cette commande. Vous positionnez votre curseur sur la commande <userinput>imprimer</userinput> et vous appuyer sur <keysym>F1</keysym>. La page du manuel avec les informations sur la commande <userinput>imprimer</userinput> va s'afficher.</para>
<para>Cette fonction est très importante durant la phase d'apprentissage de la programmation.</para></listitem>
<term><menuchoice><guimenu>Aide</guimenu> <guimenuitem>Rapport de bogue...</guimenuitem> </menuchoice></term>
<listitem><para>Utilisez ceci pour rapporter aux développeurs un problème avec &kturtle;. Ces rapports peuvent être utilisés pour améliorer les versions futures de &kturtle;.</para></listitem>
<term><menuchoice><guimenu>Aide</guimenu> <guimenuitem>À propos de &kde;</guimenuitem> </menuchoice></term>
<listitem><para>Vos pouvez trouver ici des informations sur &kde;. Si vous ne savez pas déjà ce qu'est &kde;, ceci est un endroit que vous ne devez pas manquer!</para></listitem>
<para>Vous pouvez atteindre rapidement toutes les actions les plus utilisées à partir d'elle. Par défaut vous trouverez ici toutes les commandes principales avec pour finir les icônes de <guiicon>Exécuter les commandes</guiicon> et <guiicon>Arrêter l'exécution</guiicon>.</para>
<para>Vous pouvez configurer la barre d'outils en utilisant le menu <menuchoice><guimenu>Configuration</guimenu><guimenuitem>Configuration avancée</guimenuitem><guimenuitem>Configurer les barres d'outils...</guimenuitem></menuchoice></para>
<para>Sur la barre d'état vous trouverez des informations sur l'état de &kturtle;. Sur la partie gauche elle affiche l'état de la dernière action. Sur la partie droite vous trouverez l'endroit localisé du curseur (numéros de ligne et de colonne). Au milieu de la barre d'état est indiquée la langue actuellement utilisée pour les commandes.</para>
