<!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
     Thanks a lot in advance.-->
<chapter id="using-kturtle">
<title
>Usare &kturtle;</title>

<screenshot>
  <screeninfo
>Qui vi è un'immagine di &kturtle; in azione</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mainwindow_flower_nrs.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>La finestra principale di &kturtle;</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<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 &turtlelang;, 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, la <guilabel
>Console</guilabel
> che puoi usare per inserire e provare comandi di una riga, e <link linkend="the-statusbar"
>la barra di stato</link
> (6) dove troverai informazioni sullo stato di &kturtle;.</para>

<sect1 id="the-code-editor">
<title
>L'editor del codice</title>
<para
>Nell'editor del codice inserisci i comandi &turtlelang;. 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
><guisubmenu
>Esempi</guisubmenu
> </menuchoice
> nel <link linkend="the-file-menu"
>menu File</link
> e scegli un esempio. L'esempio che scegli sarà aperto <link linkend="the-code-editor"
>nell'editor del codice</link
>, e, se vuoi, puoi quindi usare <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Esegui</guimenuitem
> </menuchoice
> per eseguire il codice.</para>
<para
>Puoi aprire i file &turtlelang; 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>
</sect1>

<sect1 id="the-inspector">
<title
>L'ispettore</title>
<para
>L'ispettore ti da' informazioni su variabili, funzioni imparate e albero del codice mentre il programma è in esecuzione. </para>
<para
>L'ispettore può essere agganciato a qualsiasi bordo della finestra principale o può essere sganciato e piazzato ovunque sul desktop.</para>
</sect1>

<sect1 id="the-canvas">
<title
>L'area di disegno</title>
<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 nell'<link linkend="the-code-editor"
>editor del codice</link
>, ed eseguito usando <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Esegui</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
>Puoi ingrandire e ridurre l'area di disegno con la rotellina del mouse.</para>
</sect1>

<sect1 id="the-menubar">
<title
>La barra dei menu</title>
<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>

<sect2 id="the-file-menu">
<title
>Il menu <guimenu
>File</guimenu
></title>

  <variablelist>
    <anchor id="file-new"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Nuovo</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Crea un nuovo file di &turtlelang; vuoto.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Apri...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Apre un file di &turtlelang;.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open-recent"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>File</guimenu
> <guisubmenu
>Apri recenti</guisubmenu
> </menuchoice
></term>
      <listitem
><para
>Apre un file di &turtlelang; che è stato aperto recentemente.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open-examples"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>File</guimenu
> <guisubmenu
>Esempi</guisubmenu
> </menuchoice
></term>
      <listitem
><para
>Apre i programmi di esempio di &turtlelang;. Gli esempi sono nella tua lingua preferita che puoi scegliere in <menuchoice
><guimenu
>Impostazioni</guimenu
><guisubmenu
>Lingua degli script</guisubmenu
> </menuchoice
>.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Salva</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salva l'attuale file di &turtlelang; aperto.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save-as"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Salva come...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salva l'attuale file di &turtlelang; aperto in un percorso specificato.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save-as-picture"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Salva come immagine</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salva l'area di disegno corrente come immagine.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-execute"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F5</keysym
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Esegui</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Avvia l'esecuzione dei comandi nell'editor del codice.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-pause"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F6</keysym
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Metti in pausa</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Mette in pausa l'esecuzione. Questa azione è abilitata solo quando &kturtle; sta eseguendo i comandi.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-stop"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F7</keysym
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Termina</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Ferma l'esecuzione. Questa azione è abilitata solo quando &kturtle; sta eseguendo i comandi.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-speed"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>File</guimenu
> <guisubmenu
>Velocità di esecuzione</guisubmenu
> </menuchoice
></term>
      <listitem
