# Utiliser &kturtle;

Voici une capture d'écran de &kturtle; en action
Fenêtre principale de &kturtle;

La fenêtre principale de &kturtle; comprend trois parties principales : l'éditeur de code (3) sur la gauche où vous saisissez les commandes &turtlelang;, l'inspecteur (4) qui vous donne des informations à propos des variables quand le programme tourne et le canevas (5) sur la droite où les instructions sont affichées. Le canevas 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 : la barre de menus (1) de laquelle toutes les actions peuvent se faire, la barre d'outils (2) qui vous permet de sélectionner rapidement les actions les plus utilisées et la barre d'état (6) qui vous fournit des informations sur l'état de &kturtle;.

## L'éditeur de code

Dans l'éditeur de code, vous saisissez les commandes &turtlelang;. Il a toutes les fonctionnalités que vous attendez d'un éditeur moderne. La plupart de ses fonctionnalités se trouve dans les menus Édition et Outils. 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.

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 Fichier Exemples et cliquez sur un fichier. Le nom du fichier va vous indiquer ce qu'illustre l'exemple (par exemple `carré.logo` va dessiner un carré). Le fichier que vous avez choisi va être ouvert dans l'éditeur de code, vous pouvez ensuite exécuter le code avec Fichier Exécuter.

Vous pouvez ouvrir des fichiers &turtlelang; en choisissant Fichier Ouvrir....

Le troisième moyen est de saisir directement votre propre code dans l'éditeur ou encore de le copier / coller depuis ce manuel.

La position du curseur est indiquée dans la barre d'état, sur la droite, avec le numéro de ligne et le numéro de colonne.

## L'inspecteur

L'inspecteur vous donne des informations sur les variables, les fonctions que vous avez créées et l'arborescence du code pendant que le programme fonctionne.

L'inspecteur peut être attaché sur chaque bord de la fenêtre principale ou il peut être détaché et placé n'importe où sur votre bureau.

## Le canevas

Le canevas est la partie où les commandes sont affichées, où les commandes dessinent une image. En d'autres termes, c'est l'aire de jeu de la tortue. Après avoir mis du code dans l'éditeur de code, et après l'avoir exécuté avec Fichier Exécuter, 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 quelles erreurs vous avez faites.

Ce message devrait vous aider à résoudre votre erreur.

Vous pouvez zoomer en avant et en arrière sur le canevas avec la molette de la souris.

## La barre de menus

Dans la barre de menus, vous trouverez toutes les actions de &kturtle;. Elles se trouvent dans les menus suivants : Fichier, Édition, Affichage, Outils, Configuration et Aide. Ce chapitre les décrit tous.

### Le menu Fichier

&Ctrl;N Fichier Nouveau

  Crée un nouveau fichier &turtlelang; vide.

&Ctrl;O Fichier Ouvrir...

  Ouvre un fichier &turtlelang;.

Fichier Récemment ouvert(s)

  Ouvre un fichier &turtlelang; qui a récemment été ouvert.

Fichier Exemples

  Ouvre les programmes d'exemple de &turtlelang;. Les exemples sont dans votre langue natale que vous pouvez choisir dans Configuration Langue du code .

&Ctrl;S Fichier Enregistrer

  Enregistre le fichier &turtlelang; actuellement ouvert.

Fichier Enregistrer sous...

  Enregistre le fichier &turtlelang; actuellement ouvert vers un emplacement spécifique.

Fichier Enregistrer comme une image...

  Enregistre le canevas courant comme une image.

F5 Fichier Exécuter

  Démarre l'exécution des commandes dans l'éditeur de code.

F6 Fichier Pause

  Suspend l'exécution. Cette action n'est disponible que lorsque les commandes s'exécutent.

F7 Fichier Interrompre

  Arrête l'exécution. Cette action n'est disponible que lorsque les commandes s'exécutent.

Fichier Pleine vitesse

  Présente une liste des vitesses d'exécution possibles : Pleine vitesse, Lente, Plus lente, La plus lente et Pas à pas. 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, La plus lente. Lorsqu'un des modes lents est choisi, la position actuelle dans le programme est affichée dans l'éditeur. Pas à pas exécutera une commande à la fois.

&Ctrl;P Fichier Imprimer...

  Imprime le code courant dans l'éditeur

&Ctrl;Q Fichier Quitter

  Quitte &kturtle;.

### Le menu Édition

&Ctrl;Z Édition Annuler

  Annule la dernière modification dans le code. &kturtle; a un nombre de possibilités d'annulation infini !

&Ctrl;&Maj;Z Édition Refaire

  Refait une modification annulée dans le code.

&Ctrl;X Édition Couper

  Coupe le texte sélectionné de l'éditeur de code dans le presse-papiers.

&Ctrl;C Édition Copier

  Copie le texte sélectionné depuis l'éditeur de code dans le presse-papiers.

&Ctrl;V Édition Coller

  Colle le texte du presse-papiers sur l'éditeur.

&Ctrl;A Édition Tout sélectionner

  Sélectionne tout le texte depuis l'éditeur.

&Ctrl;F Édition Chercher...

  Grâce à cette action, vous pouvez trouver des mots dans le code.

F3 Édition Poursuivre la recherche

  Utiliser ceci pour trouver la prochaine occurrence du mot.

&Maj;F3 Édition Poursuivre la recherche

  Utiliser ceci pour trouver la prochaine occurrence de la phrase.

Inser Édition Écraser / Insérer

  Bascule entre les modes « Insérer » et « Écraser ».

### Le menu Affichage

&Ctrl;E Affichage Afficher l'éditeur

  Affiche ou cache l'éditeur de code.

&Ctrl;I Affichage Afficher l'inspecteur

  Affiche ou cache l'inspecteur.

Affichage Afficher les erreurs

  Affiche ou cache l'onglet Erreur avec la liste des erreurs qui provient du code en cours. Si cette option est activée, appuyez sur le Canevas pour afficher à nouveau la tortue.

F11 Affichage Afficher les numéros de ligne

  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.

### Le menu Outils

Outils Choisir la direction...

  Cette action ouvre une boîte de dialogue de choix de direction.

Outils Sélecteur de couleur...

  Cette action ouvre une boîte de dialogue de choix de couleur.

### Le menu Configuration

Configuration Langue du code

  Choisit la langue pour le code.

Configuration Afficher la barre d'outils...

  Affiche ou cache la barre d'outils

Configuration Afficher la barre d'état

  Affiche ou cache la barre d'état

Configuration Configurer les raccourcis clavier...

  Affiche une boîte de dialogue standard de &kde; pour configurer les raccourcis clavier.

Configuration Configurer les barre d'outils...

  Affiche une boîte de dialogue standard de &kde; pour configurer les barre d'outils.

### Le menu Aide

&help.menu.documentation;

## La barre d'outils

Vous pouvez ici atteindre rapidement toutes les actions les plus utilisées. Par défaut vous trouverez ici toutes les commandes principales avec les icônes Exécuter, Pause et Interrompre. Le dernier élément à la fin de la barre d'outils est le terminal, que vous pouvez utiliser pour saisir une ligne de commande et la tester.

Vous pouvez configurer la barre d'outils en utilisant Configuration Configurer la barre d'outils...

## La barre d'état

Dans la barre d'état, vous trouverez des informations sur l'état de &kturtle;. Sur la partie gauche, l'état de la dernière action est affiché. 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.