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

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

  <section id="tools-run-app">
    <title>Ejecutar aplicaciones</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <primary>Diálogo Ejecutar Aplicación, usar</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>Abre el diálogo <guilabel>Ejecutar aplicación</guilabel> en cualquiera de las siguientes formas: <variablelist>
          <varlistentry><term>Desde un panel</term>
          <listitem><para>Puede añadir el botón <application>Ejecutar aplicación</application> a cualquier panel. Vea la <xref linkend="panels-addobject"/>. Pulse el botón <guibutton>Ejecutar aplicación</guibutton> del panel para abrir el diálogo <guilabel>Ejecutar aplicación</guilabel>.</para></listitem></varlistentry>
          <varlistentry><term>Usar combinaciones de teclas</term>
          <listitem>
            <para>Pulse <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. Puede cambiar las teclas de acceso que muestran el diálogo <guilabel>Ejecutar aplicación</guilabel> en la herramienta de preferencias <link linkend="prefs-keyboard-shortcuts"><application>Combinaciones de teclas</application></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>capturar pantallas</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>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><keycombo><keycap>Alt</keycap><keycap>Imprimir pantalla</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>Elija <menuchoice><guimenu>Aplicaciones</guimenu><guimenuitem>Accesorios</guimenuitem><guimenuitem>Tomar captura</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>Desde el terminal</para>
      <para>Puede usar el comando <command>gnome-screenshot</command> para tomar una captura de pantalla. El comando <command>gnome-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>gnome-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>segundos</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 GNOME 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>Ventana del <application>Visor de ayuda Yelp</application></title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure>El<application>Visor de ayuda Yelp</application>, contiene los elementos siguientes en <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>Barra de menú</interface></term>

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

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

                <varlistentry>
                  <term><guimenu>Ir</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>Marcadores</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Ayuda</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>Barra de herramientas</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guibutton>Atrás</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>Adelante</guibutton></term>

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

                <varlistentry>
                  <term><guibutton>Temas de ayuda</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>Panel de visualización</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>Para abrir un documento en el <application>Visor de ayuda Yelp</application>: <itemizedlist>
		<listitem>
			<para>En una aplicación pulse <menuchoice><guimenu>Ayuda</guimenu><guimenuitem>Índice</guimenuitem></menuchoice></para>
		</listitem>	  
		<listitem>
			<para>Use la Tabla de contenidos para navegar al documento deseado.</para>
		</listitem>
		<listitem>
			<para>Puede arrastrar un archivo Docbook XML desde Nautilus en la ventana o el lanzador de Yelp.</para>
		</listitem>
		<listitem>
			<para>Pulse la tecla <keycap>F1</keycap>.</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>Pulse en <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Ventana nueva</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>Pulse <menuchoice><guimenu>File</guimenu><guimenuitem>Acerca de este documento</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>Pulse en <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Imprimir esta página</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>Pulse <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Imprimir este documento</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>Pulse <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Cerrar ventana</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>Pulse <menuchoice><guimenu>Editar</guimenu><guimenuitem>Preferencias</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist>Aparecerá una ventana semejante a la <xref linkend="yelp-preferences"/>:</para>

      <para><figure id="yelp-preferences">
          <title>Ventana de preferencias del <application>Visor de ayuda Yelp</application></title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>Las opciones que están disponibles en este diálogo tienen las siguientes funciones:</para>

      <para><variablelist>
          <varlistentry>
            <term><guilabel>Usar tipografía del sistema</guilabel></term>

            <listitem>
              <para>Marque esta opción para mostrar la documentación usando la tipografía predeterminada usada por el Escritorio GNOME.</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>Anchura variable</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>Anchura fija</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>Navegar con el cursor</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>Pulse en <menuchoice><guimenu>Ir</guimenu><guimenuitem>Atrás</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>Pulse <menuchoice><guimenu>Ir</guimenu><guimenuitem>Adelante</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>Pulse <menuchoice><guimenu>Ir</guimenu><guimenuitem>Temas de ayuda</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>Pulse <menuchoice><guimenu>Ir</guimenu><guimenuitem>Sección anterior</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>Pulse <menuchoice><guimenu>Ir</guimenu><guimenuitem>Sección siguiente</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>Pulse <menuchoice><guimenu>Ir</guimenu><guimenuitem>Contenido</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>Pulse <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Añadir marcador</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Use la combinación de teclas <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>Aparecerá una ventana que se parecerá a la <xref linkend="yelp-add-bookmark"/>.</para>

      <para><figure id="yelp-add-bookmark">
          <title>Ventana de añadir un marcador</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Introduzca el título de su marcador deseado en el campo de entrada <guilabel>Título</guilabel>. Después pulse <guibutton>Añadir</guibutton> para añadir el marcador, o pulse <guibutton>Cancelar</guibutton> para cancelar la petición.</para>
    </section>

    <section>
      <title>Editar marcadores</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Pulse <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Editar marcadores...</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Use la combinación <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>Aparecerá una ventana que se parecerá a <xref linkend="yelp-edit-bookmarks"/>.</para>

      <para><figure id="yelp-edit-bookmarks">
          <title>Ventana de edición de marcadores</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>Puede gestionar sus marcadores usando esta ventana de las siguientes maneras:</para>

      <para><variablelist>
          <varlistentry>
            <term><guibutton>Abrir</guibutton></term>

            <listitem>
              <para>Use este botón para abrir el marcador seleccionado en una ventana nueva.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Renombrar</guibutton></term>

            <listitem>
              <para>Use este botón para renombrar el título de su marcador.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Quitar</guibutton></term>

            <listitem>
              <para>Use este botón para borrar el marcador de su colección.</para>
            </listitem>
          </varlistentry>
        </variablelist>Una vez que haya finalizado de gestionar sus marcadores, pulse el botón  <guibutton>Cerrar</guibutton> para salir de la <interface>Ventana de edición de marcadores</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>Pulse <menuchoice><guimenu>Ayuda</guimenu><guimenuitem>Contenido</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>Nautilus</application>, o arrastre el icono desde <application>Nautilus</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/gnome/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>ghelp:</option> o <option>gnome-help:</option></term>

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

              <screen><userinput>yelp ghelp: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 ghelp: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 GNOME</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Facilitar la traducción de documentos a diferentes idiomas.</para>
          </listitem>

          <listitem>
            <para>Proporcionar un conjunto de herramientas para ayudar empaquetar e instalar la documentación en el lugar correcto y registrar la documentación en scrollkeeper.</para>
          </listitem>

          <listitem>
            <para>Efectuar la conversión de formato DocBook a un formato apropiado para mostrarlo.</para>
          </listitem>
        </itemizedlist>El <application>Visor de ayuda Yelp</application> se basa en las <ulink url="ghelp:gnome-doc-xslt">hojas de estilo GNOME XSLT </ulink> para realizar la conversión de DocBook a HTML. Las <ulink url="ghelp:gnome-doc-make">Utilidades de Construcción de Documentación de GNOME</ulink> se basan en que por cada aplicación los autores instalan y registran documentación dentro del sistema de ayuda.</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/gnome-doc-devel-list">gnome-doc-devel-list@gnome.org</ulink>.</para>
    </section>
  </section>

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

    <para>Si está interesado en ayudar a producir y actualizar documentación para el Proyecto GNOME, 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>
