<?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="es">
    <info><title>Herramientas y herramientas</title>
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Toni Estevez</db:firstname>
      </db:personname>
      <db:email>toni.estevez@gmail.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2019</db:year>
      
      <db:holder>Toni Estevez</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Jorge González</db:firstname>
      </db:personname>
      <db:email>jorgegonz@svn.gnome.org</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2007-2010</db:year>
      
      <db:holder>Jorge González</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Francisco Javier F. Serrador</db:firstname>
      </db:personname>
      <db:email>serrador@cvs.gnome.org</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2003-2006</db:year>
      
      <db:holder>Francisco Javier F. Serrador</db:holder>
    </db:copyright>
  
    <db:othercredit class="translator">
      <db:personname>
        <db:firstname>Pablo Gonzalo del Campo</db:firstname>
      </db:personname>
      <db:email>pablodc@bigfoot.com</db:email>
    </db:othercredit>
    <db:copyright>
      
        <db:year>2002-2003</db:year>
      
      <db:holder>Pablo Gonzalo del Campo</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>Ejecutar aplicaciones</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>El diálogo <guilabel>Ejecutar una aplicación</guilabel> le da acceso a la línea de órdenes. Cuando ejecuta una orden en el diálogo <guilabel>Ejecutar una aplicación</guilabel>, no puede recibir salida de la orden.</para>
    <para>Para ejecutar una orden desde la línea de órdenes siga los pasos siguientes:</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>Se muestra el diálogo <guilabel>Ejecutar una aplicación</guilabel>.</para>
    </listitem>
    <listitem>
      <para>Introduzca la orden que quiere ejecutar en el campo vacío o escoja de la lista de aplicaciones conocidas.</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 elegir una orden que ya haya ejecutado previamente, haga clic en el botón de la flecha hacia abajo junto al campo de la orden, después elija la orden a ejecutar.</para>
      <para>También puede usar el botón <guibutton>Ejecutar con un archivo</guibutton> para elegir un archivo para añadir a la línea de órdenes. Por ejemplo, puede escribir la orden <application>pluma</application> y luego elegir un archivo para editar.</para>
      <para>Seleccione la opción <guilabel>Ejecutar en un terminal</guilabel> para ejecutar la aplicación o la orden en una ventana del terminal. Elija esta opción para una aplicación o una orden que no cree una ventana en la que ejecutarse.</para>
    </listitem>
    <listitem>
      <para>Haga clic en el botón <guibutton>Ejecutar</guibutton> en el diálogo <guilabel>Ejecutar una aplicación</guilabel>.</para>
    </listitem>
      </orderedlist>
  </section>

<section xml:id="tools-screenshot"><info><title>Capturar pantallas</title></info>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor xml:id="goseditmainmenu-53"/>
  <indexterm xml:lang="en">
    <primary>screenshots, taking</primary>
  </indexterm>
  <para>Puede tomar una captura de pantalla de cualquiera de las maneras siguientes:</para>
  <itemizedlist>
    <listitem>
      <para>Desde cualquier panel</para>
      <para>Puede añadir un botón de <guibutton>Tomar una captura de pantalla</guibutton> a cualquier panel. Para instrucciones de cómo hacer esto, consulte la <xref linkend="panels-addobject"/>. Haga clic en el botón <guibutton>Tomar una captura de pantalla</guibutton> para capturar la pantalla completa.</para>
    </listitem>
    <listitem>
      <para>Usar teclas de atajo</para>
      <para>Para tomar una captura de pantalla, use las teclas de atajo siguientes:</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>Teclas de atajo predeterminadas</para>
              </entry>
              <entry>
                <para>Función</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycap>Imprimir Pantalla</keycap></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Toma una captura de la pantalla completa.</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>Toma una captura de pantalla de la ventana activa.</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>Desde la barra de menús</para>
      <para>Elija <menuchoice><guimenu>Aplicaciones</guimenu><guimenuitem>Accesorios</guimenuitem> <guimenuitem>Tomar una captura de pantalla</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>Desde el terminal</para>
      <para>Puede usar la orden <command>mate-screenshot</command> para tomar una captura de pantalla. La orden <command>mate-screenshot</command> toma una captura de la pantalla completa y muestra el diálogo <guilabel>Guardar captura</guilabel>. Use el diálogo <guilabel>Guardar captura</guilabel> para guardar la captura.</para>
      <para>Puede usar opciones en la orden <command>mate-screenshot</command> como se indica a continuación:</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>Opción</para>
              </entry>
              <entry>
                <para>Función</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>Toma una captura de pantalla de la ventana que tiene el foco.</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>Toma una captura de pantalla tras el número de segundos especificados y muestra el diálogo <guilabel>Guardar captura de pantalla</guilabel>. Use el diálogo <guilabel>Guardar captura de pantalla</guilabel> para guardar la captura.</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>Toma una captura incluyendo el borde de la ventana.</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>Toma una captura de pantalla sin el borde de la ventana.</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>Toma una captura de pantalla y añade un borde sombreado.</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>Toma una captura de pantalla y añade un efecto de borde.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Abre una ventana que le permite establecer las opciones antes de tomar la captura.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Muestra las opciones para la orden.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para>Cuando toma una captura, se abre el diálogo <guilabel>Guardar captura</guilabel>. Para guardar la captura como un archivo de imagen, introduzca el nombre de archivo para la captura y elija una ubicación de la lista desplegable y haga clic en el botón <guilabel>Guardar</guilabel>. También puede usar el botón <guilabel>Copiar al portapapeles</guilabel> para copiar la imagen al portapapeles o transferirla a otra aplicación arrastrando y soltantándola.</para>
  
