# Herramientas y utilidades

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

## 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. Open the Run Application dialog in any of the following ways:

   From a panel

2. You can add the Run Application button to any panel. See panels-addobject. Click on the Run Application panel button to open the Run Application dialog.

Using shortcut keys

- Press Alt F2. You can change the shortcut keys that display the Run Application dialog in the Keyboard Shortcuts preference tool.

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.

  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 http://, as in http://www.mate-desktop.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
  Print Screen | Toma una captura de la pantalla completa.
  Alt Print Screen | 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ú

  Choose Applications Accessories Take Screenshot.

- Desde el terminal

  Puede usar el comando `mate-screenshot` para tomar una captura de pantalla. El comando `mate-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 `mate-screenshot` como las siguientes:

  Opción | Función
  `--window` | Toma una captura de la ventana que tiene el foco.
  `--delay=`seconds`` | 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 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.

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.

##### Yelp Help Browser Window

Yelp Help Browser contains the following elements in fig-yelp-window

Menubar

- File

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

Edit

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

Go

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

Bookmarks

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

Help

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

Toolbar

- Back

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

Forward

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

Help Topics

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

Browser Pane

- 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

To open a document in Yelp Help Browser:

- In an application, click Help Contents

- Use the Table of Contents to navigate to the desired document.

- You can drag a Docbook XML file from Caja to the Yelp window or launcher.

- Press the F1 key.

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:

- Click File New Window

- Usa la combinación de teclas Ctrl N

#### Acerca de este documento

Para ver información acerca del documento abierto actualmente:

- Click File About This Document

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:

- Click File Print this Page

#### Imprimir un documento

Para imprimir un documento entero:

- Click File Print this Document

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:

- Click File Close Window

- Use la combinación de teclas Ctrl W

#### Establecer preferencias

Para establecer sus preferencias en el Visor de ayuda Yelp:

- Click Edit Preferences

A window will appear that looks like yelp-preferences:

##### Yelp Help Browser Preferences Window

The options that are available in this dialog have the following functions:

Use system fonts

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

  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.

  Variable Width

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

Fixed Width

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

Browse with caret

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

- Click Go Back

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

- Click Go Forward

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

- Click Go Help Topics

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

- Click Go Previous Section

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

- Click Go Next Section

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

- Click Go Contents

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:

- Click Bookmarks Add Bookmark

- Use the key combination Ctrl D

A window will appear that looks like yelp-add-bookmark.

##### Add Bookmark Window

Enter your desired bookmark title in to the Title text entry field. Then click Add to add the bookmark, or click Cancel to cancel the request.

#### Editar marcadores

Para editar su colección de marcadores:

- Click Bookmarks Edit Bookmarks...

- Use the key combination Ctrl B

A window will appear that looks like yelp-edit-bookmarks.

##### Edit Bookmarks Window

You can manage your bookmarks using this window in the following ways:

Open

- Use this button to open the selected bookmark in a new window.

Rename

- Use this button to rename the title of your bookmark.

Remove

- Use this button to delete the bookmark from your collection.

Once you are finished managing your bookmarks, click the Close button to exit the Edit Bookmarks Window.

#### Obtener ayuda

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

- Click Help Contents

### 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 Caja, o arrastre el icono desde Caja 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/help/C/mate-control-center/config-mouse.xml

`help:`

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

      yelp help:mate-terminal

  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.

      yelp help:mate-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:mate-panel

  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 MATE

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

- Ease translation of documents to different languages.

- Provide a set of tools to help package and install documentation into the correct location and register the documentation with scrollkeeper.

- Perform conversion from DocBook format to a format suitable for display.

Yelp Help Browser relies on MATE XSLT Stylesheets to perform conversion from DocBook to HTML. MATE Documentation Build Utilities are relied upon by application authors to install and register documentation within the help system.

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

For further information on Yelp Help Browser, please visit the Documentation Project homepage, , or subscribe to the mailing list, .

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

If you are interesting in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage: