<?xml version="1.0" encoding="utf-8"?>
<!-- -*- indent-tabs-mode: nil -*- -->
<chapter id="tools" lang="es">
  <title>Herramientas y utilidades</title>

  <highlights>
    <para>Esta sección describe algunas de las herramientas y utilidades del escritorio MATE.</para>
  </highlights>

  <section id="tools-run-app">
    <title>Ejecutar aplicaciones</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <primary>Run Application dialog, using</primary>
    </indexterm>
    <para>El diálogo <guilabel>Ejecutar aplicación</guilabel> le da acceso a la línea de comandos. Cuando ejecuta un comando en el diálogo <guilabel>Ejecutar aplicación</guilabel>, no puede recibir salida del comando.</para>
    <para>Para ejecutar un comando desde la línea de comandos realice los pasos siguientes:</para>
    <orderedlist>
      <listitem>
        <para>Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term>From a panel</term>
          <listitem><para>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>Using shortcut keys</term>
          <listitem>
            <para>
              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 <link linkend="prefs-keyboard-shortcuts"><application>Keyboard Shortcuts</application> 
            preference tool</link>.</para>
          </listitem>
          </varlistentry>
        </variablelist>
      </para>
      <para>Se muestra el diálogo <guilabel>Ejecutar una aplicación</guilabel>.</para>
    </listitem>
    <listitem>
      <para>Introduzca el comando que quiere ejecutar en el campo vacío, o escoja de la lista de aplicaciones conocidas.</para>
      <para>Si sólo introduce la ubicación de un archivo, una aplicación apropiada se lanzará para abrirlo. Si introduce una dirección de una página web, su navegador predeterminado abrirá la página. Añada a la dirección de la página web http:// como en http://www.gnome.org.</para>
      <para>Para elegir un comando que ya haya ejecutado previamente, pulse el botón de la flecha hacia abajo junto al campo del comando, después elija el comando a ejecutar.</para>
      <para>Puede usar también el botón <guibutton>Ejecutar con archivo</guibutton> para elegir un archivo para añadir a la línea de comandos. Por ejemplo, puede introducir <application>emacs</application> como comando, después elegir un archivo para editar.</para>
      <para>Seleccione la opción <guilabel>Ejecutar en terminal</guilabel> para ejecutar la aplicación o comando en una ventana de terminal. Elija esta opción para una aplicación o comando que no cree una ventana en la cual ejecutarse.</para>
    </listitem>
    <listitem>
      <para>Pulse el botón <guibutton>Ejecutar</guibutton> en el diálogo <guilabel>Ejecutar aplicación</guilabel>.</para>
    </listitem>
      </orderedlist>
    </section>

