# Herramientas y utilidades

Toni Estevez
toni.estevez@gmail.com
2019
Toni Estevez
Jorge González
jorgegonz@svn.gnome.org
2007-2010
Jorge González
Francisco Javier F. Serrador
serrador@cvs.gnome.org
2003-2006
Francisco Javier F. Serrador
Pablo Gonzalo del Campo
pablodc@bigfoot.com
2002-2003
Pablo Gonzalo del Campo

This section describes some tools and utilities in the MATE Desktop.

## Ejecutar aplicaciones

El diálogo Ejecutar una aplicación le da acceso a la línea de órdenes. Cuando ejecuta una orden en el diálogo Ejecutar una aplicación, no puede recibir salida de la orden.

Para ejecutar una orden desde la línea de órdenes siga los pasos siguientes:

1. Open the Run Application dialog in any of the following ways:

   From a panel

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

   Using shortcut keys

     Press AltF2. You can change the shortcut keys that display the Run Application dialog in the tool.

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

2. Introduzca la orden 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 https://, as in https://mate-desktop.org.

   Para elegir una orden que ya haya ejecutado previamente, haga clic en el botón de la flecha hacia abajo junto al campo de la orden, después elija la orden a ejecutar.

   También puede usar el botón Ejecutar con un archivo para elegir un archivo para añadir a la línea de órdenes. Por ejemplo, puede escribir la orden pluma y luego elegir un archivo para editar.

   Seleccione la opción Ejecutar en un terminal para ejecutar la aplicación o orden en una ventana de terminal. Elija esta opción para una aplicación o orden que no cree una ventana en la cual ejecutarse.

3. Haga clic en el botón Ejecutar en el diálogo Ejecutar una aplicación.

## Capturar pantallas

Puede tomar una captura de pantalla de cualquiera de las maneras siguientes:

- Desde cualquier panel

  Puede añadir un botón de Tomar una captura de pantalla a cualquier panel. Para instrucciones de cómo hacer esto, consulte la . Haga clic en el botón Tomar una captura de pantalla para capturar la pantalla completa.

- Usar teclas de atajo

  Para tomar una captura de pantalla, use las teclas de atajo siguientes:

  Teclas de atajo predeterminadas | Función
  --- | ---
  Imprimir Pantalla | Toma una captura de la pantalla completa.
  AltPrint Screen | Toma una captura de pantalla de la ventana activa.

  You can use the tool to modify the default shortcut keys.

- Desde la barra de menú

  Elija Aplicaciones Accesorios Tomar una captura de pantalla.

