# Strumenti e utilità

Questa sezione descrive alcuni strumenti ed utilità del Desktop MATE.

## 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 a 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 modificare i tasti scorciatoia per mostrare il dialogo Esegui applicazione dallo strumento .

   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 ad un file, verrà avviata una applicazione appropriata per aprire quel tipo di file. Se si inserisce un indirizzo web, il vostro browser web predefinito aprirà la pagina specificata. Anteponete all'indirizzo web il prefisso https://, come in https://www.mate-desktop.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 Stamp | Cattura una schermata della finestra attiva.

  È possibile utilizzare lo strumento per modificare i tasti scorciatoia predefinite.

- Dalla barra dei menù

  Selezionare Applicazioni Accessori Cattura schermata.

- Dal terminale

  È possibile usare il commando `mate-screenshot` per catturare una schermata. Il comando `mate-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 `mate-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 una schermata includendo il bordo dello schermo.
  `--remove-border` | Cattura una schermata escludendo il bordo dello schermo.
  `--border-effect=shadow` | Cattura una schermata e aggiunge unìombraggiatura attorno ad essa.
  `--border-effect=border` | Cattura una schermata e aggiunge un bordo attorno ad essa.
  `--interactive` | Apre una finestra che consente di impostare alcune opzioni prima di catturare la schermata.
  `--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, scegliere una posizione dall'elenco a discesa e fare clic su Salva. È anche possibile usare il pulsante Copia negli appunti per copiare l'immagine negli appunti o trasferirla in un'altra applicazione per trascinamento.

## Visualizzatore di documentazione Yelp

### Introduzione

Il Visualizzatore di documentazione Yelp consente di visualizzare la documentazione relativa a MATE e ad altri componenti, fornita in diversi formati. Tali formati includono i file docbook, le pagine di aiuto in HTML, le pagine man e le pagine info (il supporto alle pagine man e info è compilato opzionalmente). Indipendentemente dai diversi formati supportati, Yelp cerca di fornire un aspetto uniforme per tutti i formati.

Il Visualizzatore di documentazione Yelp è capace di supportare la visualizzazione della documentazione nelle diverse lingue. I documenti devono essere tradotti per ciascuna lingua ed essere correttamente installati perché il Visualizzatore di documentazione Yelp possa vederli.

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

Il

##### Finestra di visualizzatore di documentazione Yelp

Visualizzatore di documentazione Yelp contiene i seguenti elementi in

Barra dei menu

  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

    Usare questo menù per spostarsi indietro, avanti o alla pagina principale dell'aiuto. Quando si visualizza un documento DocBook, usare questo menù per spostarsi alla prossima sezione, quella precedente o all'indice.

  Preferiti

    Usare questo menù per aggiungere o modificare i segnalibri.

  Aiuto

    Per visualizzare informazioni riguardo Yelp e i contributori al progetto, selezionare Informazioni. È possibile aprire questo documento scegliendo Sommario o premendo F1.

Barra degli strumenti

  Indietro

    Usare questo pulsante per spostarsi indietro nella cronologia del documento.

  Avanti

    Usare questo pulsante per spostarsi avanti nella cronologia del documento.

  Argomenti

    Usare questo pulsante per ritornare all'indice principale (mostrato in ).

Riquadro di esplorazione

  Il riquadro di esplorazione è l'area in cui viene mostrato l'indice della la documentazione. Usare l'indice per spostarsi tra la documentazione.

### Usare Yelp

#### Aprire un documento

Per aprire un documento in Visualizzatore di documentazione Yelp:

- In una applicazione fare clic su Aiut Sommario

- Utilizzare l'indice per navigare fino al documento desiderato.

- È possibile trascinare un file XML tipo Docbook da Caja in una finestra Yelp o sul suo lanciatore.

- Premere il tasto F1.

In alternativa, è possibile visualizzare un particolare documento avviando Yelp dalla riga di comando o trascinando un file all'interno di Yelp. Per maggiori informazioni, consultare .

#### Aprire una nuova finestra

Per aprire una nuova finestra:

- Fare clic su File Nuova finestra

- Usare la combinazione di tasti Ctrl N

#### Informazioni sul documento

Per visualizzare informazioni riguardo il documento aperto:

- Fare clic su File Informazioni sul documento

Questa opzione è disponibile solo per i documenti DocBook. Di solito tale sezione presenta le note legali ed elenca i contributori alla documentazione.

#### Stampare una pagina

Per stampare una pagina che si sta visualizzando in Yelp:

- Fare clic su File Stampa questa pagina

#### Stampare un documento

Per stampare un intero documento:

- Fare clic su File Stampa questo documento

Questa opzione è disponibile solo per i documenti DocBook.

#### Chiudere una finestra

Per chiudere una finestra in Yelp, procedere come segue:

- Fare clic su File Chiudi finestra

- Usare la combinazione di tasti Ctrl W

#### Impostare le preferenze

Per impostare le proprie preferenze in Yelp:

- Fare clic su Modifica Preferenze

Apparirà una finestra che rassomiglia a :

##### Finestra Preferenze di Yelp

Le opzioni disponibili in questo dialogo hanno le seguenti funzioni:

Usa il caratteri di sistema

  Selezionare questa opzione per visualizzare la documentazione utilizzando i tipi di carattere predefiniti per lo MATE Desktop.

  Per scegliere dei tipi di carattere personalizzati, deselezionare questa opzione e fare clic sui pulsanti accanto alle scritte Larghezza variabile o Larghezza fissa.

  Larghezza variabile

    Questo è il tipo di carattere da usare quando non è richiesto un carattere statico o a larghezza fissa. La maggior parte del testo è di questo tipo.

  Larghezza fissa

    Questo è il tipo di carattere da usare quando i caratteri devono essere della stessa dimensione. Questo tipo di carattere viene solitamente usato per identificare comandi, blocchi di codice o qualsiasi altro testo che rientri in queste categorie.

Naviga con il cursore

  Selezionare questa opzione se si desidera vedere un cursore in . Questo consente di spostarsi nel documento più facilmente mostrando dove sia localizzato il cursore.

#### Andare indietro nella cronologia del documento

Per andare indietro nella cronologia del documento:

- Fare clic su Vai Indietro

- Usare la combinazione di tasti Alt Sinistra

- Utilizzare il pulsante Indietro nella Barra degli strumenti

#### Andare avanti nella cronologia del documento

Per andare avanti nella cronologia del documento:

- Fare clic su Vai Avanti

- Usare la combinazione di tasti Alt Destra

- Utilizzare il pulsante Avanti nella Barra degli strumenti

#### Andare all'indice generale

Per andare all'indice generale:

- Fare clic su Vai Indice generale

- Usare la combinazione di tasti Alt Inizio

- Utilizzare il pulsante Indice generale nella Barra degli strumenti

#### Andare alla sezione precedente

Per spostarsi alla sezione precedente:

- Fare clic su Vai Sezione precedente

- Usare la combinazione di tasti Alt Su

Questa opzione è disponibile solamente nei documenti scritti in DocBook.

#### Spostarsi alla sezione successiva

Per spostarsi alla sezione successiva:

- Fare clic su Vai Sezione successiva

- Usare la combinazione di tasti Alt Giù

Questa opzione è disponibile solamente nei documenti scritti in DocBook.

#### Andare al sommario

Per al sommario di un documento:

- Fare clic su Vai Sommario

Questa opzione è disponibile solamente nei documenti scritti in DocBook.

#### Aggiungere un segnalibro

Per aggiungere un segnalibro per un documento particolare:

- Fare clic su Segnalibri Aggiungi segnalibro

- Usare la combinazione di tasti Ctrl D

Apparirà una finestra che rassomiglia a :

##### Finestra Aggiungi segnalibro

Inserire il titolo per vostro segnalibro nella casella di testo Titolo. Quindi fare clic su Aggiungi per aggiungere il segnalibro, o fare clic su Annulla per annullare l'operazione.

#### Modificare i segnalibri

Per modificare i propri segnalibri:

- Fare clic su Segnalibri Modifica segnalibri...

- Usare la combinazione di tasti Ctrl B

Apparirà una finestra che rassomiglia a :

##### Finestra Modifica segnalibri

Si possono gestire i segnalibri utilizzando questa finestra nei modi seguenti:

Apri

  Usare questo pulsante per aprire il segnalibro selezionato in una nuova finestra.

Rinomina

  Usare questo pulsante per rinominare il titolo del segnalibro.

Elimina

  Usare questo pulsante per eliminare il segnalibro dalla propria raccolta.

Una volta terminato di gestire i propri segnalibri, fare clic sul pulsante Chiudi per uscire da Finestra Modifica segnalibri.

#### Ottenere aiuto

Per ricevere aiuto su come utilizzare Visualizzatore di documentazione Yelp (e vedere questo documento):

- Fare clic su Aiuto Sommario

### Caratteristiche avanzate

#### Aprire documenti specifici

##### Aprire documenti dal gestore di file

Per aprire un documento, come un file XML, dal gestore di file, aprire il documento nel gestore di file Caja oppure trascinare l'icona del documento dalla finestra di Caja sul riquadro documento di Yelp oppure sul lanciatore.

##### Usare la riga di comando per aprire documenti

Visualizzatore di documentazione Yelp supporta l'apertura di documenti dalla riga di comando. È possibile utilizzare diversi URI (Uniform Resource Identifiers), compresi:

`file:`

  Usare questo URI per accedere a un file con Yelp, per esempio:

      yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml

`aiuto:`

  Usare questo URI per accedere alla documentazione di aiuto di MATE, tipicamente scritta nel formato DocBook.

      yelp help:mate-terminal

  Se si desidera aprire il documento di aiuto su una particolare sezione, aggiungere una barra '/' alla fine del URI, seguita dall'id della sezione.

      yelp help:mate-user-guide/yelp-advanced-cmdline

`man:`

  Usare questo URI per accedere a una particolare pagina man. Nel caso ci sia più di una pagina man con lo stesso nome, è possibile aggiungere la sezione da visualizzare. Per fare ciò, è necessario inserire il numero della sezione tra parentesi tonde. Sarà quindi necessario fare in modo che la shell non interpreti le parentesi come dei comandi.

      yelp man:mate-panel

  o

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

`info:`

  Usare questo URI per accedere a una particolare pagina GNU info.

      yelp info:make

#### Aggiornare il contenuto su richiesta

Visualizzatore di documentazione Yelp supporta i tasto scorciatoia Ctrl R che consentono di ricaricare il documento DocBook attualmente aperto. In questo modo gli sviluppatori possono visualizzare i cambiamenti ai documenti mentre vengono apportati.

### Maggiori informazioni

Questa sezione descrive alcune delle applicazioni ausiliarie utilizzate da Visualizzatore di documentazione Yelp e fornisce alcune risorse utili per reperire ulteriori informazioni riguardo Visualizzatore di documentazione Yelp.

#### Scrollkeeper

Yelp fa uso di scrollkeeper per generare l'indice per la documentazione DocBook e HTML e per tenere traccia delle traduzioni di ogni singolo documento.

#### MATE Documentation Utilites

La documentazione fornita con MATE fa uso di queste utilità per una serie di motivi:

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

#### Sito web e mailing list

Per maggiori informazioni su Visualizzatore di documentazione Yelp, visitate la pagina del Progetto Documentazione, `Visualizzatore di documentazione Yelp`, o sottoscrivete la mailing list, `http://ml.mate-desktop.org/listinfo/mate-dev`.

### Partecipare al Progetto di documentazione di MATE

Se siete interessati ad aiutare a produrre e aggiornare la documentazione per il progetto MATE, visitate la pagina web del Progetto Documentazione: `http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team`