<section id="tools-screenshot">
  <title>Capturar pantallas</title>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor id="goseditmainmenu-53"/>   
  <indexterm>
    <primary>screenshots, taking</primary>
  </indexterm>
  <para>Puede capturar una pantalla de cualquiera de las siguientes maneras:</para>
  <itemizedlist>
    <listitem>
      <para>Desde cualquier panel</para>
      <para>Puede añadir un botón de <guibutton>Capturar pantalla</guibutton> a cualquier panel. Para instrucciones de cómo hacer esto, vea la <xref linkend="panels-addobject"/>. Pulse el botón <guibutton>Capturar pantalla</guibutton> para capturar la pantalla completa.</para>
    </listitem>
    <listitem>
      <para>Usar combinaciones de teclas</para>
      <para>Para tomar una captura, use las siguientes combinaciones de teclas:</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>Combinaciones de teclas predeterminadas</para>
              </entry>
              <entry>
                <para>Función</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <keycap>Print Screen</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><keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Toma una captura de la ventana activa.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para>Puede usar la <link linkend="prefs-keyboard-shortcuts">herramienta de preferencias <application>combinaciones de teclas</application></link> para modificar las combinaciones de teclas predeterminadas.</para>
    </listitem>
    <listitem>
      <para>Desde la barra de menú</para>
      <para>Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>Desde el terminal</para>
      <para>Puede usar el comando <command>mate-screenshot</command> para tomar una captura de pantalla. El comando <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 el comando <command>mate-screenshot</command> como las 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>Opción</para>
              </entry>
              <entry>
                <para>Función</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--window</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Toma una captura de la ventana que tiene el foco.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <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>
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Toma una captura incluyendo el borde de la pantalla.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Toma una captura sin el borde de la pantalla.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Toma una captura y añade un borde sombreado alrededor.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Toma una captura y añade un efecto de borde alrededor.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <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>
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Muestra las opciones para el comando.</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 un lugar de la lista desplegable y pulse 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 id="yelp">
  <title>Visor de ayuda Yelp</title>
  <indexterm>
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section id="yelp-introduction">
    <title>Introducción</title>

    <para>La aplicación <application>Visor de 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 (el soporte para las páginas man e info puede compilarse opcionalmente). A pesar de los diferentes formatos soportados, Yelp hace lo mejor para proporcionar una apariencia unificada a pesar del formato original del documento.</para>

    <para>El <application>Visor de ayuda Yelp</application> está internacionalizado, lo cual significa que tiene soporte para ver documentos en diferentes idiomas. Los documentos deben ser localizados o traducidos para cada idioma e instalados apropiadamente para que el Visor de ayuda Yelp pueda ser capaz de verlos.</para>
  </section>

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

  <section id="yelp-getting-started">
    <title>Iniciar Yelp</title>

    <section>
      <title>Para iniciar el <application>Visor de ayuda Yelp</application></title>

      <para>Puede iniciar el <application>Visor de ayuda Yelp</application> de las siguientes formas:</para>

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

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

          <varlistentry>
            <term>Línea de comandos</term>

            <listitem>
              <para>Ejecute el siguiente comando: <command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section>
      <title>Interfaz</title>

      <para>Cuando inicie <application>Visor de ayuda Yelp</application>, verá aparecer la ventana siguiente.</para>

      <para><figure id="fig-yelp-window">
          <title><application>Yelp Help Browser</application> Window</title>

          <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>Menubar</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><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><guimenu>Edit</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Go</guimenu></term>

                  <listitem>
                    <para>Use este menú para navegar Atrás, Adelante, a la página de Temas de ayuda. Cuando vea un documento DocBook, use este menú para navegar a la Sección siguiente, Sección anterior, o al Contenido.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Bookmarks</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Help</guimenu></term>

                  <listitem>
                    <para>Vea información acerca del Visor de 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>Toolbar</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guibutton>Back</guibutton></term>

                  <listitem>
                    <para>Use este botón para navegar atrás en el histórico de su documento.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Forward</guibutton></term>

                  <listitem>
                    <para>Use este botón para navegar adelante en el histórico de su documento.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><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 id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface>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 id="yelp-usage">
    <title>Usar Yelp</title>

    <section>
      <title>Abrir un documento</title>

      <para>To open a document in <application>Yelp Help Browser</application>:
	  
	  <itemizedlist>
		<listitem>
			<para>In an application, click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para>Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para>You can drag a Docbook XML file from Caja to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para>Press the <keycap>F1</keycap> key.</para>
		</listitem>		
	  
	  </itemizedlist></para>
	  
      <para>Alternativamente, puede ver un documento particular invocando el visor de ayuda Yelp desde la línea de comandos o arrastrando documentos a Yelp. Por favor vea la <xref linkend="yelp-advanced-cmdline"/> para obtener más información sobre esto.</para>
    </section>

    <section>
      <title>Abrir una ventana nueva</title>

      <para>Para abrir una ventana nueva:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Acerca de este documento</title>

      <para>Para ver información acerca del documento abierto actualmente:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

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

    <section>
      <title>Imprimir una página</title>

      <para>Para imprimir cualquier página que sea capaz de ver en el <application>Visor de ayuda Yelp</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

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

    <section>
      <title>Imprimir un documento</title>

      <para>Para imprimir un documento entero:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

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

    <section>
      <title>Cerrar una ventana</title>

      <para>Para cerrar una ventana en el <application>Visor de ayuda Yelp</application>, haga lo siguiente:</para>

      <para><itemizedlist>
          <listitem>
            <para>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>
      <title>Establecer preferencias</title>

      <para>Para establecer sus preferencias en el <application>Visor de ayuda Yelp</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para>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><figure id="yelp-preferences">
          <title><application>Yelp Help Browser</application> Preferences Window</title>

          <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><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 pulse en los botones junto al texto <guilabel>Anchura variable</guilabel> o <guilabel>Anchura fija</guilabel>.</para>

              <para><variablelist>
                  <varlistentry>
                    <term><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><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 comandos, bloques de programa, u otro texto que caiga bajo estas categorías.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guilabel>Browse with caret</guilabel></term>

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

    <section>
      <title>Atrás en el histórico de documentos</title>

      <para>Para retroceder en el histórico de documentos:</para>

      <para><itemizedlist>
          <listitem>
            <para>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>Use el botón <guibutton>Atrás</guibutton> en la <interface>Barra de herramientas</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Adelantar en el histórico de documentos</title>

      <para>Para adelantar en el histórico de documentos:</para>

      <para><itemizedlist>
          <listitem>
            <para>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>Pulse el botón <guibutton>Adelante</guibutton> en la <interface>barra de herramientas</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Ir a los temas de ayuda</title>

      <para>Para ir a los temas de la ayuda:</para>

      <para><itemizedlist>
          <listitem>
            <para>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>Use el botón <guibutton>Temas de ayuda</guibutton> en la <interface>Barra de herramientas</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Ir a la sección anterior</title>

      <para>Para ir a la sección anterior:</para>

      <para><itemizedlist>
          <listitem>
            <para>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 sólo está disponible para los documentos formatea dos en DocBook.</para>
        </note></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>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 sólo está disponible para los documentos formatea dos en DocBook.</para>
        </note></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Go</guimenu>

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

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

      <para>Para añadir un marcador para un documento particular:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Bookmarks</guimenu>

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

          <listitem>
            <para>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><figure id="yelp-add-bookmark">
          <title>Add Bookmark Window</title>

          <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>
      <title>Editar marcadores</title>

      <para>Para editar su colección de marcadores:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Bookmarks</guimenu>
                <guimenuitem>Edit Bookmarks...</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>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><figure id="yelp-edit-bookmarks">
          <title>Edit Bookmarks Window</title>

          <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><variablelist>
          <varlistentry>
            <term><guibutton>Open</guibutton></term>

            <listitem>
              <para>Use this button to open the selected bookmark in a new
              window.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Rename</guibutton></term>

            <listitem>
              <para>Use this button to rename the title of your
              bookmark.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Remove</guibutton></term>

            <listitem>
              <para>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>Edit
      Bookmarks Window</interface>.</para>
    </section>

    <section>
      <title>Obtener ayuda</title>

      <para>Para obtener ayuda usando el <application>Visor de ayuda Yelp</application> (y ver este documento):</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Help</guimenu>

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

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

  <section id="yelp-advanced">
    <title>Características avanzadas</title>

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

    <section id="yelp-open-drag">
      <title>Abrir documentos desde el Gestor de archivos</title>
        <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 id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents">
      <title>Usar la línea de comandos para abrir documentos</title>

      <para>El visor de ayuda Yelp soporta abrir documentos desde la línea de comandos. Hay varias URIs (Identificadores Uniformes de Recursos)  que se pueden usar. Éstos incluyen:</para>

      <variablelist>
          <varlistentry>
            <term><option>file:</option></term>

            <listitem>
              <para>Use este URI cuando quiera acceder a un archivo con yelp, por ejemplo:</para>

              <screen><userinput>yelp file:///usr/share/mate/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>help:</option> o <option>mate-help:</option></term>

            <listitem>
              <para>Use este URI cuando quiera acceder a los documentos de ayuda de MATE, que están escritos típicamente en formato DocBook.</para>

              <screen><userinput>yelp help:gcalctool</userinput></screen>

              <para>Si quiere abrir el documento de ayuda en una sección particular, agregue una interrogación al final del URI, seguido del id de sección.</para>
              
              <screen><userinput>yelp help:user-guide?yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>man:</option></term>

            <listitem>
              <para>Use este URI cuando quiera acceder a una página man particular. Puede agregar la sección de la página man que quiere ver si hay varias páginas man con el mismo nombre. El número de sección debería encerrarse entre paréntesis y por lo tanto puede ser necesario escapar el argumento para la shell no interprete el paréntesis.</para>

              <screen><userinput>yelp man:gcalctool</userinput></screen>
              
              <para>o</para>

              <screen><userinput>yelp 'man:intro(1)'</userinput>