</section>

<!-- ============= Yelp ============================= -->
<section xml:id="yelp"><info><title>Visor de la ayuda Yelp</title></info>
  <indexterm xml:lang="en">
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section xml:id="yelp-introduction"><info><title>Introducción</title></info>
    <para>La aplicación <application>visor de la ayuda Yelp</application> le permite ver documentación concerniente a MATE y otros componentes a través de una variedad de formatos. Estos formatos incluyen archivos DocBook, páginas de ayuda HTML, páginas de manual y páginas info (la compatibilidad con las páginas man e info puede compilarse opcionalmente). A pesar de los diferentes formatos admitidos, Yelp hace todo lo posible proporcionar un aspecto y comportamiento uniformes independientemente del formato original del documento.</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>Iniciar Yelp</title></info>
  
    <section><info><title>Para iniciar el <application>visor de la ayuda Yelp</application></title></info>
      <para>Puede iniciar el <application>visor de la ayuda Yelp</application> de las formas siguientes:</para>

      <para><variablelist>
          <varlistentry>
            <term>Menú <guimenu>Sistema</guimenu></term>

            <listitem>
              <para>Elija <application>Ayuda</application></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Línea de órdenes</term>

            <listitem>
              <para>Ejecute la orden siguiente: <command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>Interfaz</title></info>
      <para>Cuando inicie el <application>visor de la ayuda Yelp</application>, aparecerá la ventana siguiente.</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>Barra de menú</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term xml:lang="en"><guimenu>File</guimenu></term>

                  <listitem>
                    <para>Use este menú para Abrir una Ventana nueva, ver los créditos de esta página de documentación, imprimir el documento actual o cerrar la ventana.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Use este menú para copiar, seleccionar, buscar... o para configurar sus preferencias.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Use este menú para navegar hacia atrás, hacia adelante y hacia la página de temas de ayuda. Al ver un documento DocBook, use este menú para navegar a la siguiente sección, a la sección anterior o al contenido.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Use este menú para Añadir marcadore(s), o Editar marcadores(s).</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Vea información sobre el visor de la ayuda Yelp y los contribuyentes al proyecto a través del elemento del menú <guimenuitem>Acerca de</guimenuitem>. Abra este documento con el elemento de menú <guimenuitem>Contenido</guimenuitem> o pulsando <keycap>F1</keycap>.</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Barra de herramientas</interface></term>

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

                  <listitem>
                    <para>Use este botón para navegar hacia atrás en el historial de documentos.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Use este botón para navegar hacia adelante en el historial de documentos.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Use este botón para volver a la tabla principal de contenidos (mostrado en <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>El panel del visor es donde se le presentará la tabla de contenidos o la documentación. Use la tabla de contenidos para navegar a la documentación que necesite.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

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

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

    <section><info><title>Abrir un documento</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>Alternativamente, puede ver un documento particular invocando el visor de la ayuda Yelp desde la línea de órdenes o arrastrando documentos a Yelp. Por favor consulte la <xref linkend="yelp-advanced-cmdline"/> para obtener más información sobre esto.</para>
    </section>

    <section><info><title>Abrir una ventana nueva</title></info>
      <para>Para abrir una ventana nueva:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

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

          <listitem>
            <para>Usa la combinación de teclas <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Acerca de este documento</title></info>
      <para>Para ver información sobre el documento abierto actualmente:</para>

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

                <guimenuitem>About This Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opción solo está disponible para la documentación DocBook. Los avisos legales y los contribuidores de la documentación se enumeran usualmente en esta sección.</para>
        </note></para>
    </section>

    <section><info><title>Imprimir una página</title></info>
      <para>Para imprimir cualquier página que sea capaz de ver en el <application>visor de la ayuda 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>Imprimir un documento</title></info>
      <para>Para imprimir un documento entero:</para>

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

                <guimenuitem>Print this Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opción solo está disponible para la documentación DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Cerrar una ventana</title></info>
      <para>Para cerrar una ventana en el <application>visor de la ayuda Yelp</application>, haga lo siguiente:</para>

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

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

          <listitem>
            <para>Use la combinación de teclas <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Configurar las preferencias</title></info>
      <para>Para configurar sus preferencias en el <application>visor de la ayuda 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>Marque esta opción para mostrar la documentación usando la tipografía predeterminada usada por el escritorio MATE.</para>

              <para>Para elegir su propia tipografía para mostrar documentación, desmarque esta opción y haga clic en los botones junto al texto <guilabel>Anchura variable</guilabel> o <guilabel>Anchura fija</guilabel>.</para>

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

                    <listitem>
                      <para>Esta es la tipografía que usa cuando una tipografía estática o de anchura fija no se requiere. La mayoría del texto será de este tipo.</para>
                    </listitem>
                  </varlistentry>

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

                    <listitem>
                      <para>Esta es la tipografía a usar cuando todos los caracteres de texto necesitan ser del mismo tamaño. Esta tipografía se usa normalmente para indicar órdenes, bloques de programa, u otro texto que caiga bajo estas categorías.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

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

            <listitem>
              <para>Haga clic en esta opción si quiere ver un cursor en el <xref linkend="yelp-browser-pane"/>. Esto le permite navegar por el documento más fácilmente al mostrar donde se encuentra el cursor en el documento.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>Retroceder en el historial de documentos</title></info>
      <para>Para retroceder en el historial de documentos:</para>

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

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

          <listitem>
            <para>Usa la combinación de teclas <keycombo><keycap>Alt</keycap><keycap>Izquierda</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>Avanzar en el historial de documentos</title></info>
      <para>Para avanzar en el historial de documentos:</para>

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

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

          <listitem>
            <para>Use la combinación de teclas <keycombo><keycap>Alt</keycap><keycap>Derecha</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>Ir a los temas de ayuda</title></info>
      <para>Para ir a los temas de la ayuda:</para>

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

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

          <listitem>
            <para>Use la combinación de teclas <keycombo><keycap>Alt</keycap><keycap>Inicio</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>Ir a la sección anterior</title></info>
      <para>Para ir a la sección anterior:</para>

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

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

          <listitem>
            <para>Use la combinación de teclas <keycombo><keycap>Alt</keycap><keycap>Arriba</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opción solo está disponible para los documentos formatea dos en DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Ir a la sección siguiente</title></info>
      

      <para>Ir a la sección siguiente:</para>

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

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

          <listitem>
            <para>Use la combinación de teclas <keycombo><keycap>Alt</keycap><keycap>Abajo</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opción solo está disponible para los documentos formatea dos en DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Ir al contenido</title></info>
      

      <para>Ir al contenido de un documento:</para>

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

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Esta opción solo está disponible para los documentos formatea dos en DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Añadir un marcador</title></info>
      

      <para>Para añadir un marcador para un documento particular:</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>Editar marcadores</title></info>
      <para>Para editar su colección de marcadores:</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>Obtener ayuda</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>Características avanzadas</title></info>

   <section xml:id="yelp-open-specific" xreflabel="Opening Specific Documents"><info><title>Abrir documentos específicos</title></info>

    <section xml:id="yelp-open-drag"><info><title>Abrir documentos desde el Gestor de archivos</title></info>
        <para>Para abrir un documento, tal como un archivo XML, desde el gestor de archivos, abra el documento en el Gestor de archivos <application>Caja</application>, o arrastre el icono desde <application>Caja</application> al panel de documentos de <application>Yelp</application> o al lanzador.</para>
    </section>

    <section xml:id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents"><info><title>Usar la línea de órdenes para abrir documentos</title></info>
      <para>El visor de la ayuda Yelp admite abrir documentos desde la línea de órdenes. Hay varios URI (Identificadores Uniformes de Recursos)  que se pueden usar. Estos incluyen:</para>

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

            <listitem>
              <para>Use este URI cuando quiera acceder a un archivo con yelp, por ejemplo:</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>Use este URI cuando quiera acceder a los documentos de ayuda de MATE, que están escritos normalmente en formato DocBook.</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>o</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>Use esta URI cuando quiera acceder a una página info de GNU en particular.</para>

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

    <section><info><title>Refrescar contenido bajo demanda</title></info>
      <para>El <application>visor de la ayuda Yelp</application> admite las teclas de atajo<keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>, que recargarán el documento DocBook que esté abierto actualmente. Esto permite a los desarrolladores ver cambios en los documentos a medida que los hacen.</para>
    </section>
  </section>

  <section xml:id="yelp-moreinfo"><info><title>Más información</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>El <application>visor de la ayuda Yelp</application> usa scrollkeeper para generar la tabla de contenido para la documentación DocBook y HTML,  y también para hacer un seguimiento de las traducciones para cada documento.</para>
    </section>

    <section><info><title>Herramientas de documentación de MATE</title></info>
      <para>La documentación distribuida con MATE usa este conjunto de herramientas para varias cosas:</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>Lista de correo y página web</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>Unirse al Proyecto de documentación de 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>
