# Ferramentas e utilidades

This section describes some of the tools and utilities in the GNOME Desktop.

## Executar aplicativos

The Run Application dialog gives you access to the command line. When you run a command in the Run Application dialog, you cannot receive output from the command.

To run a command from the command line perform the following steps:

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

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

   Usar combinacións de teclas

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

   The Run Application dialog is displayed.

2. Enter the command that you want to run in the blank field, or choose from the list of known applications.

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

   To choose a command that you ran previously, click the down arrow button beside the command field, then choose the command to run.

   You can also use the Run with file button to choose a file to append to the command line. For example, you can enter emacs as the command, then choose a file to edit.

   Select the Run in terminal option to run the application or command in a terminal window. Choose this option for an application or command that does not create a window in which to run.

3. Click on the Run button on the Run Application dialog.

## Capturar pantallas

You can take a screenshot in any of the following ways:

- Desde calquera panel

  You can add a Take Screenshot button to any panel. For instructions on how to do this, see . Click on the Take Screenshot button to take a screenshot of the entire screen.

- Usar atallos de teclado

  To take a screenshot, use the following shortcut keys:

  Atallos de teclado predefinidos | Función
  --- | ---
  Imprimir pantalla | Tomar unha captura de pantalla completa.
  Alt Imprimir pantalla | Takes a screenshot of the window which is active.

  You can use the Keyboard Shortcuts preference tool to modify the default shortcut keys.

- Desde a barra de menú

  Choose Applications Accessories Take Screenshot.

- Desde o terminal

  You can use the `gnome-screenshot` command to take a screenshot. The `gnome-screenshot` command takes a screenshot of the entire screen, and displays the Save Screenshot dialog. Use the Save Screenshot dialog to save the screenshot.

  You can also use options on the `gnome-screenshot` command as follows:

  Opción | Función
  --- | ---
  `--window` | Takes a screenshot of the window that has focus.
  `--delay=segundos` | Takes a screenshot after the specified number of seconds, and displays the Save Screenshot dialog. Use the Save Screenshot dialog to save the screenshot.
  `--include-border` | Takes a screenshot including the border of the window.
  `--remove-border` | Takes a screenshot without the border of the window.
  `--border-effect=shadow` | Takes a screenshot and adds a shadow bevel effect around it.
  `--border-effect=border` | Takes a screenshot and adds a border effect around it.
  `--interactive` | Opens a window that lets you set options before taking the screenshot.
  `--help` | Displays the options for the command.

When you take a screenshot, the Save Screenshot dialog opens. To save the screenshot as an image file, enter the filename for the screenshot, choose a location from the drop-down list and click the Save button. You can also use the Copy to Clipboard button to copy the image to the clipboard or transfer it to another application by drag-and-drop.

## Visor de axuda Yelp

### Introdución

The Yelp Help Browser application allows you to view documentation regarding GNOME and other components through a variety of formats. These formats include docbook files, HTML help pages, man pages and info pages (support for man pages and info pages may optionally be compiled in). Despite the different formats supported, Yelp does its best to provide a unified look and feel regardless of the original document format.

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

### Iniciar Yelp

#### Para iniciar o Visor de axuda Yelp

You can start Yelp Help Browser in the following ways:

Menú Sistema

  Seleccione Axuda

Liña de ordes

  Execute a seguinte orde: `yelp`

#### Interface

When you start Yelp Help Browser, you will see the following window appear.

##### Xanela do Visor de axuda Yelp

Yelp Help Browser contains the following elements in

Barra de menú

  Ficheiro

    Use this menu to Open a New Window, view the About this Document page, Print the current document, or Close the window.

  Editar

    Use este menú para copiar, seleccionar todo, buscar ou para estabelecer as súas preferencias.

  Ir

    Use this menu to navigate Back, Forward, to the Help Topics page. When viewing a DocBook document, use this menu to navigate to the Next Section, Previous Section or to the Contents.

  Marcadores

    Use this menu to Add Bookmark(s), or Edit Bookmark(s).

  Axuda

    View information about Yelp Help Browser and contributors to the project through the About menuitem. Open this document with the Contents menuitem or by pressing F1.

Barra de ferramentas

  Atrás

    Use este botón para volver atrás no seu historial documentación

  Atrás

    Usar este botón para ir adiante no historial do seu documento.

  Temas de axuda

    Use this button to return to the main table of contents (shown in ).

Panel de visualización

  The browser pane is where you will be presented with the table of contents or the documentation. Use the table of contents to navigate to the documentation you need.

### 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 Nautilus to the Yelp window or launcher.

- Prema a tecla F1.

Alternatively, you may view a particular document by invoking Yelp Help Browser from the command line or dragging files to Yelp. See for more on this.

#### Abrir unha xanela nova

Para abrir unha xanela nova:

- Click File New Window

- Use the key combination Ctrl N

#### Sobre este documento