<userinput>yelp 'man:intro(2)'</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>info:</option></term>

            <listitem>
              <para>Use este URI cuando quiera acceder a una página GNU indo particular.</para>

              <screen><userinput>yelp info:make</userinput></screen>
            </listitem>
          </varlistentry>
        </variablelist>
    </section>

   </section>

    <section>
      <title>Refrescar contenido bajo demanda</title>

      <para>El <application>Visor de ayuda Yelp</application> soporta la combinación de teclas<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 id="yelp-moreinfo">
    <title>Más información</title>

    <para>Esta sección detalla algunas de las aplicaciones de ayuda que el <application>Visor de ayuda Yelp</application> usa, y proporciona recursos donde puede obtener más información acerca del  <application>Visor de ayuda Yelp</application>.</para>

    <section>
      <title>Scrollkeeper</title>

      <para>El <application>Visor de 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>
      <title>Utilidades de documentación de MATE</title>

      <para>La documentación distribuida con MATE usa este conjunto de utilidades para varias cosas:</para>

      <para><itemizedlist>
          <listitem>
            <para>Ease translation of documents to different languages.</para>
          </listitem>

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

    <section>
      <title>Lista de correo y página web</title>

      <para>Para más información acerca del <application>Visor de ayuda Yelp</application> visite la pagina web del Proyecto de Documentacion, <ulink url="http://live.gnome.org/Yelp">http://live.gnome.org/Yelp</ulink>, o suscríbase a la lista de correo, <ulink type="http" url="http://mail.gnome.org/mailman/listinfo/mate-doc-devel-list">mate-doc-devel-list@mate.org</ulink>.</para>
    </section>
  </section>

  <section id="yelp-joininggdp">
    <title>Unirse al Proyecto de Documentación de MATE</title>

    <para>Si está interesado en ayudar a producir y actualizar documentación para el Proyecto MATE, por favor visite la pagina web del Proyecto de Documentacion: <ulink url="http://live.gnome.org/DocumentationProject">http://live.gnome.org/Documentation Project</ulink></para>
  </section>

</section>

</chapter>