- Desde el terminal

  Puede usar la orden `mate-screenshot` para tomar una captura de pantalla. La orden `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 la orden `mate-screenshot` como se indica a continuación:

  Opción | Función
  --- | ---
  `--window` | Toma una captura de pantalla 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 ventana.
  `--remove-border` | Toma una captura de pantalla sin el borde de la ventana.
  `--border-effect=shadow` | Toma una captura de pantalla y añade un borde sombreado.
  `--border-effect=border` | Toma una captura de pantalla y añade un efecto de borde.
  `--interactive` | Abre una ventana que le permite establecer las opciones antes de tomar la captura.
  `--help` | Muestra las opciones para la orden.

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 una ubicación de la lista desplegable y haga clic en 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 la ayuda Yelp

### Introducción

La aplicación visor de la 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 (la compatibilidad con las páginas man e info puede compilarse opcionalmente). A pesar de los diferentes formatos admitidos, Yelp hace todo lo posible proporcionar un aspecto y comportamiento uniformes independientemente del formato original del documento.

Yelp Help Browser is internationalized, meaning that it has support to view documents in different languages. The documents must be localized or translated for each language and installed properly for Yelp Help Browser to be able to view them.

### Iniciar Yelp

#### Para iniciar el visor de la ayuda Yelp

Puede iniciar el visor de la ayuda Yelp de las formas siguientes:

Menú Sistema

  Elija Ayuda

Línea de órdenes

  Ejecute la orden siguiente: `yelp`

#### Interfaz

Cuando inicie el visor de la ayuda Yelp, aparecerá la ventana siguiente.

##### Yelp Help Browser Window

Yelp Help Browser contains the following elements in

Barra de menú

  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, buscar... o para configurar sus preferencias.

  Go

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

  Bookmarks

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

  Help

    Vea información sobre el visor de la 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

  Back

    Use este botón para navegar hacia atrás en el historial de documentos.

  Forward

    Use este botón para navegar hacia adelante en el historial de documentos.

  Help Topics

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

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 la ayuda Yelp desde la línea de órdenes o arrastrando documentos a Yelp. Por favor consulte la 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 CtrlN

#### Acerca de este documento

Para ver información sobre el documento abierto actualmente:

- Click File About This Document

Esta opción solo está disponible para la documentación DocBook. Los avisos legales y los contribuidores de la documentación se enumeran usualmente en esta sección.

#### Imprimir una página

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

- Click File Print this Page

#### Imprimir un documento

Para imprimir un documento entero:

- Click File Print this Document

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

#### Cerrar una ventana

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

- Click File Close Window

- Use la combinación de teclas CtrlW

#### Configurar las preferencias

Para configurar sus preferencias en el visor de la ayuda Yelp:

- Click Edit Preferences

A window will appear that looks like :

##### 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 haga clic 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 órdenes, bloques de programa, u otro texto que caiga bajo estas categorías.

Browse with caret

  Haga clic en esta opción si quiere ver un cursor en el . Esto le permite navegar por el documento más fácilmente al mostrar donde se encuentra el cursor en el documento.

#### Retroceder en el historial de documentos

Para retroceder en el historial de documentos:

- Click Go Back

- Usa la combinación de teclas AltIzquierda

- Use the Back button in the Toolbar

#### Avanzar en el historial de documentos

Para avanzar en el historial de documentos:

- Click Go Forward

- Use la combinación de teclas AltDerecha

- Use the Forward button in the Toolbar

#### Ir a los temas de ayuda

Para ir a los temas de la ayuda:

- Click Go Help Topics

- Use la combinación de teclas AltInicio

- Use the Help Topics button in the Toolbar

#### Ir a la sección anterior

Para ir a la sección anterior:

- Click Go Previous Section

- Use la combinación de teclas AltArriba

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

#### Ir a la sección siguiente

Ir a la sección siguiente:

- Click Go Next Section

- Use la combinación de teclas AltAbajo

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

#### Ir al contenido

Ir al contenido de un documento:

- Click Go Contents

Esta opción solo 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 CtrlD

A window will appear that looks like .

##### 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 CtrlB

A window will appear that looks like .

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

To get help to use Yelp Help Browser (and see this document):

- 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 órdenes para abrir documentos

El visor de la ayuda Yelp admite abrir documentos desde la línea de órdenes. Hay varios URI (Identificadores Uniformes de Recursos) que se pueden usar. Estos incluyen:

`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 normalmente 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 this URI when you want to access a particular man page. You can append the section of the man page you would like to view if there are multiple man pages with the same name. The section number should be enclosed in parentheses and therefore it may be necessary to escape the argument so that the shell does not interpret the parenthesis.

      yelp man:mate-panel

  o

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

`info:`

  Use esta URI cuando quiera acceder a una página info de GNU en particular.

      yelp info:make

#### Refrescar contenido bajo demanda

El visor de la ayuda Yelp admite las teclas de atajoCtrlR, 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

This section details some helper applications which Yelp Help Browser uses, and provides resources where you can get more information about Yelp Help Browser.

#### Scrollkeeper

El visor de la 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, `http://mate-desktop.org`, or subscribe to the mailing list, `http://ml.mate-desktop.org/listinfo/mate-dev`.

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

If you are interested in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage: `http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team`