<para>La finestra principale di &kturtle; ha due parti principali: <link linkend="the-code-editor">l'editor del codice</link> (3) sulla sinistra dove inserisci i comandi &logo;, e <link linkend="the-canvas">l'area di disegno</link> (4) sulla destra dove le istruzioni sono trasformate in disegno. <link linkend="the-canvas">L'area di disegno</link> è l'ambiente della tartaruga: è nell'area di disegno che la tartaruga si muove e disegna. Le altre tre parti della finestra principale sono: <link linkend="the-menubar">la barra dei menu</link> (1) da cui possono essere raggiunte le azioni, <link linkend="the-toolbar">la barra degli strumenti</link> (2) che ti permette di selezionare velocemente le azioni più usate, e <link linkend="the-statusbar">la barra di stato</link> (5) dove troverai informazioni sullo stato di &kturtle;.</para>
<para>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 <link linkend="the-edit-menu">Modifica</link> e <link linkend="the-tools-menu">Strumenti</link>. L'editor del codice può essere agganciato a ciascun bordo della finestra principale o può essere staccato e posizionato ovunque sul desktop.</para>
<para>Puoi inserire del codice nell'editor in vari modi. Il modo più semplice è usare un esempio già fatto: scegli <menuchoice><guimenu>File</guimenu><guimenuitem>Apri esempi...</guimenuitem> </menuchoice> nel <link linkend="the-file-menu">menu File</link> e fai clic su un file. Il nome del file ti dirà su cosa è l'esempio (⪚ <filename>quadrato.logo</filename> disegnerà un quadrato). Il file scelto sarà aperto <link linkend="the-code-editor">nell'editor del codice</link>, e, se vuoi, puoi quindi usare <menuchoice><guimenu>File</guimenu><guimenuitem>Esegui comandi</guimenuitem> </menuchoice> per eseguire il codice.</para>
<para>Puoi aprire i file di &logo; scegliendo <menuchoice><guimenu>File</guimenu><guimenuitem>Apri...</guimenuitem> </menuchoice>.</para>
<para>Il terzo modo è quello di scrivere il codice nell'editor o copiare/incollare del codice da questo manuale utente. </para>
<para>La posizione del cursore è indicata nella <link linkend="the-statusbar">barra di stato</link>, alla destra con i numeri di riga e di colonna. </para>
<para>L'area di disegno è l'area dove i comandi sono visualizzati i comandi, dove cioè i comandi <quote>disegnano</quote>. In altre parole, è l'ambiente della tartaruga. Dopo aver inserito del codice <link linkend="the-code-editor">nell'editor del codice</link>, ed eseguito usando <menuchoice><guimenu>File</guimenu><guimenuitem>Esegui comandi</guimenuitem> </menuchoice>, 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.</para>
<para>Questo messaggio dovrebbe aiutarti a risolvere l'errore.</para>
<para>Il disegno visualizzato può essere salvato come immagine (usando <menuchoice><guimenu>File</guimenu><guimenuitem>Salva area di disegno...</guimenuitem> </menuchoice> o stampato (usando <menuchoice><guimenu>File</guimenu><guimenuitem>Stampa...</guimenuitem> </menuchoice>).</para>
<para>Nella barra dei menu trovi tutte le azioni di &kturtle;. Sono nei seguenti gruppi: <guimenu>File</guimenu>, <guimenu>Modifica</guimenu>, <guimenu>Visualizza</guimenu>, <guimenu>Strumenti</guimenu>, <guimenu>Impostazioni</guimenu> e <guimenu>Aiuto</guimenu>. Questa sezione li descrive tutti.</para>
<listitem><para>Mostra la cartella con esempi di programmi &logo;. Gli esempi dovrebbero essere nella tua lingua preferita che puoi scegliere in <menuchoice><guimenu>Impostazioni</guimenu><guimenuitem>Configura &kturtle;...</guimenuitem> </menuchoice>.</para></listitem>
<term><menuchoice><guimenu>File</guimenu> <guimenuitem>Velocità di esecuzione</guimenuitem> </menuchoice></term>
<listitem><para>Presenta una 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.</para></listitem>
<term><menuchoice><shortcut> <keycombo>&Ctrl;&Shift;<keycap>F</keycap></keycombo> </shortcut> <guimenu>Vista</guimenu> <guimenuitem>Modalità a tutto schermo</guimenuitem> </menuchoice></term>
<listitem><para>Con questa azione attivi e disattivi la modalità a tutto schermo.</para>
<para>Nota: quando è eseguito il codice in modalità a tutto schermo, è nascosto tutto tranne l'area di disegno. Ciò rende possibile scrivere programmi <quote>a tutto schermo</quote> in &kturtle;.</para></listitem>
<term><menuchoice><shortcut> <keycombo><keysym>F11</keysym></keycombo> </shortcut> <guimenu>Vista</guimenu> <guimenuitem>Mostra numeri di linea</guimenuitem> </menuchoice></term>
<listitem><para>Con questa azione puoi mostrare i numeri di riga nell'editor del codice. Ciò può essere utile per trovare gli errori.</para></listitem>
<term><menuchoice><shortcut> <keycombo>&Alt;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Strumenti</guimenu> <guimenuitem>Selettore di colore</guimenuitem> </menuchoice></term>
<listitem><para>Questa azione apre il selettore di colore. Usando il selettore di colore puoi scegliere facilmente un <glossterm linkend="rgb">codice di colore</glossterm> e inserirlo <link linkend="the-code-editor">nell'editor del codice</link>.</para></listitem>
<listitem><para>Questa azione <quote>indenta</quote> (aggiunge uno spazio bianco all'inizio di) le righe selezionate. Se l'<quote>indentazione</quote> è usata correttamente può semplificare la lettura del codice. Tutti gli esempi usano l'indentazione, dai un'occhiata.</para></listitem>
<listitem><para>Questa azione pulisce l'<quote>indentazione</quote> (rimuove tutti gli spazi bianchi all'inizio) delle righe selezionate.</para></listitem>
<listitem><para>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.</para></listitem>
<listitem><para>Qui puoi modificare le cose che normalmente non hai bisogno di modificare. Il sottomenu <guisubmenu>Impostazioni avanzate</guisubmenu> ha tre voci: <guimenuitem>Configura l'editor</guimenuitem> (la finestra di dialogo standard di configurazione dell'editor &kate;), <guimenuitem>Configura le scorciatoie...</guimenuitem> (la finestra di dialogo standard di &kde; di configurazione delle scorciatoie) e <guimenuitem>Configura le barre degli strumenti...</guimenuitem> (la finestra di dialogo standard di &kde; di configurazione delle barre degli strumenti).</para></listitem>
<listitem><para>Questo è usato per configurare &kturtle;. Qui puoi cambiare la lingua dei comandi del &logo; o impostare una nuova dimensione iniziale dell'area di disegno.</para></listitem>
<listitem><para>Dopo aver attivato questa azione la freccia del mouse diventerà una <quote>freccia con punto interrogativo</quote>. 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.</para></listitem>
<term><menuchoice><shortcut> <keycombo><keysym>F2</keysym></keycombo> </shortcut> <guimenu>Aiuto</guimenu> <guimenuitem>Aiuto su: ...</guimenuitem> </menuchoice></term>
<listitem><para>Questa è una funzione molto utile: fornisce aiuto sul codice dove il cursore si trova nell'editor del codice. Così, ⪚, hai usato il comando <userinput>scrivi</userinput> nel codice, e vuoi leggere e sapere cosa dice il manuale su questo comando. Muovi il cursore sul comando <userinput>scrivi</userinput> e premi <keysym>F2</keysym>. Il manuale mostrerà le informazioni sul comando <userinput>scrivi</userinput>.</para>
<para>Questa funzione è molto importante specialmente quando si sta imparando a programmare.</para></listitem>
<term><menuchoice><guimenu>Aiuto</guimenu> <guimenuitem>Segnala un bug...</guimenuitem> </menuchoice></term>
<listitem><para>Usa questo per segnalare un problema con &kturtle; agli sviluppatori. Queste segnalazioni possono essere usate per rendere migliori le future versioni di &kturtle;.</para></listitem>
<para>Qui puoi attivare velocemente le azioni più usate. In modo predefinito, troverai qui tutti i comandi più utili che finiscono con le icone <guiicon>Esegui comandi</guiicon> e <guiicon>Ferma esecuzione</guiicon>.</para>
<para>Puoi configurare la barra degli strumenti usando <menuchoice><guimenu>Impostazioni</guimenu><guimenuitem>Impostazioni avanzate</guimenuitem><guimenuitem>Configura le barre degli strumenti...</guimenuitem></menuchoice></para>
<para>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.</para>
