<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY GFDL SYSTEM "fdl-appendix.xml">
<!ENTITY app "Vinagre">
<!ENTITY application "<application>&app;</application>">
<!ENTITY appversion "2.28">
<!ENTITY manrevision "2.28">
]>
<!--
      (Do not remove this comment block.)
  Template Maintained by the GNOME Documentation Project:
	  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="it">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->

  <articleinfo>
    <title>Manuale di <application>Vinagre</application></title>
    <abstract role="description">
      <para><application>Vinagre</application> è un visualizzatore di desktop remoto</para>
    </abstract>
    <copyright>
      <year>2007, 2008, 2009</year>
      <holder>Jonh Wendell (wendell@bani.com.br)</holder>
    </copyright>

  <!-- translators: uncomment this:

  <copyright>
   <year>2006</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

  -->

<!-- An address can be added to the publisher information.  If a role is
     not specified, the publisher/author is the same for all versions of the
     document.  -->
    <publisher role="maintainer">
      <publishername>Jonh Wendell</publishername>
    </publisher>

     <legalnotice id="legalnotice">
	<para>Questo documento può essere copiato, distribuito o modificato in conformità con i termini della GNU Free Documentation License (GFDL) Versione 1.1 o delle versioni successive pubblicate dalla Free Software Foundation senza sezioni invariabili, frontespizi e testi di copertina. Una copia della GFDL si può trovare a questo <ulink type="help" url="ghelp:fdl">collegamento</ulink> o nel file COPYING-DOCS distribuito con questo manuale.</para>
         <para>Questo manuale è parte di una raccolta di manuali di GNOME distribuita in conformità con la GFDL. Per poter distribuire questo manuale separatamente, è necessario inserirvi una copia della licenza, come descritto nella sezione 6 della licenza.</para>

	<para>Molti dei nomi usati dalle aziende per distinguere i propri prodotti e servizi sono rivendicati come marchi. Quando questi nomi compaiono nella documentazione di GNOME, e i partecipanti al Progetto di documentazione di GNOME sono consapevoli del loro utilizzo, essi vengono scritti in lettere maiuscole o con l'iniziale maiuscola.</para>

	<para>QUESTO DOCUMENTO E LE SUE VERSIONI MODIFICATE VENGONO FORNITI IN BASE AI TERMINI DELLA GNU FREE DOCUMENTATION LICENSE, CON L'INTESA CHE: <orderedlist>
		<listitem>
		  <para>IL DOCUMENTO VIENE FORNITO SENZA GARANZIE DI ALCUN TIPO, ESPLICITE O IMPLICITE, INCLUSE, MA SENZA LIMITAZIONE, LE GARANZIE ATTESTANTI CHE IL DOCUMENTO O LE SUE VERSIONI MODIFICATE SIANO PRIVI DI DIFETTI, COMMERCIALIZZABILI, IDONEI A UN DETERMINATO SCOPO O CHE NON VIOLINO DIRITTI DI TERZI. SI DECLINA QUALUNQUE RESPONSABILITÀ RIGUARDO AI RISCHI INERENTI LA QUALITÀ, L'ACCURATEZZA E LE PRESTAZIONI DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA. QUALORA UN DOCUMENTO O UNA SUA VERSIONE MODIFICATA DOVESSERO PRESENTARE QUALUNQUE TIPO DI DIFETTO, IL COSTO DI EVENTUALI INTERVENTI DI ASSISTENZA, RIPARAZIONE O CORREZIONE SARÀ A CARICO DELL'UTENTE (NON DEL REDATTORE INIZIALE, DELL'AUTORE O DI ALTRI COLLABORATORI). QUESTA LIMITAZIONE DELLA GARANZIA COSTITUISCE PARTE ESSENZIALE DELLA LICENZA. L'USO DEL DOCUMENTO O DELLE SUE VERSIONI MODIFICATE È CONSENTITO SOLO ENTRO I TERMINI DI QUESTA LIMITAZIONE DELLA GARANZIA; E</para>
		</listitem>
		<listitem>
		  <para>IN NESSUNA CIRCOSTANZA E PER NESSUNA RAGIONE LEGALE, INCLUSI I PRINCIPI DI COLPA (INCLUSA LA NEGLIGENZA), ACCORDO CONTRATTUALE O ALTRO, SARÀ POSSIBILE CONSIDERARE L'AUTORE, IL REDATTORE INIZIALE, GLI ALTRI COLLABORATORI, QUALUNQUE DISTRIBUTORE DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA O QUALUNQUE FORNITORE DELLE PERSONE CITATE, RESPONSABILE NEI CONFRONTI DI QUALUNQUE PERSONA PER DANNI DIRETTI, INDIRETTI, SPECIALI, INCIDENTALI O CONSEGUENTI DI QUALUNQUE NATURA, INCLUSI, MA SENZA LIMITAZIONE, I DANNI PER PERDITA DI AVVIAMENTO, INTERRUZIONE DEL LAVORO, GUASTO O MALFUNZIONAMENTO DEL COMPUTER O QUALUNQUE ALTRO DANNO O PERDITA DERIVANTE O CORRELATA ALL'USO DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA, ANCHE QUALORA LE PERSONE CITATE FOSSERO STATE INFORMATE DELLA POSSIBILITÀ DI TALI DANNI.</para>
		</listitem>
	  </orderedlist></para>
  </legalnotice>


   <!-- This file  contains link to license for the documentation (GNU FDL), and
        other legal stuff such as "NO WARRANTY" statement. Please do not change
        any of this. -->

    <authorgroup>
      <author>
        <firstname>Vinicius</firstname>
        <surname>Depizzol</surname>
        <email>vdepizzol@gmail.com</email>
      </author>

      <author>
        <firstname>Jonh</firstname>
        <surname>Wendell</surname>
        <email>wendell@bani.com.br</email>
      </author>

<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
       <othercredit role="translator">
        <firstname>Latin</firstname>
        <surname>Translator 1</surname>
        <affiliation>
          <orgname>Latin Translation Team</orgname>
          <address> <email>translator@gnome.org</email> </address>
        </affiliation>
        <contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>

    <revhistory>
      <revision>
        <revnumber>0.3</revnumber>
        <date>2009-08-23</date>
        <revdescription>
          <para role="author">Jonh Wendell
            <email>wendell@bani.com.br</email>
          </para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>0.2</revnumber>
        <date>15/01/2008</date>
        <revdescription>
          <para role="author">Vinicius Depizzol <email>vdepizzol@gmail.com</email></para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>0.1</revnumber>
        <date>16/12/2007</date>
        <revdescription>
          <para role="author">Jaap A. Haitsma <email>jaap@haitsma.org</email></para>
          <para role="publisher">Jaap A. Haitsma</para>
        </revdescription>
      </revision>
    </revhistory>

    <legalnotice>
      <title>Commenti</title>
      <para>
        To report a bug or make a suggestion regarding the Vinagre application or
        this manual, please file a bug at
        <ulink url="http://bugzilla.gnome.org/enter_bug.cgi?product=vinagre" type="http">GNOME bugzilla page</ulink>.
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice>
  </articleinfo>

  <indexterm zone="index">
    <primary><application>Vinagre</application></primary>
  </indexterm>
  <indexterm zone="index">
    <primary>desktop remoto</primary>
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<section id="intro">
  <title>Introduzione</title>
  <!-- manrevision 2.0 compatibility -->
  <anchor id="aboutex"/>
  <anchor id="notice"/>
  <indexterm>
    <primary><application>Vinagre</application></primary>
    <secondary>Manuale</secondary>
    <tertiary>vinagre</tertiary>
  </indexterm>

  <para>The Vinagre application is a Remote Desktop Viewer for the <systemitem>GNOME desktop</systemitem> that uses Virtual Network Computing (VNC) system (and possibly other protocols) to remotely control another computer.</para>
  <para><application>Vinagre</application> dispone delle seguenti caratteristiche:</para>
  <itemizedlist>
  	<listitem>
  		<para>Connessione a molte macchine allo stesso tempo.</para>
  	</listitem>
  	<listitem>
  		<para>Archivia connessioni recenti e permette di crearne dei segnalibri.</para>
  	</listitem>
  	<listitem>
  		<para>Browse local network for machines.</para>
  	</listitem>
  	<listitem>
  		<para>Provide a GNOME Panel applet to quickly access your bookmarked machines.</para>
  	</listitem>
  	<listitem>
  		<para>Extensible through its plugin structure.</para>
  	</listitem>
  </itemizedlist>

</section>

<!-- ============= Getting Started =========================== -->
<section id="getting-started">
	<title>Per iniziare</title>

<!-- ============= To Start vinagre ========================== -->

	<section id="getting-started-to-start">
		<title>Avviare Vinagre</title>
		<para>Si può avviare <application>Vinagre</application> nei seguenti modi:</para>
		<variablelist>
				<varlistentry>
				<term>Menù <guimenu>Applicazioni</guimenu></term>
				<listitem>
	    	<para>Scegliere <menuchoice><guisubmenu>Internet</guisubmenu><guimenuitem>Visualizzatore di desktop remoti</guimenuitem></menuchoice>.</para>
				</listitem>
				</varlistentry>
				<varlistentry>
				<term>Riga di comando</term>
    		<listitem>
    		<para>Eseguire il seguente comando: <command>vinagre</command></para>
    		</listitem>
    		</varlistentry>
		</variablelist>
	</section>

<!-- ============= To Start vinagre in command-line ======== -->
	<section id="getting-started-run-from-cmd-line">
		<title>Starting Vinagre from a command line</title>
		<para>You can run <application>Vinagre</application> from a command line and connect to a single machine or multiple machines. To connect to a machine from a command line, type the following command, then press <keycap>Return</keycap>:</para>
		<para><command>vinagre <replaceable>hostname_or_ip_address</replaceable></command></para>
		<para>For more information on how to run <application>Vinagre</application> from a command line, see the unix manual page for Vinagre, <ulink url="man:vinagre" type="man"><citerefentry><refentrytitle>Vinagre</refentrytitle><manvolnum>1</manvolnum></citerefentry></ulink>.</para>
	</section>


<!-- ============= vinagre window ========================== -->

	<section id="getting-started-the-window">
		<title>La finestra di Vinagre</title>
		<figure id="vinagre-window">
			<title>Finestra di Vinagre</title>
		  <screenshot>
			 <mediaobject>
				<imageobject>
				  <imagedata fileref="figures/vinagre-screenshot.png" format="PNG"/>
					 </imageobject>
				<textobject> <phrase>Mostra la finestra principale di Vinagre.</phrase>
				</textobject>
			</mediaobject>
		  </screenshot>
		</figure>
		
		<para>La finestra di <application>Vinagre</application> contiene i seguenti elementi:</para>
		
		<variablelist>
			<varlistentry>
				<term>Barra del menù</term>
				<listitem>
					<para>I menù nella barra del menù contengono tutti i comandi di cui si ha bisogno per lavorare con le connessioni remote in <application>Vinagre</application>.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Barra degli strumenti</term>
				<listitem>
					<para>La barra degli strumenti contiene un sottoinsieme dei comandi maggiormente utilizzati che possono essere acceduti dalla barra del menù.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Area di visualizzazione</term>
				<listitem>
					<para>L'area di visualizzazione contiene un elenco di schede con le macchine connesse e i loro desktop remoti.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Barra di stato</term>
				<listitem>
					<para>La barra di stato visualizza informazioni sull'attività corrente di <application>Vinagre</application> e informazioni contestuali sulle voci di menù.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Riquadro laterale</term>
				<listitem>
					<para>The side pane contains a list of bookmarked connections and (if available) a list of auto-discovered network machines.</para>
				</listitem>
			</varlistentry>
		</variablelist>
	</section>

<!-- ============= notes about vinagre ========================== -->
	<section id="getting-started-notes">
		<title>Some notes about Vinagre</title>
		<para>As a tool to access other machines, Vinagre behaves slightly different than other <systemitem>GNOME</systemitem> applications in its default installation.</para>
		<para>Vinagre comes with menu accelerators and keyboard shortcuts disabled by default. This avoids keys being intercepted by Vinagre when you wanted to send those keys to the remote machine.</para>
		<para>For instance, the keyboard shortcut to close a tab is <guilabel>Ctrl+W</guilabel>, but that key combination will be sent to the remote machine by default.</para>
		<para>If you want to change this behavior, go to Vinagre preferences in
			<menuchoice>
	  			<guimenu>Edit</guimenu>
	  			<guimenuitem>Preferences</guimenuitem>
	  		</menuchoice>.

		</para>
	</section>

</section>

<section id="using">
  <title>Utilizzare Vinagre</title>
  
  <section id="connect">
  	<title>To connect to a remote machine</title>
  
	  <section id="connect-informing-data">
	  	<title>Informing a host address</title>
	  	<para>To connect with a remote machine, choose 
		  	<menuchoice>
		  		<shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut>
		  		<guimenu>Machine</guimenu>
		  		<guimenuitem>Connect</guimenuitem>
		  	</menuchoice>. The <guilabel>Connection Dialog</guilabel> is displayed. 
		  	Inform the <guilabel>Protocol</guilabel> and the <guilabel>Host</guilabel> of 
		  	the connection and click the <guibutton>Connect</guibutton> button. You will see a bunch of
		  	options depending on what protocol you have selected.
		  </para>

		<figure id="connect-dialog">
			<title>Connect dialog</title>
		  <screenshot>
			 <mediaobject>
				<imageobject>
				  <imagedata fileref="figures/vinagre-connect-dialog.png" format="PNG"/>
					 </imageobject>
				<textobject> <phrase>Shows the connect dialog.</phrase>
				</textobject>
			</mediaobject>
		  </screenshot>
		</figure>

		  <para>
		  You can also use the <guibutton>Find</guibutton> button to browse available machines on local network.
		  </para>
		  <note>
		  	<para>
			  	The availabity of the <guibutton>Find</guibutton> button depends on the protocol you
			  	have selected. Vinagre relies on <application>Avahi</application> service to browse for
			  	machines in your local network. Also, notice that Vinagre can be compiled without
			  	<application>Avahi</application> support. In this case, this button will not be available.
		  	</para>
		  </note>

	  	<para>
		  	Some machines may require a secure connection. In this case, an 
		  	<guilabel>Authentication</guilabel> dialog will be displayed asking for the credentials.
		  	The type of credentials depends on the server. It may be a password and an username.
		  	If you check <guilabel>Remember this credential</guilabel>, <application>Vinagre</application> will store 
		  	the secure information using <application>GNOME Keyring Manager</application>.
	  	</para>
		<figure id="connect-auth-needed">
			<title>Authentication dialog</title>
		  <screenshot>
			 <mediaobject>
				<imageobject>
				  <imagedata fileref="figures/vinagre-auth-needed.png" format="PNG"/>
					 </imageobject>
				<textobject><phrase>Shows the authentication dialog.</phrase></textobject>
			</mediaobject>
		  </screenshot>
		</figure>

		  <para>Se la connessione è stata utilizzate precedentemente, si può anche accedervi da <menuchoice><guimenu>Macchina</guimenu><guimenu>Connessioni recenti...</guimenu></menuchoice>.</para>
	  </section>
	  
	  <section id="connect-opening-file">
	  	<title>Aprire un file di connessione remota</title>
	  	<para>Alcuni host distribuiscono i file di connessione remota (generalmente finiscono con il suffisso ".vnc") invece di inserire la porta e l'indirizzo dell'host. Per aprire un file di connessione remota, scegliere <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut><guimenu>Macchina</guimenu><guimenuitem>Apri</guimenuitem></menuchoice>. Il dialogo <guilabel>Seleziona file</guilabel> viene visualizzato. Selezionare il file che si vuole aprire e poi fare clic sul pulsante <guibutton>Apri</guibutton>.</para>
	  	
	  	<tip>
	  		<para>Si può anche fare doppio clic su un file di connessione remota nel gestore file <application>Nautilus</application> per aprirlo nella finestra di <application>Vinagre</application>.</para>
	  	</tip>
	  </section>

	  <section id="connect-using-bookmarks">
	  	<title>Using Bookmarks</title>
	  	<para>You can access your mostly used connections through bookmarks. See the
	  	<link linkend="bookmarks">Bookmarks chapter</link>.
	  	</para>
	  </section>

	</section>
	
	<section id="fullscreen">
		<title>Utilizzare la modalità a schermo intero</title>
		<para>To zoom the Display Area to full screen mode, choose 
			<menuchoice>
				<shortcut><keycap>F11</keycap></shortcut>
				<guimenu>View</guimenu>
				<guimenuitem>Full Screen</guimenuitem>
			</menuchoice> or the corresponding tool bar button.
		</para>
		<note>
			<para>
				While in full screen mode, move the mouse to the top center of the screen
				to show a hidden tool bar, which has buttons to leave full screen mode,
				close the connection and other options.
			</para>
		</note>
	</section>
	 
	<section id="close">
		<title>Chiudere una connessione</title>
		<para>Per chiudere una connessione, scegliere <menuchoice><guimenu>Macchina</guimenu><guimenuitem>Chiudi</guimenuitem></menuchoice>.</para>
	</section>
	
	<section id="screenshot">
		<title>Catturare una schermata</title>
		<para>Per catturare una schermata del desktop remoto corrente, scegliere <menuchoice><guimenu>Macchina</guimenu><guimenu>Cattura schermata</guimenu></menuchoice> o premere il pulsante relativo nella barra degli strumenti. Il dialogo <guilabel>Cattura schermata</guilabel> viene visualizzato, fare clic sul pulsante <guibutton>Salva</guibutton> per salvare la schermata.</para>
	</section>

</section>


<section id="bookmarks">
	<title>Using Bookmarks</title>

	<section id="bookmarks-using">
		<title>Using Bookmarks</title>
		<para>Bookmarks are a resource to keep around machines you access frequently.
		They are visible at side panel or in the <guimenu>Bookmarks</guimenu> menu.
		</para>

		<figure id="bookmarks-side-panel">
			<title>Bookmarks at side panel</title>
		  <screenshot>
			 <mediaobject>
				<imageobject>
				  <imagedata fileref="figures/vinagre-bookmarks-side-panel.png" format="PNG"/>
					 </imageobject>
				<textobject> <phrase>Shows bookmarks at side panel.</phrase>
				</textobject>
			</mediaobject>
		  </screenshot>
		</figure>

		<para>As you move the mouse around the entries, a tooltip will show you the hostname
		of the connection. To connect to a machine, just double click on a entry.
		</para>

	</section>

	<section id="bookmarks-add">
		<title>Creare un nuovo segnalibro</title>
		<para>To bookmark the currently viewed connection, choose 
			<menuchoice>
				<shortcut><keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></shortcut>
				<guimenu>Bookmarks</guimenu>
				<guimenuitem>Add to Bookmarks</guimenuitem>
			</menuchoice>. The <guilabel>Saving to Bookmarks</guilabel> dialog is displayed. 
			Inform the name of the connection and optionally other data, such as the folder and click <guibutton>Save</guibutton>.
		</para>

		<figure id="bookmarks-saving">
			<title>Saving a bookmark</title>
		  <screenshot>
			 <mediaobject>
				<imageobject>
				  <imagedata fileref="figures/vinagre-saving-bookmarks.png" format="PNG"/>
					 </imageobject>
				<textobject> <phrase>Shows the Saving to Bookmarks dialog.</phrase>
				</textobject>
			</mediaobject>
		  </screenshot>
		</figure>

		<note>
			<para>You can use folders to organize your bookmarks. To create a folder, right click
			in the side panel and choose the option <guimenu>New Folder</guimenu> in the context menu,
			or go to menu
				<menuchoice>
					<guimenu>Bookmarks</guimenu>
					<guimenu>New Folder</guimenu>
				</menuchoice>.
			</para>
		</note>

	</section>
	
	<section id="bookmarks-edit">
		<title>Modificare le proprietà di un segnalibro</title>
		<para>
			To edit a bookmark's properties, such as it's name and host, choose <guimenuitem>Edit bookmark</guimenuitem> 
			from the context menu of the bookmark in the Side Pane. The same dialog as shown above will be displayed.
		</para>

		<figure id="bookmarks-editing">
			<title>Editing a bookmark</title>
		  <screenshot>
			 <mediaobject>
				<imageobject>
				  <imagedata fileref="figures/vinagre-editing-bookmarks.png" format="PNG"/>
					 </imageobject>
				<textobject> <phrase>Context menu option to edit a bookmark</phrase>
				</textobject>
			</mediaobject>
		  </screenshot>
		</figure>

		<note><para>You can also edit a folder.</para></note>
	</section>

	<section id="bookmarks-remove">
		<title>Rimuovere un segnalibro</title>
		<para>
			To remove a bookmark, choose <guilabel>Remove from bookmarks</guilabel> from the context menu 
			of the bookmark in the Side Pane.
		</para>
		<note><para>You can also remove a folder. Notice that removing a folder will remove all its entries. A confirmation dialog will be shown.</para></note>
	</section>

</section>

<section id="preferences">
	<title>Preferences</title>
	<para>To configure <application>Vinagre</application>, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>. The <guilabel>Preferences</guilabel> dialog contains the following items:</para>

	<variablelist>
		<varlistentry>
			<term><guilabel>Always show tabs</guilabel></term>
			<listitem>
				<para>Select this option to make the tabs always visible, even when only one connection is active.</para>
			</listitem>
		</varlistentry>

		<varlistentry>
			<term><guilabel>Show menu shortcuts</guilabel></term>
			<listitem>
				<para>By selecting this option, keyboard shortcuts, like <guilabel>Ctrl+D</guilabel>
				and menu accelerators, like <guilabel>Alt+M</guilabel> to access the Machine menu, will be enabled.
				This means that Vinagre will catch those key combinations, instead of sending them to the remote machine. Because most of the time you will be
				working on the remote machine, this option comes <guilabel>disabled</guilabel> by default.
				</para>
			</listitem>
		</varlistentry>
	</variablelist>
</section>

<section id="about">
  <title>Informazioni</title>
  <para>
    Vinagre was written by Jonh Wendell <email>wendell@bani.com.br</email>.
    To find more information about Vinagre, please visit the
    <ulink url="http://projects.gnome.org/vinagre/" type="http"><application>Vinagre</application> web page</ulink>.
  </para>
  <para>Per segnalare un errore o dare un suggerimento riguardo questa applicazione si può compilare un errore nel <ulink url="http://bugzilla.gnome.org/browse.cgi?product=vinagre" type="http">tracker di errori</ulink>.</para>
  <para>Questo programma è distribuito secondo i termini della licenza GNU General Public License, come pubblicata dalla Free Software Foundation; versione 2 della licenza, o (a scelta) una versione più recente. Una copia di questa licenza può essere trovata sul <ulink url="http://www.gnu.org/licenses/gpl.html" type="http">sito di GNU</ulink>, o nel file COPYING includo con il codice sorgente di questo programma.</para>
</section>

</article>
