<?xml version="1.0" encoding="utf-8"?>
<?db.chunk.max_depth 3?>
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:db="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="tools" xml:lang="zh-CN">
    <info><title>工具和实用程序</title>
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Christopher Meng</db:firstname>
      </db:personname>
      <db:email>i@cicku.me</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2012-2013</db:year>
      
      <db:holder>Christopher Meng</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>ravix</db:firstname>
      </db:personname>
      <db:email>dr.neemous@gmail.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2013</db:year>
      
      <db:holder>ravix</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Dianjin Wang</db:firstname>
      </db:personname>
      <db:email>1132321739qq@gmail.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2012</db:year>
      
      <db:holder>Dianjin Wang</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Cravix</db:firstname>
      </db:personname>
      <db:email>dr.neemous@gmail.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2013</db:year>
      
      <db:holder>Cravix</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>nyanyh</db:firstname>
      </db:personname>
      <db:email>rebuilty@gmail.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2013</db:year>
      
      <db:holder>nyanyh</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>liulitchi</db:firstname>
      </db:personname>
      <db:email>xingzuo88@qq.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2013</db:year>
      
      <db:holder>liulitchi</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>玉堂白鹤</db:firstname>
      </db:personname>
      <db:email>yjwork@qq.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2015</db:year>
      
      <db:holder>玉堂白鹤</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Mingye Wang</db:firstname>
      </db:personname>
      <db:email>arthur200126@gmail.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2015-2016</db:year>
      
      <db:holder>Mingye Wang</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>白铭骢</db:firstname>
      </db:personname>
      <db:email>jeffbai@aosc.xyz</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2015-2016</db:year>
      
      <db:holder>白铭骢</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>刘子兴</db:firstname>
      </db:personname>
      <db:email>liushuyu@aosc.xyz</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2015-2016</db:year>
      
      <db:holder>刘子兴</db:holder>
    </db:copyright>
  </info>

  <highlights>
    <para xml:lang="en">This section describes some tools and utilities in the MATE Desktop.</para>
  </highlights>

  <section xml:id="tools-run-app"><info><title>运行应用程序</title></info>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor xml:id="gospanel-23"/>
    <indexterm xml:lang="en">
      <primary>Run Application dialog, using</primary>
    </indexterm>
    <para><guilabel>运行应用程序</guilabel> 对话框可让您访问命令行。当您在 <guilabel>运行应用程序</guilabel> 对话框中运行命令时，您无法得到命令的输出。</para>
    <para>要从命令行运行命令，请按以下步骤操作：</para>
    <orderedlist>
      <listitem>
        <para xml:lang="en">Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term xml:lang="en">From a panel</term>
          <listitem><para xml:lang="en">You can add the <application>Run Application</application> button to any 
          panel. See <xref linkend="panels-addobject"/>. Click on the <guibutton>Run Application</guibutton> 
          panel button to open the <guilabel>Run Application</guilabel> dialog.</para></listitem></varlistentry>
          <varlistentry><term xml:lang="en">Using shortcut keys</term>
          <listitem>
            <para xml:lang="en">
              Press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. You can change 
              the shortcut keys that display the <guilabel>Run Application</guilabel> dialog
              in the <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool.
            </para>
          </listitem>
          </varlistentry>
        </variablelist>
      </para>
      <para>显示 <guilabel>运行程序</guilabel> 对话框。</para>
    </listitem>
    <listitem>
      <para>在空白处输入您想运行的命令，或者在已知程序列表中选择。</para>
      <para xml:lang="en">If you enter only the location of a file, an appropriate application will launch to open it.
      If you enter a web page address, your default web browser will open the page. Prefix the web page address with https://, as in https://mate-desktop.org.
      </para>
      <para>选择一个您先前运行的命令，点击命令栏旁边的向下箭头按钮，然后选择要运行的命令。</para>
      <para>您还可以点击 <guibutton>带文件运行</guibutton> 按钮，选择一个文件放在命令后面。例如，您可以输入 <application>emacs</application> 作为命令，然后选择一个文件来编辑。</para>
      <para>打勾选中 <guilabel>在终端里运行</guilabel> 选项，可以在终端窗口中运行程序或命令。如果一个程序或命令不能以窗口方式运行时，请选中此项。</para>
    </listitem>
    <listitem>
      <para>在 <guilabel>运行应用程序</guilabel> 对话框中点击 <guibutton>运行</guibutton> 按钮。</para>
    </listitem>
      </orderedlist>
  </section>

<section xml:id="tools-screenshot"><info><title>屏幕抓图</title></info>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor xml:id="goseditmainmenu-53"/>
  <indexterm xml:lang="en">
    <primary>screenshots, taking</primary>
  </indexterm>
  <para>您可以通过以下方式对屏幕抓图：</para>
  <itemizedlist>
    <listitem>
      <para>从任何面板</para>
      <para>您可以添加 <guibutton>抓图</guibutton> 按钮到任何面板。相关操作请参阅： <xref linkend="panels-addobject"/>。点击 <guibutton>抓图</guibutton> 按钮来抓取整个屏幕。</para>
    </listitem>
    <listitem>
      <para>使用快捷键</para>
      <para>要对屏幕抓图，请使用下列快捷键：</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>默认快捷键</para>
              </entry>
              <entry>
                <para>功能</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycap>Print Screen</keycap></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>获得整个屏幕的抓图</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en"><keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>对活动窗口截图。</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para xml:lang="en">You can use the <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool to modify the default shortcut keys.</para>
    </listitem>
    <listitem>
      <para>从菜单栏</para>
      <para xml:lang="en">Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>从终端</para>
      <para>您可以使用 <command>mate-screenshot</command> 命令来抓图。<command>mate-screenshot</command> 命令抓取整个屏幕并显示 <guilabel>保存图像</guilabel> 对话框。使用 <guilabel>保存图像</guilabel> 对话框来保存图像。</para>
      <para>您也可以像下面这样，在 <command>mate-screenshot</command> 命令中使用选项参数。</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>选项</para>
              </entry>
              <entry>
                <para>功能</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--window</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>对当前窗口截图。</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--delay=<replaceable>seconds</replaceable></command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>在预先设定的秒数后截图并且显示 <guilabel>保存图像</guilabel> 对话框。使用 <guilabel>保存图像</guilabel> 对话框来保存抓图。</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>包含窗口边框。</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>不包含窗口边框。</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>抓图并在图片四周添加立体阴影效果。</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>抓图并在图片四周添加边框效果。</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>进行屏幕抓图前打开一个窗口以便您设置选项。</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>显示命令的选项。</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para>当您抓图时，<guilabel>保存图像</guilabel> 对话框会打开。要保存抓图为一个图片文件，请输入文件名并且在下拉菜单中为它选择一个保存位置。</para>
  
</section>

<!-- ============= Yelp ============================= -->
<section xml:id="yelp"><info><title>Yelp 帮助浏览器</title></info>
  <indexterm xml:lang="en">
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section xml:id="yelp-introduction"><info><title>介绍</title></info>
    <para><application>Yelp 帮助浏览器</application> 程序允许您以多种格式查看关于 MATE 和其他组件的文档。这些格式包括 docbook 文件、HTML 帮助页面、man 页以及 info 页面（对于 man 和 info 页面的支持可以作为可选组件编译进去）。尽管支持多种不同格式，Yelp 尽可能提供统一的阅读界面。</para>

    <para xml:lang="en"><application>Yelp Help Browser</application> is internationalized, meaning that it has support
    to view documents in different languages. The documents must be localized
    or translated for each language and installed properly for Yelp Help
    Browser to be able to view them.</para>
  </section>

  <!-- ============= Getting Started  ================================ -->

  <section xml:id="yelp-getting-started"><info><title>启动 Yelp</title></info>
  
    <section><info><title>要启动 <application>Yelp 帮助浏览器</application></title></info>
      <para>您可以通过以下方式启动 <application>Yelp 帮助浏览器</application>：</para>

      <para><variablelist>
          <varlistentry>
            <term><guimenu>系统</guimenu> 菜单</term>

            <listitem>
              <para>选择 <application>帮助</application></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>命令行</term>

            <listitem>
              <para>执行下列命令：<command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>界面</title></info>
      <para>当您启动 <application>Yelp 帮助浏览器</application> 时，您将看到下列窗口。</para>

      <para xml:lang="en"><figure xml:id="fig-yelp-window"><info><title xml:lang="en"><application>Yelp Help Browser</application> Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Yelp Help Browser</application> contains the following elements in <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>菜单栏</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guimenu>文件</guimenu></term>

                  <listitem>
                    <para>使用这个菜单来打开新窗口、查看关于这个文档页面、打印当前文档或者关闭窗口。</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>编辑</guimenu></term>

                  <listitem>
                    <para>使用这个菜单来复制贝、全选、搜索... 或者可以设置程序的首选项。</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Go</guimenu></term>

                  <listitem>
                    <para>使用这个菜单来后退、前进、以及进入帮助主题页面。当查看一个 DocBook 文档时，使用这个菜单导航到下一个章节、前一个章节或者到达目录。</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Bookmarks</guimenu></term>

                  <listitem>
                    <para>使用此菜单添加或编辑书签。</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>帮助</guimenu></term>

                  <listitem>
                    <para>通过<guimenuitem>关于</guimenuitem> 菜单项来查看关于 Yelp 帮助浏览器和对项目有贡献者的信息。使用 <guimenuitem>内容</guimenuitem> 菜单项或者按下 <keycap>F1</keycap> 键来打开这个文档。</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>工具栏</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guibutton>返回</guibutton></term>

                  <listitem>
                    <para>使用此按钮在您的文档历史中后退。</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guibutton>Forward</guibutton></term>

                  <listitem>
                    <para>在文档历史中使用这个按钮来向前导航。</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>帮助主题</guibutton></term>

                  <listitem>
                    <para>使用这个按钮回到目录(在<xref linkend="fig-yelp-window"/> 中显示)。</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry xml:id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface xml:lang="en">Browser Pane</interface></term>

          <listitem>
            <para>您将在浏览栏看到目录或者文档。使用目录导航到您想查看的文档。</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

  <!--===================== Usage ========================-->

  <section xml:id="yelp-usage"><info><title>使用 Yelp</title></info>

    <section><info><title>打开文档</title></info>
      <para xml:lang="en">To open a document in <application>Yelp Help Browser</application>:
	  
	  <itemizedlist>
		<listitem>
			<para xml:lang="en">In an application, click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para xml:lang="en">Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para xml:lang="en">You can drag a Docbook XML file from Caja to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para xml:lang="en">Press the <keycap>F1</keycap> key.</para>
		</listitem>		
	  
	  </itemizedlist></para>
	  
      <para>或者，您也可以通过命令行调用 Yelp 帮助浏览器或者将文件拖至 Yelp 来查看一个特定的文档。更多相关信息，请参阅：<xref linkend="yelp-open-specific"/>。</para>
    </section>

    <section><info><title>打开新窗口</title></info>
      <para>要打开新窗口：</para>
	  
      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>New Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>使用组合键 <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>关于此文档</title></info>
      <para>查看关于当前已打开文档的信息：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>About This Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>这个选项只对 DocBook 文档有效。法律声明和文档贡献者常在这个部分列出。</para>
        </note></para>
    </section>

    <section><info><title>打印页面</title></info>
      <para>打印任何您在 <application>Yelp 帮助浏览器</application> 中浏览的页面：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Page</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>打印文档</title></info>
      <para>要打印整个文档：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>这个选项只对 DocBook 文档有效。</para>
        </note></para>
    </section>

    <section><info><title>关闭窗口</title></info>
      <para>要关闭 <application>Yelp 帮助浏览器</application>的一个窗口，操作如下：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Close Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>使用组合键 <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>设定首选项</title></info>
      <para>要在 <application>Yelp 帮助浏览器</application> 中设置相关参数选项：</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Edit</guimenu>

                <guimenuitem>Preferences</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-preferences"/>:</para>

      <para xml:lang="en"><figure xml:id="yelp-preferences"><info><title xml:lang="en"><application>Yelp Help Browser</application> Preferences Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>The options that are available in this dialog have the
      following functions:</para>

      <para><variablelist>
          <varlistentry>
            <term xml:lang="en"><guilabel>Use system fonts</guilabel></term>

            <listitem>
              <para>选中此项，使用 MATE 桌面默认字体来显示文档。</para>

              <para>要选择您自己的字体来显示文档，去掉这个选项前面的勾，并点击 <guilabel>非等宽字体</guilabel> 或 <guilabel>等宽字体</guilabel> 旁边的按钮。</para>

              <para><variablelist>
                  <varlistentry>
                    <term xml:lang="en"><guilabel>Variable Width</guilabel></term>

                    <listitem>
                      <para>这是在不需要使用固定或等宽字体时使用的字体。大部分的文本都会是这种字体。</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term xml:lang="en"><guilabel>Fixed Width</guilabel></term>

                    <listitem>
                      <para>这是在所有文本字符需要使用相同大小时使用的字体。这种字体通常被用来显示命令、程序块或者任何归入这些类别的其他文本。</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guilabel>Browse with caret</guilabel></term>

            <listitem>
              <para>如果您想在<xref linkend="yelp-browser-pane"/>中看到光标，请点击这个选项。在文档中显示光标的位置有助于您更容易的浏览文档。</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>在文档历史中后退</title></info>
      <para>要在文档历史中后退：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Back</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>使用组合键 <keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Back</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>在文档历史中前进</title></info>
      <para>要在文档历史中前进：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Forward</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>使用组合键 <keycombo><keycap>Alt</keycap><keycap>右方向键</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Forward</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>转到帮助主题</title></info>
      <para>要转到帮助主题：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Help Topics</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>使用组合键 <keycombo><keycap>Alt</keycap><keycap>Home 键</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Help Topics</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>回到上前一节</title></info>
      <para>要回到上一节：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Previous Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>使用组合键 <keycombo><keycap>Alt</keycap><keycap>上方向键</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>这个选项只对 DocBook 文档有效。</para>
        </note></para>
    </section>

    <section><info><title>转到下一节</title></info>
      

      <para>要转到下一节：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Next Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>使用组合键<keycombo><keycap>Alt</keycap><keycap>下方向键</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>这个选项只对 DocBook 文档有效。</para>
        </note></para>
    </section>

    <section><info><title>转到目录</title></info>
      

      <para>要转到文档的目录：</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>这个选项只对 DocBook 文档有效。</para>
        </note></para>
    </section>

    <section><info><title>添加书签</title></info>
      

      <para>为特定的文档添加书签：</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Bookmarks</guimenu>

                <guimenuitem>Add Bookmark</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-add-bookmark"/>.</para>

      <para xml:lang="en"><figure xml:id="yelp-add-bookmark"><info><title xml:lang="en">Add Bookmark Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Enter your desired bookmark title in to the
      <guilabel>Title</guilabel> text entry field. Then click
      <guibutton>Add</guibutton> to add the bookmark, or click
      <guibutton>Cancel</guibutton> to cancel the request.</para>
    </section>

    <section><info><title>编辑书签</title></info>
      <para>要编辑您收藏的书签：</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Bookmarks</guimenu>
                <guimenuitem>Edit Bookmarks...</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-edit-bookmarks"/>.</para>

      <para xml:lang="en"><figure xml:id="yelp-edit-bookmarks"><info><title xml:lang="en">Edit Bookmarks Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>You can manage your bookmarks using this window in the
      following ways:</para>

      <para xml:lang="en"><variablelist>
          <varlistentry>
            <term xml:lang="en"><guibutton>Open</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to open the selected bookmark in a new
              window.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guibutton>Rename</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to rename the title of your
              bookmark.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guibutton>Remove</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to delete the bookmark from your
              collection.</para>
            </listitem>
          </varlistentry>
        </variablelist>Once you are finished managing your bookmarks, click
      the <guibutton>Close</guibutton> button to exit the <interface xml:lang="en">Edit
      Bookmarks Window</interface>.</para>
    </section>

    <section><info><title>获得帮助</title></info>
      <para xml:lang="en">To get help to use <application>Yelp Help Browser</application> (and see this
      document):</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>
  </section>

  <!--=============== Advanced Features ====================-->

  <section xml:id="yelp-advanced"><info><title>高级特性</title></info>

   <section xml:id="yelp-open-specific" xreflabel="Opening Specific Documents"><info><title>打开指定文档</title></info>

    <section xml:id="yelp-open-drag"><info><title>从文件管理器打开文档</title></info>
        <para>要从文件管理器打开一个文档，比如一个 XML 文件，可以在 <application>Caja</application> 文件管理器中打开文件，或者把文件图标从 <application>Caja</application> 中拖拽到 <application>Yelp</application> 文件面板或启动器上。</para>
    </section>

    <section xml:id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents"><info><title>使用命令行打开文档</title></info>
      <para>Yelp 帮助浏览器支持从命令行打开文件。有一些 URI (统一资源标识符)可供使用，包括：</para>

      <variablelist>
          <varlistentry>
            <term xml:lang="en"><option>file:</option></term>

            <listitem>
              <para>使用这个 URI 以用 yelp 打开一个文档，比如：</para>

              <screen xml:lang="en"><userinput>yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>help:</option></term>

            <listitem>
              <para>但当您想打开典型的 DocBook 格式的 MATE 帮助文档时请使用这个 URI。</para>

              <screen xml:lang="en"><userinput>yelp help:mate-terminal</userinput></screen>

              <para xml:lang="en">If you want to open the help document at a particular section,
              append a slash to the end of the URI, followed by the section id.</para>
              
              <screen xml:lang="en"><userinput>yelp help:mate-user-guide/yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>man:</option></term>

            <listitem>
              <para xml:lang="en">Use this URI when you want to access a particular man
              page. You can append the section of the man page you would like
              to view if there are multiple man pages with the same
              name.  The section number should be enclosed in parentheses and 
              therefore it may be necessary to escape the argument so that the
              shell does not interpret the parenthesis.</para>

              <screen xml:lang="en"><userinput>yelp man:mate-panel</userinput></screen>
              
              <para>或</para>

              <screen xml:lang="en"><userinput>yelp 'man:intro(1)'</userinput>
