# Strumenti ed utilità

Questa sezione descrive alcuni strumenti ed utilità dello GNOME Desktop.

## Esecuzione di applicazioni

Il dialogo Esegui applicazione consente l'accesso alla riga di comando. Quando si esegue un comando nel dialogo Esegui applicazione, non è possibile ricevere l'output dal programma.

Per eseguire un comando dalla riga di comando, procedere come segue:

1. Aprire il dialogo Esegui applicazione in uno dei modi seguenti:

   Da un pannello

     È possibile aggiungere il pulsante Esegui applicazione ad un qualsiasi pannello. Consultare . Fare clic sul pulsante di pannello Esegui applicazione per aprire il dialogo Esegui applicazione.

   Usando i tasti scorciatoia

     Premere Alt F2. È possibile cambiare i tasti scorciatoia per mostrare il dialogo Esegui applicazione nello strumento di preferenze Scorciatoie da tastiera.

   Viene mostrato il dialogo Esegui applicazione.

2. Inserire il comando che si vuole eseguire nel campo vuoto, oppure scegliere una voce dall'elenco delle applicazioni note.

   Se si inserisce solo la posizione di un file, viene avviata una applicazione appropriata per aprire tale file. Se si inserisce un indirizzo di pagina web, tale pagina viene aperta nel web browser predefinito. L'indirizzo della pagina web deve essere sempre preceduto dal prefisso http://, come in http://www.gnome.org.

   Per scegliere un comando che si è eseguito in precedenza, fare clic sul pulsante freccia giù accanto al campo del comando, quindi scegliere in comando da eseguire.

   È anche possibile usare il pulsante Esegui con file per scegliere un file da accodare alla riga di comando. Per esempio, è possibile inserire emacs come comando, quindi scegliere il file da editare.

   Selezionare l'opzione Esegui nel terminare per eseguire l'applicazione o il comando in una finestra di terminale. Scegliere questa opzione per i comandi che non creano una finestra apposita per la loro esecuzione.

3. Fare clic sul pulsante Esegui nel dialogo Esegui applicazione.

## Cattura di schermate

È possibile catturare una schermata in uno dei modi seguenti:

- Da qualsiasi pannello

  È possibile aggiungere un pulsante Cattura schermata ad un qualsiasi pannello. Consultare per istruzioni su come fare ciò. Fare clic sul pulsante Cattura schermata per catturare un'istantanea dell'intero schermo.

- Usando i tasti scorciatoia

  Per catturare una schermata, usare i seguenti tasti scorciatoia:

  Tasti scorciatoia predefiniti | Funzione
  --- | ---
  Stampa schermo | Cattura un'istantanea dell'intero schermo.
  Alt Stampa schermo | Cattura un'istantanea della finestra a cui punta il mouse.

  È possibile usare lo strumento di preferenze Scorciatoie da tastiera per modificare i tasti scorciatoia predefiniti.

- Dalla barra dei menù

  Scegliere Applicazioni Accessori Cattura schermata.

- Dal terminale

  È possibile usare il commando `gnome-screenshot` per catturare una schermata. Il comando `gnome-screenshot` cattura una schermata dell'intero schermo e mostra il dialogo Salvataggio schermata. Usare il dialogo Salvataggio schermata per salvare la schermata.

  È anche possibile usare alcune opzioni assieme al comando `gnome-screenshot`, come indicato di seguito:

  Opzione | Funzione
  --- | ---
  `--window` | Cattura un'istantanea della finestra che ha il focus.
  `--delay=secondi` | Cattura una schermata dopo il numero di secondi specificato e mostra il dialogo Salvataggio schermata. Usare il dialogo Salvataggio schermata per salvare la schermata.
  `--include-border` | Cattura cattura una schermata includendo il bordo dello schermo.
  `--border-effect=shadow` | Cattura una schermata ed aggiunge un effetto ombra attorno ad essa.
  `--border-effect=border` | Cattura una schermata ed aggiunge un effetto bordo attorno ad essa.
  `--help` | Mostra le opzioni per il comando.

Quando si cattura un'istantanea, viene aperto il dialogo Salvataggio schermata. Per salvare la schermata come un file di immagine, inserire il nome di file per la schermata e scegliere una posizione nell'elenco a discesa.

## Visualizzatore di documentazione Yelp

### Introduzione

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.

Il visualizzatore di documentazione Yelp è internazionalizzato, supporta cioè la visualizzazione dei documenti in diverse lingue. I documenti debbono essere localizzato o tradotti per ciascuna lingua e installati nel modo appropriato per far sì che il visualizzatore sia in grado di mostrarli.

### Avviare Yelp

#### Per avviare il visualizzatore di documentazione Yelp

È possibile avviare il visualizzatore di documentazione Yelp nei modi seguenti:

Menù Sistema

  Scegliere Aiuto

Riga di comando

  Eseguire il seguente comando: `yelp`

#### Interfaccia

Quando si avvia il visualizzatore di documentazione Yelp, viene mostrata la seguente finestra.

##### Finestra di visualizzatore di documentazione Yelp

Il visualizzatore di documentazione Yelp contiene i seguenti elementi in

Barra dei menù

  File

    Usare questo menù per aprire una nuova finestra, visualizzare la pagina informazioni sul documento corrente, stampare il documento corrente o chiudere la finestra.

  Modifica

    Usare questo menù per copiare, selezionare tutto, trovare testo o impostare le proprie preferenze.

  Vai

    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.

  Segnalibri

    Usare questo menù per aggiungere o modificare i segnalibri.

  Aiuto

    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 degli strumenti

  Indietro

    Use this button to navigate back in your document history.

  Avanti

    Use this button to navigate forward in your document history.

  Argomenti

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

Browser Pane

  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.

### Using Yelp

#### Open a Document

To open a document in Yelp Help Browser, use the Table of Contents to navigate to the desired document.

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.

#### Open a New Window

To open a new window:

- Click File New Window

- Use the key combination Ctrl N

#### About This Document

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.

#### Print a Page

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

- Click File Print this Page

#### Print a Document

To print an entire document:

- Click File Print this Document

This option is only available for DocBook documentation.

#### Close a Window

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

- Click File Close Window

- Use the key combination Ctrl W

#### Set Preferences

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:

Use system fonts

  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.

  Variable Width

    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.

  Fixed Width

    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.

Browse with caret

  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.

#### Go Back in Document History

To go back in the document history:

- Click Go Back

- Use the key combination Alt Left

- Use the Back button in the Toolbar

#### Go Forward in Document History

To go forward in the document history:

- Click Go Forward

- Use the key combination Alt Right

- Use the Forward button in the Toolbar

#### Go to Help Topics

To go to the Help Topics:

- Click Go Help Topics

- Use the key combination Alt Home

- Use the Help Topics button in the Toolbar

#### Go to Previous Section

To go to the previous section:

- Click Go Previous Section

- Use the key combination Alt Up

This option is only available in DocBook formatted documents.

#### Go to Next Section

To go to the next section:

- Click Go Next Section

- Use the key combination Alt Down

This option is only available in DocBook formatted documents.

#### Go to Contents

To go to the contents for a document:

- Click Go Contents

This option is only available in DocBook formatted documents.

#### Add a Bookmark

To add a bookmark for a particular document:

- Click Bookmarks Add Bookmark

- Use the key combination Ctrl D

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.

#### Edit Bookmarks

To edit your collection of bookmarks:

- Click Bookmarks Edit Bookmarks...

- Use the key combination Ctrl B

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.

Rimuovi

  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.

#### Get Help

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

- Click Help Contents

### Advanced Features

#### Aprire documenti specifici

##### Aprire documenti dal 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