# Usare &kturtle;

Qui vi è un'immagine di &kturtle; in azione
La finestra principale di &kturtle;

La finestra principale di &kturtle; ha due parti principali: l'editor del codice (3) sulla sinistra dove inserisci i comandi &logo;, e l'area di disegno (4) sulla destra dove le istruzioni sono trasformate in disegno. L'area di disegno è l'ambiente della tartaruga: è nell'area di disegno che la tartaruga si muove e disegna. Le altre tre parti della finestra principale sono: la barra dei menu (1) da cui possono essere raggiunte le azioni, la barra degli strumenti (4) che ti permette di selezionare velocemente le azioni più usate, e la barra di stato (5) dove troverai informazioni sullo stato di &kturtle;.

## L'editor del codice

Nell'editor del codice inserisci i comandi &logo;. Ha tutte le caratteristiche che ci si aspetta da un editor moderno. La maggior parte delle sue caratteristiche si trovano nei menu Modifica e Strumenti. L'editor del codice può essere agganciato a ciascun bordo della finestra principale o può essere staccato e posizionato ovunque sul desktop.

Puoi inserire del codice nell'editor in vari modi. Il modo più semplice è usare un esempio già fatto: scegli File Apri esempi... nel menu File e fai clic su un file. Il nome del file ti dirà su cosa è l'esempio (&eg; `quadrato.logo` disegnerà un quadrato). Il file scelto sarà aperto nell'editor del codice, e, se vuoi, puoi quindi usare File Esegui comandi per eseguire il codice.

Puoi aprire i file di &logo; scegliendo File Apri... .

Il terzo modo è quello di scrivere il codice nell'editor o copiare/incollare del codice da questo manuale utente.

La posizione del cursore è indicata nella barra di stato, alla destra con i numeri di riga e di colonna.

## L'area di disegno

L'area di disegno è l'area dove i comandi sono visualizzati i comandi, dove cioè i comandi disegnano. In altre parole, è l'ambiente della tartaruga. Dopo aver inserito del codice nell'editor del codice, ed eseguito usando File Esegui comandi , possono accadere due cose: o il codice viene eseguito senza problemi e nella maggior parte dei casi vedrai dei cambiamenti nell'area di disegno; o c'è un errore nel codice, e apparirà un messaggio che ti dirà quale errore hai fatto.

Questo messaggio dovrebbe aiutarti a risolvere l'errore.

Il disegno visualizzato può essere salvato come immagine (usando File Salva area di disegno... o stampato (usando File Stampa... ).

## La barra dei menu

Nella barra dei menu trovi tutte le azioni di &kturtle;. Sono nei seguenti gruppi: File, Modifica, Visualizza, Strumenti, Impostazioni e Aiuto. Questa sezione li descrive tutti.

### Il menu File

#### Nuovo

&Ctrl;N File Nuovo

  Crea un nuovo file di &logo; vuoto.

#### Apri

&Ctrl;O File Apri...

  Apre un file di &logo;.

#### Apri recenti

File Apri recenti

  Apre un file di &logo; che è stato aperto recentemente.

#### Apri esempi

&Ctrl;E File Apri esempi

  Mostra la cartella con esempi di programmi &logo;. Gli esempi dovrebbero essere nella tua lingua preferita che puoi scegliere in Impostazioni Configura &kturtle;... .

#### Salva

&Ctrl;S File Salva

  Salva l'attuale file di &logo; aperto.

#### Salva con nome

File Salva con nome...

  Salva l'attuale file di &logo; aperto in un percorso specificato.

#### Salva area di disegno

File Salva area di disegno

  Salva come immagine l'attuale disegno nell'area di disegno.

#### Velocità di esecuzione

File Velocità di esecuzione

  Presenta un lista delle velocità di esecuzione possibili formata da: Velocità massima, Lenta, Più lenta e Lentissima. Quando la velocità di esecuzione è impostata a "Velocità massima" (predefinito) possiamo a mala pena renderci conto di ciò che sta accadendo. Qualche volta questo comportamento è voluto, ma qualche volta vogliamo tener traccia dell'esecuzione. Nel secondo caso imposta la velocità di esecuzione a "Lenta", "Più lenta" o "Lentissima". Quando una delle modalità lente è selezionata, sarà mostrata la posizione corrente del cursore nell'editor.

#### Esegui

&Alt;Invio File Esegui comandi

  Avvia l'esecuzione dei comandi nell'editor del codice.

#### Blocca

Pausa File Blocca esecuzione

  Blocca l'esecuzione. Questa azione è abilitata solo quando &kturtle; sta eseguendo i comandi.

#### Ferma

Esc File Ferma esecuzione

  Ferma l'esecuzione. Questa azione è abilitata solo quando &kturtle; sta eseguendo i comandi.

#### Stampa

&Ctrl;P File Stampa...

  Stampa l'attuale codice nell'editor del codice o l'attuale disegno nell'area di disegno.

#### Esci

&Ctrl;Q File Esce

  Esce da &kturtle;.

### Il menu Modifica

&Ctrl;Z Modifica Annulla

  Annulla l'ultima modifica al codice. &kturtle; può annullare infinite modifiche.

&Ctrl;&Shift;Z Modifica Rifai

  Rifa una modifica annullata al codice.

&Ctrl;X Modifica Taglia

  Taglia il testo selezionato dall'editor del codice negli appunti.

&Ctrl;C Modifica Copia

  Copia il testo selezionato dall'editor del codice negli appunti.

&Ctrl;V Modifica Incolla

  Incolla il testo dagli appunti nell'editor.

&Ctrl;F Modifica Trova...

  Con questa azione puoi cercare frasi nel codice.

F3 Modifica Trova successivo

  Usa questo per cercare la successiva occorrenza della frase.

&Ctrl;R Modifica Sostituisci...

  Con questa azione puoi sostituire frasi nel codice.

### Il menu Visualizza

&Ctrl;&Shift;F Vista Modalità a tutto schermo

  Con questa azione attivi e disattivi la modalità a tutto schermo.

  Nota: quando è eseguito il codice in modalità a tutto schermo, è nascosto tutto tranne l'area di disegno. Ciò rende possibile scrivere programmi a tutto schermo in &kturtle;.

F11 Vista Mostra numeri di linea

  Con questa azione puoi mostrare i numeri di riga nell'editor del codice. Ciò può essere utile per trovare gli errori.

### Il menu Strumenti

&Alt;C Strumenti Selettore di colore

  Questa azione apre il selettore di colore. Usando il selettore di colore puoi scegliere facilmente un codice di colore e inserirlo nell'editor del codice.

&Ctrl;I Strumenti Indenta

  Questa azione indenta (aggiunge uno spazio bianco all'inizio di) le righe selezionate. Se l'indentazione è usata correttamente può semplificare la lettura del codice. Tutti gli esempi usano l'indentazione, dai un'occhiata.

&Ctrl;&Shift;I Strumenti Annulla indentazione

  Questa azione annulla l'indentazione (rimuove lo spazio bianco all'inizio) delle righe selezionate.

Strumenti Pulisci indentazione

  Questa azione pulisce l'indentazione (rimuove tutti gli spazi bianchi all'inizio) delle righe selezionate.

