1<chapter id="import-export">
2<title
3>Importazione ed esportazione</title>
4<sect1 id="import-export-projects">
5    <title
6>Condividere i progetti di &rocs;</title>
7    <para
8>I progetti di &rocs; possono essere importati ed esportati come archivi <literal role="extension"
9>.tar.gz</literal
10>, che si possono usare per condividere progetti. Si possono importare o esportare progetti rispettivamente attraverso i menu <menuchoice
11><guimenu
12>Grafo</guimenu
13><guimenuitem
14>Importa grafo</guimenuitem
15></menuchoice
16> e <menuchoice
17><guimenu
18>Grafo</guimenu
19><guimenuitem
20>Esporta grafo come</guimenuitem
21></menuchoice
22>. </para>
23</sect1>
24
25<sect1 id="import-export-graphs">
26    <title
27>Importazione ed esportazione di grafi</title>
28    <para
29>&rocs; attualmente supporta l'importazione e l'esportazione dei seguenti formati di file:</para>
30    <itemizedlist>
31        <listitem
32><para
33>File DOT, altrimenti noti come GraphViz</para
34></listitem>
35        <listitem
36><para
37>File GML</para
38></listitem>
39        <listitem
40><para
41>File in formato di grafi banale (TGF)</para
42></listitem>
43        <listitem
44><para
45>Formato di linguaggio a marcatori Keyhole</para
46></listitem>
47    </itemizedlist>
48
49<sect2 id="format-specification-tgf">
50<title
51>Il formato di grafi banale (TGF)</title>
52<para
53>Il <emphasis
54>formato di grafi banale</emphasis
55> (<foreignphrase lang="en"
56>Trivial Graph Format</foreignphrase
57>, TGF) è un semplice formato di file testuale per descrivere i grafi. Un file TGF consiste di un elenco di definizioni dei nodi che fanno corrispondere i loro identificativi a delle etichette, seguite da un elenco degli archi. In questo formato è possibile avere una sola etichetta per nodo e un valore per arco. &rocs; interpreta i grafi importati come grafi non direzionali. I grafi esportati conterranno due archi per connessione se le connessioni sono bidirezionali. </para>
58
59<sect3>
60<title
61>Specificazione del formato</title>
62    <itemizedlist>
63        <listitem
64><para
65>Il file comincia con un elenco di nodi (uno per riga), seguito da una riga con il solo carattere <literal
66>#</literal
67>, seguito da un elenco di archi (uno per riga).</para
68></listitem>
69        <listitem
70><para
71>Un nodo è costituito da un intero (l'identificativo), seguito da uno spazio, seguito da una stringa qualsiasi.</para
72></listitem>
73        <listitem
74><para
75>Un arco è costituito da due interi (gli identificativi) separati da uno spazio, seguiti da uno spazio, seguito da una stringa qualsiasi. Si assume che l'arco direzionale punti dal primo identificativo al secondo.</para
76></listitem>
77    </itemizedlist>
78</sect3>
79<sect3>
80<title
81>Esempio</title>
82<programlisting
83>1 nodo iniziale
842 trasmissione
853 termine
86#
871 2 blu
882 1 rosso
892 3 verde
90</programlisting>
91</sect3>
92</sect2>
93
94<sect2 id="format-specification-dot">
95<title
96>Linguaggio DOT / Formato di grafi Graphviz</title>
97<para
98>Il linguaggio DOT è un linguaggio descrittivo in testo semplice che permette sia rappresentazione leggibile dei grafi, sia una elaborazione efficiente da parte di un programma di disposizione dei grafi. DOT è il formato di file predefinito per la serie di programmi di visualizzazione Graphviz, ma è usato anche da altri strumenti. Le estensioni più comuni dei file DOT sono <literal role="extension"
99>.gv</literal
100> e <literal role="extension"
101>.dot</literal
102>. </para>
103
104<sect3>
105<title
106>Funzionalità non supportate</title>
107<para
108>&rocs; può elaborare ogni file contenente un grafo specificato secondo il linguaggio DOT<footnote
109><para
110>http://www.graphviz.org/content/dot-language</para
111></footnote
112>. Il supporto delle varie funzionalità del linguaggio è completo, con le seguenti eccezioni: </para>
113    <itemizedlist>
114        <listitem
115><para
116>Sottografi: a causa della mancanza del concetto di sottografo in &rocs;, i sottografi sono importati come insiemi di elementi e connessioni. In particolare, le connessioni da o verso sottografi non sono importate.</para
117></listitem>
118        <listitem
119><para
120>Attributi &HTML; e &XML;: gli attributi (come etichette) che contengono sintassi &HTML; o &XML; vengono letti senza modifica. In particolare, da questi attributi non viene letta nessuna specificazione di carattere o stile.</para
121></listitem>
122    </itemizedlist>
123</sect3>
124<sect3>
125<title
126>Esempio</title>
127<programlisting
128>digraph mioGrafo {
129    a -> b -> c;
130    b -> d;
131}
132</programlisting>
133</sect3>
134</sect2>
135
136</sect1>
137</chapter>