<?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="zh_CN">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->

  <articleinfo>
    <title><application>Vinagre</application> 手册</title>
    <abstract role="description">
      <para><application>Vinagre</application> 是一个远程桌面查看器</para>
    </abstract>
    <copyright>
      <year>2007, 2008, 2009</year>
      <holder>Jonh Wendell (wendell@bani.com.br)</holder>
    </copyright><copyright><year>2009.</year><holder>TeliuTe (teliute@163.com)</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>对于本文档的复制、分发和/或修改必须遵循自由软件基金会 (Free Software Foundation) 发布的 GNU 自由文档许可证 (GFDL) 版本 1.1 或更高版本，该许可证没有固定的部分、没有封面和背页文本。您可以在此<ulink type="help" url="ghelp:fdl">链接</ulink>上或在随本手册一起分发的 COPYING-DOCS 文件中找到 GFDL 的副本。</para>
         <para>本手册是在 GFDL 许可之下分发的 GNOME 手册集合的一部分。如果想要单独分发此手册，可以在手册中添加该许可证的一份副本然后分发，如该许可证的第 6 部分所述。</para>

	<para>各个公司使用的许多用于区别它们产品和服务的名称都声明为商标。在所有的 GNOME 文档以及 GNOME 文档项目的成员中，这些名称都是以全大写字母或首字母大写显示，从而表明它们是商标。</para>

	<para>本文档以及文档的修改版本都是在遵循 GNU 自由文档许可证的条款下提供，这表示具有以下含义：<orderedlist>
		<listitem>
		  <para>文档按“原样”提供，不提供任何明示或暗示的保证，包括但不限于：文档或文档的修改版本没有适销性方面的缺陷、适合特定目的的适用性，以及没有侵权行为。您将自行承担本文档以及文档修改版本的质量、准确性以及性能方面的风险。如果任何文档或文档修改版本存在缺陷，您(而不是最初的编写者、作者或撰写人)将承担所有必需的服务、维修或更正的费用。此免责声明是本许可证的重要组成部分。如果不接受此免责声明，那么您就没有权利使用任何文档或文档的修改版本；并且</para>
		</listitem>
		<listitem>
		  <para>无论在任何情况以及在任何法律理论下，本文档或文档修改版本的作者、最初的编写者、任何撰写人或任何分发者，或者任意这些方的任何提供者都不对任何人由于使用本文档或文档修改版本引起或带来的任何直接的、间接的、特殊的、偶然的或继发的损失承担任何民事(包括疏忽)、合同或其它方面的责任，这些损失包括但不限于信誉损失、工作停止、计算机失败或故障，或任何以及所有其它损失或由此引发的或与之相关的损失，即使这些方已被告知存在出现此类损失的可能性时也是如此。</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>2008-01-15</date>
        <revdescription>
          <para role="author">Vinicius Depizzol <email>vdepizzol@gmail.com</email></para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>0.1</revnumber>
        <date>2007-12-16</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>反馈</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>远程桌面</primary>
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<section id="intro">
  <title>介绍</title>
  <!-- manrevision 2.0 compatibility -->
  <anchor id="aboutex"/>
  <anchor id="notice"/>
  <indexterm>
    <primary><application>Vinagre</application></primary>
    <secondary>手册</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> 提供了以下特性：</para>
  <itemizedlist>
  	<listitem>
  		<para>同时连接多台计算机。</para>
  	</listitem>
  	<listitem>
  		<para>存储最近的连接，并添加到书签中。</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>快速入门</title>

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

	<section id="getting-started-to-start">
		<title>运行 Vinagre</title>
		<para>您可以用下面的方法来运行 <application>Vinagre</application>：</para>
		<variablelist>
				<varlistentry>
				<term><guimenu>应用程序</guimenu> 菜单</term>
				<listitem>
	    	<para>点菜单 <menuchoice><guisubmenu>互联网</guisubmenu><guimenuitem>远程桌面查看器</guimenuitem></menuchoice>。</para>
				</listitem>
				</varlistentry>
				<varlistentry>
				<term>命令行</term>
    		<listitem>
    		<para>运行下面的命令： <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>Vinagre 窗口</title>
		<figure id="vinagre-window">
			<title>Vinagre 窗口</title>
		  <screenshot>
			 <mediaobject>
				<imageobject>
				  <imagedata fileref="figures/vinagre-screenshot.png" format="PNG"/>
					 </imageobject>
				<textobject> <phrase>显示 Vinagre 主窗口。</phrase>
				</textobject>
			</mediaobject>
		  </screenshot>
		</figure>
		
		<para><application>Vinagre</application> 窗口包含下列组件：</para>
		
		<variablelist>
			<varlistentry>
				<term>菜单栏</term>
				<listitem>
					<para>菜单栏里包括在 <application>Vinagre</application> 远程连接时，您可以用到的全部命令。</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>工具栏</term>
				<listitem>
					<para>工具栏包含您使用最多的菜单命令。</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>显示区</term>
				<listitem>
					<para>显示区包括连接的计算机列表和远程桌面。</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>状态栏</term>
				<listitem>
					<para>状态栏显示 <application>Vinagre</application> 活动信息，以及菜单项的相关信息。</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>侧边栏</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>使用 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>如果前面已经连接过，您可以点菜单 <menuchoice><guimenu>计算机</guimenu><guimenu>最近连接...</guimenu></menuchoice> 查找。</para>
	  </section>
	  
	  <section id="connect-opening-file">
	  	<title>打开一个远程连接文件</title>
	  	<para>一些主机会发布远程连接文件(通常是以“.vnc”结尾)，而不是主机地址和端口。要打开一个远程连接文件，点菜单 <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut><guimenu>计算机</guimenu><guimenuitem>打开</guimenuitem></menuchoice>，出来一个 <guilabel>选择文件</guilabel> 对话框。选中您想打开的文件，然后点 <guibutton>打开</guibutton> 按钮。</para>
	  	
	  	<tip>
	  		<para>您也可以在 <application>Nautilus</application> 文件管理器里，双击一个远程连接文件打开 <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>使用全屏模式</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>关闭一个连接</title>
		<para>要关闭一个连接，点菜单 <menuchoice><guimenu>计算机</guimenu><guimenuitem>关闭</guimenuitem></menuchoice>。</para>
	</section>
	
	<section id="screenshot">
		<title>抓取屏幕图片</title>
		<para>要抓取当前远程桌面的图片，点菜单 <menuchoice><guimenu>计算机</guimenu><guimenu>抓图</guimenu></menuchoice> 或者点一下工具栏上相应的按钮，在出来的 <guilabel>保存抓图</guilabel> 对话框里，点 <guibutton>保存</guibutton> 按钮，保存抓取的图片。</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>创建一个新的书签</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>编辑一个书签的属性</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>删除一个书签</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>关于</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>要报告这个程序的错误或提出建议，请发送报告文件到我们的 <ulink url="http://bugzilla.gnome.org/browse.cgi?product=vinagre" type="http"> bug 缺陷跟踪</ulink>。</para>
  <para>本程序依照自由软件基金会所发表的 GNU GPL 协议发行；使用第二版或者(如果您愿意)以后版本。协议的副本可以在  <ulink url="http://www.gnu.org/licenses/gpl.html" type="http">GNU 站点</ulink> 上找到，或者在包含在本程序源代码的 COPYING 文件中。</para>
</section>

</article>