&Ctrl;D Strumenti Commenta

  Questa azione aggiunge caratteri di commento (#) all'inizio delle righe selezionate. Le righe che iniziano con un carattere di commento sono ignorate durante l'esecuzione del codice. I commenti permettono al programmatore di spiegare un po' meglio il suo codice o possono essere usati per evitare temporaneamente che un pezzo di codice venga eseguito.

&Ctrl;&Shift;D Strumenti Decommenta

  Questa azione rimuove i caratteri di commento dalle righe selezionate.

### Il menu Impostazioni

Impostazioni Mostra/Nascondi la barra degli strumenti

  Mostra o nasconde la barra degli strumenti principale

Impostazioni Mostra/Nascondi la barra di stato

  Mostra o nasconde la barra di stato

Impostazioni Impostazioni avanzate

  Qui puoi modificare le cose che normalmente non hai bisogno di modificare. Il sottomenu Impostazioni avanzate ha tre voci: Configura l'editor (la finestra di dialogo standard di configurazione dell'editor &kate;), Configura le scorciatoie... (la finestra di dialogo standard di &kde; di configurazione delle scorciatoie) e Configura le barre degli strumenti... (la finestra di dialogo standard di &kde; di configurazione delle barre degli strumenti).

Impostazioni Configura &kturtle;...

  Questo è usato per configurare &kturtle;. Qui puoi cambiare la lingua dei comandi del &logo; o impostare una nuova dimensione iniziale dell'area di disegno.

### Il menu Aiuto

F1 Aiuto Manuale di &kturtle;

  Questa azione mostra il manuale che stai leggendo in questo momento.

&Shift;F1 Aiuto Che cos'è?

  Dopo aver attivato questa azione la freccia del mouse diventerà una freccia con punto interrogativo. Quando fai clic con questa freccia su una parte della finestra principale di &kturtle;, apparirà una finestra a comparsa con la descrizione della particolare parte.

F2 Aiuto Aiuto su: ...

  Questa è una funzione molto utile: fornisce aiuto sul codice dove il cursore si trova nell'editor del codice. Così, &eg;, hai usato il comando `scrivi` nel codice, e vuoi leggere e sapere cosa dice il manuale su questo comando. Muovi il cursore sul comando `scrivi` e premi F2. Il manuale mostrerà le informazioni sul comando `scrivi`.

  Questa funzione è molto importante specialmente quando si sta imparando a programmare.

Aiuto Segnala un bug...

  Usa questo per segnalare un problema con &kturtle; agli sviluppatori. Queste segnalazioni possono essere usate per rendere migliori le future versioni di &kturtle;.

Aiuto Informazioni su &kturtle;

  Qui puoi trovare informazioni su &kturtle;, come gli autori e la licenza con cui viene distribuito.

Aiuto Informazioni su &kde;

  Qui puoi trovare informazioni su &kde;. Se non sai ancora cosa è &kde;, non dovresti dimenticarti di questo posto.

## La barra degli strumenti

Qui puoi attivare velocemente le azioni più usate. In modo predefinito, troverai qui tutti i comandi più utili che finiscono con le icone Esegui comandi e Ferma esecuzione.

Puoi configurare la barra degli strumenti usando Impostazioni Impostazioni avanzateConfigura le barre degli strumenti...

## La barra di stato

Grazie alla barra di stato puoi monitorare lo stato di &kturtle;. Sul lato sinistro mostra il risultato dell'ultima azione. Sul lato destro trovi la posizione corrente del cursore (i numeri di riga e di colonna). Nel mezzo della barra di stato è indicata la lingua correntemente usata per i comandi.