<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&rocs;"> <!ENTITY package "kdereview"> <!ENTITY % addindex "IGNORE"> <!ENTITY % Italian "INCLUDE" > ]> <book lang="&language;"> <bookinfo> <title >Manuale di &rocs;</title> <authorgroup> <author ><personname > <firstname >Tomaz</firstname > <surname >Canabrava</surname > </personname > <email >tomaz.canabrava@gmail.com</email > </author> <othercredit role="translator" ><firstname >Francesco</firstname ><surname >Nigro</surname ><affiliation ><address ><email >nigro.fry@gmail.com</email ></address ></affiliation ><contrib >Traduzione della documentazione</contrib ></othercredit > </authorgroup> <copyright> <year >2009</year> <holder >Tomaz Canabrava</holder> </copyright> <legalnotice >&FDLNotice;</legalnotice> <date >2009-11-05</date> <releaseinfo >1.0</releaseinfo> <abstract> <para >&rocs; è un visore per lo studio della teoria dei grafi per KDE. </para> </abstract> <keywordset> <keyword >KDE</keyword> <keyword >kdeedu</keyword> <keyword >matematica</keyword> <keyword >matematica</keyword> <keyword >grafi</keyword> <keyword >nodo</keyword> <keyword >arco</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title >Introduzione</title> <para >&rocs; mira ad essere uno strumento di sviluppo per la teoria dei grafi e ad aiutare i docenti nel mostrare il risultato di un algoritmo su un grafo, e gli studenti nel realizzare gli algoritmi.</para> <para >&rocs; utilizza un modulo per gli script, realizzato in QT Script, che interagisce con il grafo disegnato; ogni cambiamento apportato al grafo tramite uno script è riportato sul grafo disegnato.</para> </chapter> <chapter id="using-rocs"> <title >Utilizzo di &rocs;</title> <para >L'interfaccia utente è divisa in due parti: </para > <itemizedlist> <listitem ><para >nella parte in alto a destra puoi disegnare i grafi, mentre nella parte in basso a destra puoi creare gli algoritmi, </para ></listitem> <listitem ><para >la barra laterale sinistra contiene i grafi aperti; puoi aprire più grafi per ciascun file. </para ></listitem> </itemizedlist> <sect1 id="rocs-features"> <title >Impostazioni globali di &rocs;</title> <para >La barra laterale sinistra contiene le opzioni per ciascun grafo aperto; queste impostazioni sono generali per il grafo. Puoi cambiare le opzioni per ogni singolo nodo od arco attraverso la finestra Proprietà del nodo e Proprietà dell'arco.</para> <itemizedlist> <listitem ><para> <guilabel >Nome del grafo</guilabel> </para ></listitem> <listitem ><para ><guilabel >Colore predefinito del nodo</guilabel > si applica ai nuovi nodi creati. Puoi cambiare il colore di tutti nodi correnti facendo clic sul pulsante Tutti </para ></listitem> <listitem ><para> <guilabel >Colore predefinito dell'arco</guilabel> </para ></listitem> </itemizedlist> <para >L'ultima riga di opzioni è costituita da tasti di commutazione:</para> <itemizedlist> <listitem ><para> <guilabel >Grafo orientato</guilabel> </para ></listitem> <listitem ><para> <guilabel >Grafo automatizzato</guilabel> </para ></listitem> <listitem ><para> <guilabel >Mostra i nomi dei nodi</guilabel> </para ></listitem> <listitem ><para> <guilabel >Mostra i nomi degli archi</guilabel> </para ></listitem> <listitem ><para> <guilabel >Mostra i valori dei nodi</guilabel> </para ></listitem> <listitem ><para> <guilabel >Mostra i valori degli archi</guilabel> </para ></listitem> </itemizedlist> </sect1> <sect1 id="rocs-toolbars"> <title >Barre degli strumenti di &rocs;</title> <para >Ci sono due barre degli strumenti in alto. La principale è composta dai seguenti strumenti:</para> <itemizedlist> <listitem ><para ><guilabel >Sposta nodo</guilabel >: sposta il nodo all'interno dell'area di disegno.</para ></listitem> <listitem ><para ><guilabel >Aggiungi nodo</guilabel >: aggiunge un nuovo nodo all'area di disegno nella posizione dove si è fatto clic.</para ></listitem> <listitem ><para ><guilabel >Aggiungi arco</guilabel >: crea un nuovo arco tra due nodi. </para ></listitem> <listitem ><para ><guilabel >Seleziona</guilabel >: permette di selezionare gli elementi facendo clic su di essi.</para ></listitem> <listitem ><para ><guilabel >Elimina</guilabel >: permette di eliminare gli elementi facendo clic su di essi.</para ></listitem> </itemizedlist> <para >Facendo clic con il tasto destro del mouse su un nodo o su un arco si visualizza la sua finestra di proprietà.</para> <para >La barra degli strumenti per l'impaginazione è composta da diverse icone per l'allineamento.</para> <para >Per allineare dei nodi utilizza lo strumento <guiicon >Seleziona</guiicon >, traccia un rettangolo di selezione e poi scegli l'allineamento che preferisci. </para> </sect1> </chapter> <chapter id="scripting-rocs"> <title >Script in &rocs;</title> <para >Una volta che il grafo è sullo schermo, puoi incominciare a creare degli script per manipolarlo. Il linguaggio utilizzato per gli script usa la sintassi di Javascript; di seguito gli oggetti Grafo, Nodo ed Arco.</para> <sect1 id="script-graph"> <title >Grafo</title> <programlisting >array list_nodes(); array list_edges(); node add_node(name); edge add_edge(da, a); node node_byname(QString& name); node begin_node(); array end_nodes(); </programlisting > <para >Variabili del grafo che possono essere modificate:</para> <programlisting >bool directed bool automate string name string nodeDefaultColor // in esadecimale string edgeDefaultColor // in esadecimale </programlisting> </sect1> <sect1 id="script-nodes"> <title >Nodi</title> <programlisting >array adj_nodes(); array adj_edges(); array input_edges(); array output_edges(); array loop_edges(); array connected_edges(Node *n); void self_remove(); </programlisting > <para >Variabili del nodo:</para> <programlisting >double x double y double width string value string name string color // in esadecimale bool begin bool end </programlisting> </sect1> <sect1 id="script-edges"> <title >Archi</title> <programlisting >string color ( em hexa ) string value string name double width string style ( dot, dash, dash dot, solid ) node start(); node end(); void self_remove(); </programlisting > </sect1> <sect1 id="script-example"> <title >Esempio</title> <para >Qui di seguito un semplice script di esempio che imposta il colore dei primi 4 nodi del primo grafo:</para> <programlisting >/* Un semplice esempio che imposta il colore dei primi 4 nodi del primo grafo: */ var colours = new Array("red", "green", "blue", "yellow"); /* graphs è un array di grafi; puoi accedere ad un grafo utilizzando l'indice dell'array o il suo nome. Se il grafo si chiama, ad esempio SenzaNome0 le seguenti istruzioni sono corrette */ var list1= graphs[0].list_nodes(); // prima forma. var list2=SenzaNome0.list_nodes(); // seconda forma for ( var i = 0; i < colours.length; i++){ if (i > list2.length) break; list2[i].color = colours[i] } </programlisting> </sect1> </chapter> <chapter id="commands"> <title >Guida ai comandi</title> <sect1 id="rocs-mainwindow"> <title >Menu e scorciatoie da tastiera</title> <sect2> <title >Il menu <guimenu >File</guimenu ></title> <variablelist> <varlistentry> <term ><menuchoice ><shortcut > <keycombo action="simul" >&Ctrl;<keycap >Q</keycap ></keycombo > </shortcut > <guimenu >File</guimenu > <guimenuitem >Chiudi</guimenuitem > </menuchoice ></term> <listitem ><para ><action >Chiudi</action > &rocs;</para ></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title >Il menu <guimenu >Impostazioni</guimenu ></title> <variablelist> <varlistentry> <term ><menuchoice ><guimenu >Impostazioni</guimenu > <guisubmenu >Strumenti</guisubmenu > </menuchoice ></term> <listitem ><para ><action >Commuta</action > le barre degli strumenti <guimenuitem >Principale</guimenuitem >, <guimenuitem >Caratteri Speciali</guimenuitem >, <guimenuitem >Aspetto</guimenuitem > e <guimenuitem >Lingua</guimenuitem >.</para ></listitem> </varlistentry> <varlistentry> <term ><menuchoice ><guimenu >Impostazioni</guimenu > <guimenuitem >Mostra la barra di stato</guimenuitem > </menuchoice ></term> <listitem ><para ><action >Commuta</action > la barra di stato.</para ></listitem> </varlistentry> <varlistentry> <term ><menuchoice ><guimenu >Impostazioni</guimenu > <guimenuitem >Configura le scorciatoie...</guimenuitem > </menuchoice ></term> <listitem ><para ><action >Apri</action > la finestra predefinita delle impostazioni di &kde; che ti permette di scegliete diverse scorciatoie da tastiera per differenti azioni. </para ></listitem> </varlistentry> <varlistentry> <term ><menuchoice ><guimenu >Impostazioni</guimenu > <guimenuitem >Configura la barra degli strumenti...</guimenuitem > </menuchoice ></term> <listitem ><para ><action >Configura</action > gli oggetti che vuoi mettere nella barra degli strumenti. </para ></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title >Il menu <guimenu >Aiuto</guimenu ></title> &help.menu.documentation; </sect2> </sect1> </chapter> <chapter id="credits"> <title >Ringraziamenti e licenza</title> <para >&rocs; </para> <para >Copyright del programma 2009 Tomaz Canabrava tcanabrava at kde dot org </para> <para >Copyright della documentazione 2009 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; e Tomaz Canabrava tcanabrava at kde dot org </para> <para >Traduzione di Francesco Nigro<email >nigro.fry@gmail.com</email ></para > &underFDL; &underGPL; </chapter> <appendix id="installation"> <title >Installazione</title> <sect1 id="getting-rocs"> <title >Come ottenere &rocs;</title> &install.intro.documentation; </sect1> <sect1 id="compilation"> <title >Compilazione e installazione</title> &install.compile.documentation; </sect1> </appendix> &documentation.index; </book> <!-- Local Variables: mode: sgml sgml-minimize-attributes: nil sgml-general-insert-case: lower sgml-indent-step:0 sgml-indent-data:nil End: -->