# Utiliser &kturtle;

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

La fenêtre principale de &kturtle; comprend deux parties principales : l'éditeur de code (3) sur la gauche où vous saisissez les commandes &logo; et le canevas (4) sur la droite où les instructions sont visualisé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 (5) qui vous fournit des informations sur l'état de &kturtle;.

## L'éditeur de code

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 Éditer 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 Ouvrir les exemples dans le menu Fichier 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 les commandes.

Vous pouvez ouvrir des fichiers &logo; 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.

## Le canevas

Le canevas est la partie où les commandes sont visualisées, où les commandes dessinent une image. En d'autres mots, 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 les commandes, 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.

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

L'image qui est dessinée peut être enregistrée comme une image (en utilisant Fichier Enregistrer le canevas) ou imprimée (en utilisant Fichier Imprimer...).

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

#### Nouveau

&Ctrl;N Fichier Nouveau

  Crée un nouveau fichier &logo; vide.

#### Ouvrir

&Ctrl;O Fichier Ouvrir...

  Ouvre un fichier &logo;.

#### Récemment ouvert(s)

Fichier Récemment ouvert(s)

  Ouvre un fichier &logo; qui a déjà récemment été ouvert.

#### Ouvrir les exemples

&Ctrl;E Fichier Ouvrir les exemples...

  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 Configuration Configurer &kturtle;....

#### Enregistrer

&Ctrl;S Fichier Enregistrer

  Enregistre le fichier &logo; actuellement ouvert.

#### Enregistrer sous

Fichier Enregistrer sous...

  Enregistre le fichier &logo; actuellement ouvert sous un nom spécifique.

#### Enregister le canevas

Fichier Enregistrer le canevas...

  Enregistre l'image sur le canevas dans un format image.

#### Vitesse d'exécution

Fichier Vitesse d'exécution

  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.

#### Exécuter les commandes

&Alt;Retour Fichier Exécuter les commandes

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

#### Pause

Échap Fichier Suspendre l'exécution

  Suspend l'exécution. Cette action n'est disponible que lorsque les commandes sont en train de s'exécuter.

#### Arrêt

Échap Fichier Arrêter l'exécution

  Arrête l'exécution, cette action n'est disponible que lorsque les commandes sont en train de s'exécuter.

#### Imprimer

&Ctrl;P Fichier Imprimer...

  Imprime le code courant dans l'éditeur ou le dessin courant sur le canevas.

#### Quitter

&Ctrl;Q Fichier Quitter

  Quitte &kturtle;.

### Le menu Édition

&Ctrl;Z Édition Annuler

  Annule le dernier changement dans le code. &kturtle; a un nombre de possibilités d'annulation infini !

&Ctrl;&Maj;Z Édition Refaire

  Refait un changement annulé 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;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.

&Ctrl;R Édition Remplacer...

  Avec cette action vous pouvez remplacer des mots dans le code.

### Le menu Affichage

&Ctrl;&Maj;F Affichage Mode plein écran

  Avec cette action vous basculez sur le mode plein écran.

  Note : lorsque le code est exécuté en mode plein écran tout est caché sauf le canevas. Cela permet d'écrire des programmes plein écran dans &kturtle;.

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

&Alt;C Outils Code de couleur

  Cette action ouvre le dialogue de code de couleur. En l'utilisant, vous pouvez facilement sélectionner un code de couleur et l'insérer dans l'éditeur de code.

&Ctrl;I Outils Indenter

  Cette action indente (ajoute des espaces blancs au début) des lignes sélectionnées. Lorsque l'indentation est correctement utilisée, cela peut rendre le code bien plus facile à lire. Tous les exemples utilisent l'indentation, veuillez les regarder.

&Ctrl;&Maj;I Outils Désindenter

  Cette action désindente (supprime des espaces blancs au début) des lignes sélectionnées.

Outils Supprimer l'indentation

  Cette action supprime l'indentation (supprime tous les espaces blancs au début) des lignes sélectionnées.

&Ctrl;D Outils Commenter

  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.

&Ctrl;&Maj;D Outils Décommenter

  Cette action supprime les caractères de commentaire dans les lignes sélectionnées.

### Le menu Configuration

Configuration Afficher/Cacher la barre d'outils

  Bascule la barre d'outils

Configuration Afficher/Cacher la barre d'état

  Bascule la barre d'état

Configuration Configuration avancée

  Ici vous pouvez changer les éléments que vous n'avez normalement pas à changer. Le menu de Configuration avancée comprend trois sous menus : Configurer l'éditeur... (la boîte de dialogue de configuration standard de l'éditeur &kate;), Configurer les raccourcis clavier... (la boîte de dialogue standard de configuration des raccourcis clavier de &kde;) et Configurer les barres d'outils... (la boîte de dialogue de configuration standard des barres d'outils de &kde;).

Configuration Configurer &kturtle;...

  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.

### Le menu Aide

F1 Aide Manuel de &kturtle;

  Cette action affiche le manuel que vous êtes en train de lire.

&Maj;F1 Aide Qu'est ce que c'est ?

  Lorsque vous avez activé cette action, le curseur de la souris se change en un point d'interrogation. Lorsque celui-ci est utilisé pour cliquer sur des parties de la fenêtre principale de &kturtle;, une description de cette partie s'affiche.

F2 Aide Aide sur : ...

  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 `imprimer` dans votre code et vous voulez lire dans le manuel ce qui est indiqué pour cette commande. Vous positionnez votre curseur sur la commande `imprimer` et vous appuyer sur F1. La page du manuel avec les informations sur la commande `imprimer` va s'afficher.

  Cette fonction est très importante durant la phase d'apprentissage de la programmation.

Aide Rapport de bogue...

  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;.

Aide À propos de &kturtle;

  Vous trouverez ici des informations sur &kturtle; telle que le nom des auteurs et la licence du programme.

Aide À propos de &kde;

  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 !

## La barre d'outils

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 Exécuter les commandes et Arrêter l'exécution.

Vous pouvez configurer la barre d'outils en utilisant le menu Configuration Configuration avancéeConfigurer les barres d'outils...

## La barre d'état

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.