# Herramientas y utilidades

Esta sección describe algunas de las herramientas y utilidades del escritorio GNOME.

## Ejecutar aplicaciones

El diálogo Ejecutar aplicación le da acceso a la línea de comandos. Cuando ejecuta un comando en el diálogo Ejecutar aplicación, no puede recibir salida del comando.

Para ejecutar un comando desde la línea de comandos realice los pasos siguientes:

1. Abre el diálogo Ejecutar aplicación en cualquiera de las siguientes formas:

   Desde un panel

2. Puede añadir el botón Ejecutar aplicación a cualquier panel. Vea la panels-addobject. Pulse el botón Ejecutar aplicación del panel para abrir el diálogo Ejecutar aplicación.

Usar combinaciones de teclas

- Pulse Alt F2. Puede cambiar las teclas de acceso que muestran el diálogo Ejecutar aplicación en la herramienta de preferencias Combinaciones de teclas.

Se muestra el diálogo Ejecutar una aplicación.

- Introduzca el comando que quiere ejecutar en el campo vacío, o escoja de la lista de aplicaciones conocidas.

  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 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.

  Puede usar también el botón Ejecutar con archivo para elegir un archivo para añadir a la línea de comandos. Por ejemplo, puede introducir emacs como comando, después elegir un archivo para editar.

  Seleccione la opción Ejecutar en terminal 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.

- Pulse el botón Ejecutar en el diálogo Ejecutar aplicación.

## Capturar pantallas

Puede capturar una pantalla de cualquiera de las siguientes maneras:

- Desde cualquier panel

  Puede añadir un botón de Capturar pantalla a cualquier panel. Para instrucciones de cómo hacer esto, vea la panels-addobject. Pulse el botón Capturar pantalla para capturar la pantalla completa.

- Usar combinaciones de teclas

  Para tomar una captura, use las siguientes combinaciones de teclas:

  Combinaciones de teclas predeterminadas | Función
  Imprimir pantalla | Toma una captura de la pantalla completa.
  Alt Imprimir pantalla | Toma una captura de la ventana activa.

  Puede usar la herramienta de preferencias combinaciones de teclas para modificar las combinaciones de teclas predeterminadas.

- Desde la barra de menú

  Elija Aplicaciones Accesorios Tomar captura.

- Desde el terminal

  Puede usar el comando `gnome-screenshot` para tomar una captura de pantalla. El comando `gnome-screenshot` toma una captura de la pantalla completa, y muestra el diálogo Guardar captura. Use el diálogo Guardar captura para guardar la captura.

  Puede usar opciones en el comando `gnome-screenshot` como las siguientes:

  Opción | Función
  `--window` | Toma una captura de la ventana que tiene el foco.
  `--delay=`segundos`` | Toma una captura de pantalla tras el número de segundos especificados, y muestra el diálogo Guardar captura de pantalla. Use el diálogo Guardar captura de pantalla para guardar la captura.
  `--include-border` | Toma una captura incluyendo el borde de la pantalla.
  `--remove-border` | Toma una captura sin el borde de la pantalla.
  `--border-effect=shadow` | Toma una captura y añade un borde sombreado alrededor.
  `--border-effect=border` | Toma una captura y añade un efecto de borde alrededor.
  `--interactive` | Abre una ventana que le permite establecer las opciones antes de tomar la captura.
  `--help` | Muestra las opciones para el comando.

Cuando toma una captura, se abre el diálogo Guardar captura. 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 Guardar. También puede usar el botón Copiar al portapapeles para copiar la imagen al portapapeles o transferirla a otra aplicación arrastrando y soltantándola.

## Visor de ayuda Yelp

### Introducción

La aplicación Visor de ayuda Yelp 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.

El Visor de ayuda Yelp 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.

### Iniciar Yelp

#### Para iniciar el Visor de ayuda Yelp

Puede iniciar el Visor de ayuda Yelp de las siguientes formas:

