<!--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 quattro 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>