To view information about the currently open document:

- Click File About This Document

This option is only available for DocBook documentation. Legal notices and documentation contributors are usually listed in this section.

#### Imprimir unha páxina

To print any page that you are able to view in Yelp Help Browser:

- Click File Print this Page

#### Imprimir un documento

Para imprimir un documento enteiro:

- Click File Print this Document

This option is only available for DocBook documentation.

#### Pechar a xanela

To close a window in Yelp Help Browser, do the following:

- Click File Close Window

- Use the key combination Ctrl W

#### Estabelecer preferencias

To set your preferences in Yelp Help Browser:

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

Usar o tipo de letra do sistema

  Check this option to display documentation using the default fonts used by the GNOME Desktop.

  To choose your own fonts to display documentation, uncheck this option and click on the buttons next to the text Variable Width or Fixed Width.

  Ancho variábel

    This is the font to use when a static or fixed width font is not required. The majority of text will be of this type.

  Ancho fixo

    This is the font to use when all text characters need to be of the same size. This font is usually used to indicate commands, program blocks, or other text that falls under these categories.

Navegar co cursor

  Click this option if you would like see a caret or cursor in the . This allows you to browse the document more easily by showing where the cursor is located in the document.

#### Atrás no historial de documentos

Para retroceder no historial de documentos:

- Click Go Back

- Use the key combination Alt Left

- Use the Back button in the Toolbar

#### Ir adiante no historial de documentos

Para ir adiante no historial de documentos:

- Click Go Forward

- Use the key combination Alt Right

- Use the Forward button in the Toolbar

#### Ir ao temas de axuda

Para ir aos temas de axuda:

- Click Go Help Topics

- Use the key combination Alt Home

- Use the Help Topics button in the Toolbar

#### Ir á sección anterior

Para ir á sección anterior:

- Click Go Previous Section

- Use the key combination Alt Up

This option is only available in DocBook formatted documents.

#### Ir á sección seguinte:

Para ir á seguinte sección:

- Click Go Next Section

- Use the key combination Alt Down

This option is only available in DocBook formatted documents.

#### Ir ao contido

Ir ao contido do documento:

- Click Go Contents

This option is only available in DocBook formatted documents.

#### Engadir un marcador

Para engadir un marcador para un documento particular:

- Click Bookmarks Add Bookmark

- Use the key combination Ctrl D

A window will appear that looks like .

##### Xanela para engadir un marcador

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 a súa colección de marcadores:

- Click Bookmarks Edit Bookmarks...

- Use the key combination Ctrl B

A window will appear that looks like .

##### Xanela de edición de marcadores

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

Abrir

  Usar este botón para abrir o marcador seleccionado nunha xanela nova.

Renomear

  Use este botón para renomear o título do seu marcador.

Eliminar

  Use este botón para borrar o marcador da súa colección.

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

#### Obter axuda

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

- Click Help Contents

### Características avanzadas

#### Opening Specific Documents

##### Opening Documents from the File Manager

To open a document, such as an XML file, from the file manager, open the document in Nautilus File Manager, or drag the icon from Nautilus to the Yelp document pane or launcher.

##### Using the Command Line to Open Documents

Yelp Help Browser supports opening documents from the command line. There are a number of URIs (Uniform Resource Identifiers) that can be used. These include:

`file:`

  Use this URI when you want to access a file with yelp, for example:

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

`ghelp:` or `gnome-help:`

  Use this URI when you want to access GNOME help documents, which are typically written in DocBook format.

      yelp ghelp:gcalctool

  If you want to open the help document at a particular section, append a question mark to the end of the URI, followed by the section id.

      yelp ghelp: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 parenthesis and therefore it may be necessary to escape the argument so that the shell does not interpret the parenthesis.

      yelp man:gcalctool

  or

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

`info:`

  Use this URI when you want to access a particular GNU info page.

      yelp info:make

#### Refreshing Content on Demand

Yelp Help Browser supports the Ctrl R shortcut keys, which will reload the DocBook document that is currently open. This allows developers to view changes to documents as they are made.

### More Information

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

#### Scrollkeeper

Yelp Help Browser uses scrollkeeper to generate the table of contents for DocBook and HTML documentation, and also keep track of translations for each document.

#### GNOME Documentation Utilites

The documentation distributed with GNOME uses this set of utilities for a variety of things:

- 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 GNOME XSLT Stylesheets to perform conversion from DocBook to HTML. GNOME Documentation Build Utilities are relied upon by application authors to install and register documentation within the help system.

#### Homepage and Mailing List

For further information on Yelp Help Browser, please visit the Documentation Project homepage, http://live.gnome.org/Yelp, or subscribe to the mailing list, gnome-doc-devel-list@gnome.org.

### Joining the GNOME Documentation Project

If you are interesting in helping produce and update documentation for the GNOME project, please visit the Documentation Project homepage: http://live.gnome.org/DocumentationProject