Menú Sistema

- Elija Ayuda

Línea de comandos

- Ejecute el siguiente comando: `yelp`

#### Interfaz

Cuando inicie Visor de ayuda Yelp, verá aparecer la ventana siguiente.

##### Ventana del Visor de ayuda Yelp

ElVisor de ayuda Yelp, contiene los elementos siguientes en fig-yelp-window

Barra de menú

- Archivo

- 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.

Editar

- Use este menú para copiar, seleccionar todo, buscar, o para establecer sus preferencias.

Ir

- 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.

Marcadores

- Use este menú para Añadir marcadore(s), o Editar marcadores(s).

Ayuda

- Vea información acerca del Visor de ayuda Yelp y los contribuyentes al proyecto a través del elemento del menú Acerca de. Abra este documento con el elemento de menú Contenido o pulsando F1.

Barra de herramientas

- Atrás

- Use este botón para navegar atrás en el histórico de su documento.

Adelante

- Use este botón para navegar adelante en el histórico de su documento.

Temas de ayuda

- Use este botón para volver a la tabla principal de contenidos (mostrado en fig-yelp-window).

Panel de visualización

- 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.

### Usar Yelp

#### Abrir un documento

Para abrir un documento en el Visor de ayuda Yelp:

- En una aplicación pulse Ayuda Índice

- Use la Tabla de contenidos para navegar al documento deseado.

- Puede arrastrar un archivo Docbook XML desde Nautilus en la ventana o el lanzador de Yelp.

- Pulse la tecla F1.

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 yelp-advanced-cmdline para obtener más información sobre esto.

#### Abrir una ventana nueva

Para abrir una ventana nueva:

- Pulse en Archivo Ventana nueva

- Usa la combinación de teclas Ctrl N

#### Acerca de este documento

Para ver información acerca del documento abierto actualmente:

- Pulse File Acerca de este documento

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.

#### Imprimir una página

Para imprimir cualquier página que sea capaz de ver en el Visor de ayuda Yelp:

- Pulse en Archivo Imprimir esta página

#### Imprimir un documento

Para imprimir un documento entero:

- Pulse Archivo Imprimir este documento

Esta opción sólo está disponible para la documentación DocBook.

#### Cerrar una ventana

Para cerrar una ventana en el Visor de ayuda Yelp, haga lo siguiente:

- Pulse Archivo Cerrar ventana

- Use la combinación de teclas Ctrl W

#### Establecer preferencias

Para establecer sus preferencias en el Visor de ayuda Yelp:

- Pulse Editar Preferencias

Aparecerá una ventana semejante a la yelp-preferences:

##### Ventana de preferencias del Visor de ayuda Yelp

Las opciones que están disponibles en este diálogo tienen las siguientes funciones:

Usar tipografía del sistema

- Marque esta opción para mostrar la documentación usando la tipografía predeterminada usada por el Escritorio GNOME.

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

  Anchura variable

- 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.

Anchura fija

- 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.

Navegar con el cursor

- Pulse en esta opción si quiere ver un cursor en el yelp-browser-pane. Esto le permite examinar el documento más fácilmente al mostrar donde se encuentra el cursor en el documento.

#### Atrás en el histórico de documentos

Para retroceder en el histórico de documentos:

- Pulse en Ir Atrás

- Usa la combinación de teclas Alt Izquierda

- Use el botón Atrás en la Barra de herramientas

#### Adelantar en el histórico de documentos

Para adelantar en el histórico de documentos:

- Pulse Ir Adelante

- Use la combinación de teclas Alt Derecha

- Pulse el botón Adelante en la barra de herramientas

#### Ir a los temas de ayuda

Para ir a los temas de la ayuda:

- Pulse Ir Temas de ayuda

- Use la combinación de teclas Alt Inicio

- Use el botón Temas de ayuda en la Barra de herramientas

#### Ir a la sección anterior