<userinput>yelp 'man:intro(2)'</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>info:</option></term>

            <listitem>
              <para>当您想访问特定的 GNU info 页时，使用此链接。</para>

              <screen xml:lang="en"><userinput>yelp info:make</userinput></screen>
            </listitem>
          </varlistentry>
        </variablelist>
    </section>
   </section>

    <section><info><title>实时刷新内容</title></info>
      <para><application>Yelp 帮助浏览器</application> 支持 <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo> 快捷键，用于重新载入当前已打开的 DocBook 文档。这使开发者能够查看他们对文档做出的修改。</para>
    </section>
  </section>

  <section xml:id="yelp-moreinfo"><info><title>更多信息</title></info>
    <para xml:lang="en">This section details some helper applications which 
    <application>Yelp Help Browser</application> uses, and provides resources where you can get more information
    about <application>Yelp Help Browser</application>.</para>

    <section><info><title>Scrollkeeper</title></info>
      <para><application>Yelp 帮助浏览器</application> 使用 scrollkeeper 生成 DocBook 和 HTML 文档的目录表，并使每个文档的翻译明了。</para>
    </section>

    <section><info><title>MATE 文档实用工具</title></info>
      <para>MATE 的文档使用这套通用规则：</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Ease translation of documents to different languages.</para>
          </listitem>

          <listitem>
            <para xml:lang="en">Provide a set of tools to help package and install
            documentation into the correct location and register the
            documentation with scrollkeeper.</para>
          </listitem>

          <listitem>
            <para xml:lang="en">Perform conversion from DocBook format to a format suitable
            for display.</para>
          </listitem>
        </itemizedlist><application>Yelp Help Browser</application> relies on <link xlink:href="help:mate-doc-xslt">MATE XSLT
      Stylesheets</link> to perform conversion from DocBook to HTML.  <link xlink:href="help:mate-doc-make">MATE Documentation
      Build Utilities</link> are relied upon by application authors to install and register documentation within the help system.</para>
    </section>

    <section><info><title>主页与邮件列表</title></info>
      <para xml:lang="en">For further information on <application>Yelp Help Browser</application>, please visit the Documentation Project homepage, <uri xlink:href="http://mate-desktop.org">http://mate-desktop.org</uri>, or subscribe to
      the mailing list, <uri xlink:href="http://ml.mate-desktop.org/listinfo/mate-dev">http://ml.mate-desktop.org/listinfo/mate-dev</uri>.</para>
    </section>
  </section>

  <section xml:id="yelp-joininggdp"><info><title>加入 MATE 文档项目</title></info>
    <para xml:lang="en">If you are interested in helping produce and update documentation
    for the MATE project, please visit the Documentation Project homepage: <uri xlink:href="http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team">http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team</uri></para>
  </section>
</section>
</chapter>