><para
>Presenta una lista delle velocità di esecuzione possibili formata da: <guimenuitem
>Velocità massima</guimenuitem
>, <guimenuitem
>Lenta</guimenuitem
>, <guimenuitem
>Più lenta</guimenuitem
>,<guimenuitem
>Lentissima</guimenuitem
> e <guimenuitem
>Passo passo</guimenuitem
>. Quando la velocità di esecuzione è impostata a <guimenuitem
>Velocità massima</guimenuitem
> (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 <guimenuitem
>Lenta</guimenuitem
>, <guimenuitem
>Più lenta</guimenuitem
> o <guimenuitem
>Lentissima</guimenuitem
>. Quando una delle modalità lente è selezionata, sarà mostrata la posizione corrente del cursore nell'editor. <guimenuitem
>Passo passo</guimenuitem
> eseguirà un comando per volta.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-print"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Stampa...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Stampa il codice nell'editor.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-quit"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Esce</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Esce da &kturtle;.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-edit-menu">
  <title
>Il menu <guimenu
>Modifica</guimenu
></title>
  <variablelist>
    <anchor id="edit-undo"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Z</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Annulla</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Annulla l'ultima modifica al codice. &kturtle; può annullare infinite modifiche.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-redo"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Rifai</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Rifa una modifica annullata al codice.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-cut"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>X</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Taglia</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Taglia il testo selezionato dall'editor del codice negli appunti.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-copy"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Copia</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Copia il testo selezionato dall'editor del codice negli appunti.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-paste"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>V</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Incolla</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Incolla il testo dagli appunti nell'editor.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-select-all"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Seleziona tutto</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Seleziona tutto il testo nell'editor.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-find"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Trova...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Con questa azione puoi cercare frasi nel codice.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-find-next"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F3</keysym
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Trova successivo</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Usa questo per cercare la successiva occorrenza della frase.</para
></listitem>
    </varlistentry>
  </variablelist
>  
  <variablelist>
    <anchor id="edit-find-previous"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Shift;<keysym
>F3</keysym
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Trova precedente</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Usa questo per cercare l'occorrenza precedente della frase.</para
></listitem>
    </varlistentry>
  </variablelist>
  <!--<variablelist>
    <anchor id="edit-replace"/>
    <varlistentry>
      <term
><menuchoice>
        <shortcut>
          <keycombo
>&Ctrl;<keycap
>R</keycap
></keycombo>
        </shortcut>
        <guimenu
>Edit</guimenu>
        <guimenuitem
>Replace...</guimenuitem>
      </menuchoice
></term>
      <listitem
><para
>With this action you can replace text in the code.</para
></listitem>
    </varlistentry>
  </variablelist
>-->
<variablelist>
    <anchor id="toggle-insert"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keycap
>Ins</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Modalità sovrascrittura</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Passa da modalità inserimento a sovrascrittura, e viceversa</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-view-menu">
  <title
>Il menu <guimenu
>Visualizza</guimenu
></title>
  <variablelist>
    <anchor id="view-codeeditor"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Visualizza</guimenu
> <guimenuitem
>Mostra editor</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Mostra o nasconde l'editor del codice.</para>
</listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-inspector"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>I</keycap
></keycombo
> </shortcut
> <guimenu
>Visualizza</guimenu
> <guimenuitem
>Mostra ispettore</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Mostra o nasconde l'ispettore</para>
</listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-error"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Visualizza</guimenu
> <guimenuitem
>Mostra errori</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Mostra o nasconde la scheda <guilabel
>Errori</guilabel
> con la lista degli errori che si sono verificati durante l'esecuzione del codice. Se questa opzione è attivata,  fai clic sull'<guilabel
>area di disegno</guilabel
> per vedere nuovamente la tartaruga.</para>
      </listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-linenumbers"/>
    <varlistentry>
      <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>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-tools-menu">
  <title
>Il menu <guimenu
>Strumenti</guimenu
></title>
  <variablelist>
    <anchor id="tools-direction-chooser"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Strumenti</guimenu
> <guimenuitem
>Scelta direzione...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Questa azione apre la finestra di dialogo di scelta della direzione.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="tools-color-chooser"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Selettore colore...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Questa azione apre la finestra di dialogo di scelta colore.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-setting-menu">
  <title
>Il menu <guimenu
>Impostazioni</guimenu
></title>
    <variablelist>
    <anchor id="script-language"/>
    <varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guisubmenu
>Lingua degli script</guisubmenu
> </menuchoice
></term>
<listitem
><para
><action
>
>Sceglie</action
> la lingua per il codice.</para
></listitem>
</varlistentry>
  </variablelist
>  
<variablelist>
    <anchor id="toggle-toolbar"/>
    <varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra la barra degli strumenti</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra o nasconde</action
> la barra degli strumenti principale</para
></listitem>
</varlistentry>
  </variablelist
>  
  <variablelist>
      <anchor id="toggle-statusbar"/>
   <varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra la barra di stato</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra o nasconde</action
> la barra di stato</para
></listitem>
</varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="settings-configure-shortcuts"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura le scorciatoie...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Finestra di dialogo standard di &kde; per configurare le scorciatoie.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="settings-configure-toolbars"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura la barre degli strumenti...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Finestra di dialogo standard di &kde; per configurare le barre degli strumenti.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-help-menu">
  <title
>Il menu <guimenu
>Aiuto</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="the-toolbar">
<title
>La barra degli strumenti</title>
<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</guiicon
> e <guiicon
>Termina</guiicon
>. L'ultimo elemento alla fine della barra degli strumenti è la <guiicon
>Console</guiicon
>, che puoi usare per inserire un comando di una sola riga e provarlo.</para>
<para
>Puoi configurare la barra degli strumenti usando <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura le barre degli strumenti...</guimenuitem
></menuchoice
></para>
</sect1>

<sect1 id="the-statusbar">
<title
>La barra di stato</title>
<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>
</sect1>

</chapter>