Para ir a la sección anterior:

- Pulse Ir Sección anterior

- Use la combinación de teclas Alt Arriba

Esta opción sólo está disponible para los documentos formatea dos en DocBook.

#### Ir a la sección siguiente

Ir a la siguiente sección:

- Pulse Ir Sección siguiente

- Use la combinación de teclas Alt Abajo

Esta opción sólo está disponible para los documentos formatea dos en DocBook.

#### Ir al contenido

Ir al contenido de un documento:

- Pulse Ir Contenido

Esta opción sólo está disponible para los documentos formatea dos en DocBook.

#### Añadir un marcador

Para añadir un marcador para un documento particular:

- Pulse Marcadores Añadir marcador

- Use la combinación de teclas Ctrl D

Aparecerá una ventana que se parecerá a la yelp-add-bookmark.

##### Ventana de añadir un marcador

Introduzca el título de su marcador deseado en el campo de entrada Título. Después pulse Añadir para añadir el marcador, o pulse Cancelar para cancelar la petición.

#### Editar marcadores

Para editar su colección de marcadores:

- Pulse Marcadores Editar marcadores...

- Use la combinación Ctrl B

Aparecerá una ventana que se parecerá a yelp-edit-bookmarks.

##### Ventana de edición de marcadores

Puede gestionar sus marcadores usando esta ventana de las siguientes maneras:

Abrir

- Use este botón para abrir el marcador seleccionado en una ventana nueva.

Renombrar

- Use este botón para renombrar el título de su marcador.

Quitar

- Use este botón para borrar el marcador de su colección.

Una vez que haya finalizado de gestionar sus marcadores, pulse el botón Cerrar para salir de la Ventana de edición de marcadores.

#### Obtener ayuda

Para obtener ayuda usando el Visor de ayuda Yelp (y ver este documento):

- Pulse Ayuda Contenido

### Características avanzadas

#### Abrir documentos específicos

##### Abrir documentos desde el Gestor de archivos

Para abrir un documento, tal como un archivo XML, desde el gestor de archivos, abra el documento en el Gestor de archivos Nautilus, o arrastre el icono desde Nautilus al panel de documentos de Yelp o al lanzador.

##### Usar la línea de comandos para abrir documentos

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:

`file:`

- Use este URI cuando quiera acceder a un archivo con yelp, por ejemplo:

      yelp file:///usr/share/gnome/help/gcalctool/C/gcalctool.xml

`ghelp:` o `gnome-help:`

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

      yelp ghelp:gcalctool

  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.

      yelp ghelp:user-guide?yelp-advanced-cmdline

`man:`

- 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.

      yelp man:gcalctool

  o

      yelp 'man:intro(1)'
      yelp 'man:intro(2)'

`info:`

- Use este URI cuando quiera acceder a una página GNU indo particular.

      yelp info:make

#### Refrescar contenido bajo demanda

El Visor de ayuda Yelp soporta la combinación de teclasCtrl R, 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.

### Más información

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

#### Scrollkeeper

El Visor de ayuda Yelp 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.

#### Utilidades de documentación de GNOME

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

- Facilitar la traducción de documentos a diferentes idiomas.

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

- Efectuar la conversión de formato DocBook a un formato apropiado para mostrarlo.

El Visor de ayuda Yelp se basa en las hojas de estilo GNOME XSLT para realizar la conversión de DocBook a HTML. Las Utilidades de Construcción de Documentación de GNOME se basan en que por cada aplicación los autores instalan y registran documentación dentro del sistema de ayuda.

#### Lista de correo y página web

Para más información acerca del Visor de ayuda Yelp visite la pagina web del Proyecto de Documentacion, http://live.gnome.org/Yelp, o suscríbase a la lista de correo, gnome-doc-devel-list@gnome.org.

### Unirse al Proyecto de Documentación de GNOME

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: http://live.gnome.org/Documentation Project