# L'aiuto online

Tutte le applicazioni del Common Desktop Environment (CDE) permettono di ottenere informazioni di aiuto online, utilizzando lo stesso metodo standard. È inoltre disponibile una Gestione dell'aiuto che presenta tutti gli argomenti disponibili sul sistema.

Il sistema di aiuto del desktop può essere utilizzato anche da altre applicazioni installate sul sistema, e può essere senz'altro integrato con altri sistemi di guida per l'utente.

UG.GHelp.mkr.2
UG.GHelp.mkr.6
UG.GHelp.mkr.8
UG.GHelp.mkr.12
UG.GHelp.mkr.13
UG.GHelp.mkr.17
UG.GHelp.mkr.20

## Richiesta delle informazioni di aiuto

Per richiedere le informazioni di aiuto si può procedere come segue:

- Premere F1 — detto anche il “tasto di aiuto” — per ottenere informazioni di aiuto contestuali

- Scegliere un comando dal menu Aiuto di un'applicazione

- Aprire la Gestione dell'aiuto dal Pannello principale per visualizzare gli argomenti disponibili sul sistema

- Aprire il pannello secondario dell'Aiuto per richiamare informazioni sul desktop o per scegliere “l'Aiuto sull'elemento”

### Premere F1 — Il tasto di aiuto

Quando si ha un problema, il modo più rapido e semplice per ottenere un aiuto è quello di premere F1. Premendo F1, l'applicazione in uso visualizza le informazioni più strettamente correlate al componente evidenziato — ad esempio un pulsante o una finestra.
Poiché l'applicazione sceglie l'argomento di aiuto più appropriato al contesto della richiesta, questo tipo di aiuto viene detto contestuale.

Il tasto F1 offre un metodo rapido per ottenere informazioni su un menu o su un riquadro di dialogo. Ad esempio, per ottenere informazioni sul menu File della Gestione di file è sufficiente aprire il menu File e premere F1. L'applicazione visualizzerà una descrizione di tutte le opzioni del menu. Oppure, premendo F1 in un riquadro di dialogo verrà visualizzata una spiegazione sull'uso e sulle funzioni di quel riquadro. Le stesse informazioni potranno essere visualizzate facendo clic sul pulsante Aiuto del riquadro di dialogo.

Alcuni sistemi dispongono di un tasto “Aiuto” dedicato nella tastiera. In questo caso, il tasto Aiuto avrà la stessa funzione di F1.

### Uso del menu Aiuto delle applicazioni

Quasi tutte le applicazioni dispongono di un menu Aiuto che comprende le opzioni per richiedere diversi tipi di informazioni: un'introduzione generale all'applicazione, una descrizione delle procedure oppure una serie di informazioni di riferimento.

#### Il menu Aiuto delle applicazioni del CDE

In genere, il menu Aiuto delle applicazioni del CDE contiene i seguenti comandi:

Panoramica | Visualizza l'argomento iniziale dell'applicazione, vale a dire il primo argomento nella gerarchia di aiuto dell'applicazione.
Indice | Visualizza tutti gli argomenti presenti nella gerarchia di aiuto dell'applicazione.
Attività | Visualizza le istruzioni per le operazioni da eseguire con l'applicazione.
Riferimenti | Visualizza informazioni di riferimento per diversi componenti, come le finestre e i riquadri di dialogo, i menu e le risorse delle applicazioni.
Sull'elemento | Permette di fare clic su un elemento specifico di una finestra dell'applicazione per ottenere informazioni su quell'elemento.
Uso dell'aiuto | Fornisce informazioni sull'uso delle finestre dell'Aiuto.
Informazioni su Applicazione | Mostra la versione e le informazioni di copyright per l'applicazione.

Alcune applicazioni possono includere altre opzioni oltre a quelle descritte. Inoltre, le applicazioni non-CDE possono avere menu con opzioni diverse.

#### Aiuto sugli elementi delle applicazioni

L'aiuto sull'elemento opera in modo interattivo. Permette infatti di posizionare il puntatore su un elemento specifico (un menu, un pulsante o un riquadro di dialogo) e di fare clic su quell'elemento per visualizzare l'aiuto corrispondente.

#### Come selezionare l'aiuto sull'elemento

1. Scegliere “Sull'elemento” dal menu Aiuto.

   Il puntatore assumerà la forma di un punto interrogativo (?).

2. Posizionare il puntatore su un elemento dell'applicazione e fare clic con il pulsante del mouse di sinistra.

   Verrà visualizzata una descrizione dell'elemento.

### Uso della Gestione dell'aiuto

La Gestione dell'aiuto è una finestra speciale che presenta tutti i volumi dell'aiuto online registrati sul sistema. Per aprire questa finestra, fare clic sul controllo della Gestione dell'aiuto nel Pannello principale.

#### Il controllo della Gestione dell'aiuto

Facendo clic su uno dei titoli sottolineati verranno mostrate le informazioni di aiuto corrispondenti. Per ulteriori istruzioni sull'uso della Gestione dell'aiuto, vedere UG.GHelp.mkr.17.

Il pannello secondario dell'aiuto permette inoltre di ottenere informazioni sul desktop e sul Pannello principale, ed offre un aiuto contestuale per il Pannello principale e i pannelli secondari.

## Uso delle finestre dell'aiuto

Il sistema di aiuto è incorporato in tutte le applicazioni del CDE (e in alcuni casi anche in altre applicazioni installate sul sistema).

Per visualizzare i testi di aiuto, le applicazioni utilizzano due tipi di finestre: le finestre dell'aiuto generale e le finestre dell'aiuto rapido, mostrate nella UG.GHelp.mkr.7.

### Tipi di finestre dell'aiuto

Le finestre dell'aiuto generale contengono una struttura di argomenti e un'area di visualizzazione. La struttura degli argomenti è un indice degli argomenti disponibili nel sistema di aiuto. Scegliendo un argomento, le informazioni corrispondenti vengono visualizzate nella parte inferiore della finestra, detta area di visualizzazione degli argomenti.

Le finestre dell'aiuto rapido hanno una forma più semplice: contengono infatti solo un'area di visualizzazione e uno o più pulsanti.

## Selezione degli argomenti dell'aiuto

Esistono due modi per selezionare un argomento dell'aiuto. È possibile scegliere un titolo dalla struttura degli argomenti; oppure, dall'interno di un argomento, selezionare un collegamento ipertestuale. Un collegamento ipertestuale è una parola o una frase attiva che “salta” ad un altro argomento correlato. Le parti di testo sottolineate nelle finestre dell'aiuto sono collegamenti ipertestuali.

Anche le immagini grafiche possono essere usate come collegamenti ipertestuali. Per maggiori informazioni, vedere UG.GHelp.mkr.10.

### Uso della struttura degli argomenti

La struttura degli argomenti è un indice a più livelli delle informazioni disponibili nel volume di aiuto. Gli argomenti di livello inferiore appaiono rientrati rispetto a quelli principali. L'argomento corrente, cioè quello che compare nell'area di visualizzazione, è contrassegnato da una freccia (˛). Le barre di scorrimento permettono di visualizzare l'intero testo dell'argomento selezionato, e gli angoli e i bordi di ridimensionamento permettono di allargare o di ridurre l'intera finestra dell'aiuto.

È anche possibile modificare la suddivisione interna della finestra, trascinando la casella di ridimensionamento mostrata nella UG.GHelp.mkr.9.

#### Modifica della suddivisione interna della finestra dell'aiuto

#### Come selezionare un argomento

1. Posizionare il puntatore nella struttura degli argomenti.

2. Fare clic con il pulsante del mouse di sinistra sull'argomento desiderato.

### Uso dei collegamenti ipertestuali

Tutte le parti di testo sottolineate nelle finestre dell'aiuto sono collegamenti ipertestuali. Questi collegamenti permettono di “saltare” facilmente ad argomenti correlati dell'aiuto — con un semplice clic sul testo sottolineato.

#### Aspetto dei collegamenti ipertestuali

Una sottolineatura continua identifica un collegamento ipertestuale standard, che visualizzerà il nuovo argomento nella finestra corrente. Ad esempio, la nota visualizzata nella UG.GHelp.mkr.9 contiene un collegamento ipertestuale di questo tipo.

Una sottolineatura tratteggiata indica un collegamento a una definizione, che visualizzerà una finestra di aiuto rapido.

Anche i grafici — ad esempio le icone — possono essere collegamenti ipertestuali. Un bordo grigio con gli angoli aperti intorno a una figura indica un collegamento ipertestuale grafico. La UG.GHelp.mkr.11 mostra i diversi formati dei collegamenti ipertestuali usati negli argomenti dell'aiuto.

##### Formati dei collegamenti ipertestuali

#### Collegamenti che aprono una nuova finestra

La maggior parte dei collegamenti ipertestuali visualizzano il nuovo argomento nella finestra corrente. Tuttavia, se il collegamento ipertestuale punta a un argomento di un'altra applicazione, viene aperta una nuova finestra dell'aiuto. I collegamenti di questo tipo vengono detti collegamenti tra volumi o tra applicazioni.

#### Come selezionare un collegamento ipertestuale

1. Posizionare il puntatore sul testo sottolineato o sull'immagine.

2. Fare clic con il pulsante del mouse di sinistra.

## Spostamento tra argomenti dell'aiuto

Per spostarsi tra gli argomenti dell'aiuto sono disponibili i seguenti comandi del menu Sfogliare:

Ripercorrere indietro | Torna all'argomento precedente. Con questo comando è possibile ripercorrere in senso inverso tutti gli argomenti visualizzati.
Registrazione cronologica | Apre un riquadro di dialogo che presenta i volumi e gli argomenti dell'aiuto visualizzati nel corso della sessione. Selezionando uno di questi argomenti sarà possibile visualizzarlo nuovamente.
Argomento iniziale | Torna all'argomento iniziale, cioè alla pagina iniziale del volume di aiuto.

I comandi “Ripercorrere indietro” e “Registrazione cronologica” sono disponibili anche in forma di pulsanti.

### Menu a scomparsa dell'aiuto

Per maggiore comodità degli utenti, nelle finestre dell'aiuto generale è disponibile anche un menu a scomparsa con i comandi “Ripercorrere indietro” e “Argomento iniziale”.

Le finestre dell'aiuto rapido non dispongono di menu a scomparsa.

#### Come visualizzare il menu a scomparsa

1. Puntare sull'area di visualizzazione degli argomenti e premere il pulsante del mouse di destra.

2. Scegliere “Ripercorrere indietro” o “Argomento iniziale”.

##### Il menu a scomparsa dell'aiuto

### Determinazione della posizione corrente

Tutte le applicazioni del desktop possiedono un proprio volume di aiuto. Ogni volume consiste in un gruppo di argomenti che descrivono le funzioni dell'applicazione e le procedure per il loro utilizzo. Nella maggior parte dei casi, l'aiuto di un'applicazione è strutturato in tre argomenti principali: Nozioni generali, Attività e Riferimenti.

#### Organizzazione di un volume di aiuto

L'argomento iniziale è la pagina introduttiva del volume di aiuto. Gli argomenti principali sono accessibili dall'argomento iniziale o dal menu Aiuto dell'applicazione.

#### Spostamenti tra diversi volumi di aiuto

In genere, i collegamenti ipertestuali visualizzano altri argomenti del volume di aiuto corrente. Ad esempio, un argomento della sezione Attività potrà contenere un collegamento ipertestuale a un altro argomento della sezione Riferimenti.

È anche possibile, tuttavia, che un gruppo di applicazioni correlate contenga collegamenti ipertestuali che rimandino ad altri volumi. Ad esempio, un'applicazione potrebbe contenere un collegamento ipertestuale al volume dell'introduzione al desktop riguardante le operazioni fondamentali con il mouse e la tastiera.

Poiché i collegamenti ipertestuali possono portare rapidamente da una sezione ad un'altra, può essere difficile mantenere il controllo esatto degli spostamenti. La finestra dell'aiuto, tuttavia, permette di ritrovare facilmente l'orientamento.

- La riga situata sotto la barra dei menu riporta il nome del volume correntemente visualizzato. Questa indicazione è molto utile quando si effettuano spostamenti in diversi volumi dell'aiuto.

- Nella struttura degli argomenti, la prima voce è sempre l'argomento iniziale, cioè l'inizio del volume di aiuto. Dopo avere consultato diversi argomenti, è possibile tornare facilmente all'argomento iniziale risalendo all'inizio della struttura degli argomenti, oppure scegliendo “Argomento iniziale” dal menu Sfogliare o dal menu a scomparsa.

- La freccia (˛) che compare nella struttura degli argomenti punta al titolo dell'argomento correntemente visualizzato. Essa permette così di identificare la posizione corrente rispetto agli altri argomenti del volume.

### Traccia degli argomenti visualizzati

La finestra dell'aiuto generale conserva una traccia degli argomenti visualizzati nel corso della sessione. Il comando “Registrazione cronologica” apre un riquadro di dialogo che presenta i volumi e gli argomenti dell'aiuto visualizzati fino a quel momento.

#### Riquadro di dialogo “Registrazione cronologica”

#### Come usare la registrazione cronologica per tornare a un argomento visualizzato in precedenza

1. Fare clic sul pulsante “Registrazione cronologica”.

2. Scegliere il volume o l'argomento di aiuto che si desidera visualizzare.

3. Al termine della consultazione, fare clic su Chiudere.

## Ricerca di informazioni specifiche

Ogni volume di aiuto comprende un indice analitico di parole ed espressioni significative per la ricerca delle informazioni. L'indice analitico può essere consultato per il solo volume corrente, per un gruppo di volumi selezionati o per tutti i volumi di aiuto disponibili sul sistema.

### Il riquadro di dialogo “Ricerca in indice analitico”

Poiché l'indice analitico può raggiungere dimensioni considerevoli, anche per un singolo volume, le sue voci possono essere espanse o contratte. Un segno più (+) davanti a una voce segnala un riferimento ad altri argomenti dell'aiuto, il cui numero è indicato dopo il più. Questi argomenti verranno mostrati facendo clic sulla voce corrispondente.

Ad esempio, la UG.GHelp.mkr.14 mostra il risultato di una ricerca nell'indice analitico eseguita sulla parola “file”. Il “-49” iniziale indica che sono state trovate 49 voci contenenti la parola “file”. Facendo clic su uno dei titoli preceduti dal segno più (+), la lista verrà espansa e il più (+) si trasformerà in un meno (-). La voce indicata da -2 nella figura è stata espansa in questo modo.

### Ricercare un argomento usando l'indice analitico dell'aiuto

L'indice analitico è disponibile solo nelle finestre dell'aiuto generale.

1. Per aprire l'indice analitico, fare clic sul pulsante “Indice analitico”.

   Verranno mostrate tutte le voci contenute nell'indice analitico del volume corrente. Si potrà scegliere Tutti i volumi per ottenere l'indice analitico di tutti i volumi di aiuto disponibili, oppure Volumi selezionati per ottenere quello di alcuni volumi specifici.

2. Selezionare il campo “Voci contenenti”, inserire la parola o l'espressione da ricercare e premere Return.

   Le ricerche nell'indice analitico non fanno distinzione tra maiuscole e minuscole, e accettano l'uso di caratteri speciali come l'asterisco (*) e il punto interrogativo (?) (vedere il paragrafo seguente, UG.GHelp.mkr.16).

3. Selezionare la voce dell'indice che si desidera visualizzare.

   Se la voce è preceduta da un segno più (+), la lista si espanderà per mostrare altre voci correlate.

   È possibile visualizzare qualsiasi numero di argomenti.

4. Al termine della consultazione, fare clic su Chiudere.

#### Uso dei caratteri speciali in una ricerca

Le ricerche possono essere effettuate usando i cosiddetti “caratteri speciali”, cioè caratteri che nel contesto di una ricerca hanno un significato particolare.

I due caratteri speciali più usati sono l'asterisco ( `*`) e il punto interrogativo (`?`). L'asterisco corrisponde a qualsiasi stringa di caratteri (incluse le stringhe vuote), mentre il punto interrogativo corrisponde a qualunque carattere singolo. Gli altri caratteri speciali sono:

. (punto) | Corrisponde a qualsiasi carattere
| (barra verticale) | Specifica l'uso di due modelli di ricerca (OR logico)
() (parentesi) | Racchiudono un'espressione del modello di ricerca

Per ricercare un carattere che in un contesto di ricerca ha un significato particolare, anteporre al carattere una barra rovesciata (\).

##### Esempi

mouse.*clic | Trova le voci che contengono la parola “mouse” seguita da un qualsiasi numero di caratteri e dalla stringa “clic”
mouse | clic | Trova le voci che contengono la parola “mouse” o la parola “clic”
gestione.*(sessioni | stili) | Trova le voci che contengono “Gestione delle sessioni” o “Gestione degli stili”

## Consultazione dell'aiuto sul sistema

È possibile consultare tutti i volumi di aiuto registrati sul sistema senza bisogno di avviare ogni applicazione singolarmente, ma semplicemente avviando la Gestione dell'aiuto dal Pannello principale.

Al livello più elevato, la Gestione dell'aiuto raggruppa i volumi in famiglie di aiuto. Ad esempio, la famiglia del Common Desktop Environment contiene i volumi per le applicazioni standard del desktop. È possibile sfogliare e visualizzare uno qualsiasi dei volumi elencati.

### Avvio della Gestione dell'aiuto

1. Fare clic sul controllo della Gestione dell'aiuto nel Pannello principale (vedere la ug.ghelp.mkr.5).

   Verrà aperta la finestra della Gestione dell'aiuto al livello più elevato, con un elenco delle famiglie disponibili.

   #### Livello più elevato della Gestione dell'aiuto

2. Scorrere la finestra per localizzare il prodotto a cui si è interessati e fare clic sul titolo corrispondente (sottolineato).

   Verrà visualizzato l'elenco dei volumi di aiuto disponibili per quel prodotto.

3. Per aprire un determinato volume di aiuto, fare clic sul titolo corrispondente (testo sottolineato).

4. Per tornare al livello più elevato della Gestione dell'aiuto, fare clic sul pulsante
   “Livello più elevato”.

#### Esempio

Per consultare l'aiuto online della Gestione di file:

1. Fare clic sul controllo della Gestione dell'aiuto.

2. Scegliere Common Desktop Environment.

3. Scorrere la lista dei volumi per localizzare l'aiuto della Gestione di file.

4. Fare clic su “Aiuto sulla Gestione di file”.

   Verrà visualizzato l'aiuto della Gestione di file. Le stesse informazioni possono essere ottenute aprendo la Gestione di file e scegliendo Panoramica dal menu Aiuto.

##### L'aiuto della Gestione di file visualizzato nella Gestione dell'aiuto

### Duplicazione di una finestra dell'aiuto

1. Scegliere “Nuova finestra” dal menu File della Gestione dell'aiuto.

   Verrà aperta una nuova finestra identica a quella corrente. La nuova finestra dell'aiuto potrà essere ridimensionata e utilizzata in modo indipendente da quella originale.

2. Per chiudere la finestra, scegliere Chiudere dal menu File.

Il comando “Nuova finestra” è disponibile solo nella finestra della Gestione dell'aiuto (vedere UG.GHelp.mkr.17).

## Visualizzazione delle pagine di spiegazioni

Le pagine di spiegazioni del manuale di riferimento, comunemente note come “pagine man”, possono essere visualizzate usando l'azione “Visualizzazione delle pagine di spiegazioni”. L'icona di questa azione si trova nella cartella Applicazioni_desktop nella Gestione di applicazioni.

### Icona dell'azione “Visualizzazione delle pagine di spiegazioni”

### Come visualizzare una pagina di spiegazioni

1. Fare clic sul controllo della Gestione di applicazioni nel Pannello principale.

2. Fare doppio clic sull'icona Applicazioni_desktop.

3. Fare clic sull'icona “Visualizzazione delle pagine di spiegazioni”.

   Verrà aperto un riquadro di dialogo con la richiesta di inserire il nome di una pagina di spiegazioni.

4. Digitare il nome della pagina di spiegazioni desiderata e premere Return.

   La pagina di spiegazioni verrà visualizzata in una finestra dell'aiuto rapido.

5. Per uscire dalla pagina di spiegazioni, fare clic su Chiudere.

## Stampa degli argomenti dell'aiuto

Talvolta può essere utile disporre di una copia stampata dell'aiuto di un'applicazione. La Gestione dell'aiuto permette di stampare un singolo argomento, l'indice e l'indice analitico di un volume oppure un intero volume di aiuto. È inoltre possibile specificare una serie di opzioni, come il formato del foglio, il numero di copie e la stampante da utilizzare.

Se non specificato diversamente, verrà utilizzata la stampante predefinita. L'output della stampa conterrà unicamente il testo dell'aiuto.

### Come stampare un argomento dell'aiuto

1. Scegliere Stampare dal menu File. (In una finestra dell'aiuto rapido, fare clic sul pulsante Stampare.)

   È possibile usare i valori predefiniti del riquadro di dialogo e passare direttamente al punto 5, oppure inserire nuovi valori per il lavoro di stampa.

2. Opzionale. Inserire il nome della stampante da usare.

3. Opzionale. Inserire il numero delle copie da stampare.

4. Opzionale. Fare clic sul pulsante “Formato del foglio” e scegliere la dimensione desiderata.

5. Selezionare l'argomento o gli argomenti da stampare.

   Argomento corrente (impostazione predefinita) | Stampa solo l'argomento corrente
   Argomento corrente e sottoinsiemi | Stampa l'argomento corrente e gli argomenti secondari
   Indice e indice analitico | Stampa l'indice e l'indice analitico del volume di aiuto
   Tutti gli argomenti del volume | Stampa l'intero contenuto del volume di aiuto, inclusi l'indice e l'indice analitico.

6. Fare clic su Stampare.

### Configurazione della stampante

Il riquadro di dialogo Stampa mostra il nome della stampante predefinita. Questa impostazione può essere cambiata modificando la variabile d'ambiente `LPDEST`. È anche possibile cambiare la stampante per un'applicazione specifica modificando il file delle impostazioni predefinite di quell'applicazione.

#### Come impostare la stampante per un'applicazione

- Editare il file `DirectoryIniziale/.Xdefaults` aggiungendo la risorsa seguente:

  `nome_applicazione*printer: nome`

  Se non si dispone di un file `.Xdefaults`, crearlo nella propria directory iniziale.

##### Esempio

Si supponga di voler indirizzare la stampa di tutti gli argomenti di aiuto dell'applicazione ImageScan a una stampante di nome `laser2` anziché alla stampante predefinita.

Aggiungere la risorsa seguente al proprio file `.Xdefaults`:

    ImageScan*printer:     laser2

## Modifica dei colori delle finestre di aiuto

È possibile cambiare i colori della struttura degli argomenti o dell'area di visualizzazione delle finestre di aiuto modificando le risorse dell'applicazione. È importante scegliere colori contrastanti, per garantire che il testo (visualizzato nel colore di primo piano) risulti ben leggibile sul colore di sfondo.

### Come cambiare i colori della finestra di aiuto di un'applicazione

1. Editare il proprio file `DirectoryIniziale/.Xdefaults` aggiungendo le risorse seguenti:

    nome_applicazione*DtHelpDialog*DisplayArea.foreground: colore
    nome_applicazione*DtHelpDialog*DisplayArea.background:   colore
    nome_applicazione*DtHelpDialog*TocArea.foreground:    colore
    nome_applicazione*DtHelpDialog*TocArea.background:   colore
    nome_applicazione*DtHelpQuickDialog*DisplayArea.foreground:   colore
    nome_applicazione*DtHelpQuickDialog*DisplayArea.background:   colore

Al posto di nome_applicazione, specificare il nome dell'applicazione su cui si desidera eseguire la modifica.

Per conoscere l'elenco dei colori disponibili, rivolgersi all'amministratore o consultare la documentazione del sistema.

1. Salvare e chiudere il file.

   All'avvio successivo dell'applicazione, la relativa finestra dell'aiuto userà i nuovi valori per la struttura degli argomenti e per l'area di visualizzazione.

#### Esempio

Le risorse seguenti modificano i colori di primo piano e di sfondo della struttura degli argomenti (TocArea) e dell'area di visualizzazione (DisplayArea) per un'applicazione di nome DtCardCatalog.

    DtCardCatalog*DtHelpDialog*TocArea.foreground:  yellow
    DtCardCatalog*DtHelpDialog*TocArea.background:  blue
    DtCardCatalog*DtHelpDialog*DisplayArea.foreground:  yellow
    DtCardCatalog*DtHelpDialog*DisplayArea.background:  blue
    DtCardCatalog*DtHelpQuickDialog*DisplayArea.foreground:  yellow
    DtCardCatalog*DtHelpQuickDialog*DisplayArea.background:  blue

Poiché le finestre dell'aiuto rapido non dispongono di una struttura degli argomenti, la risorsa `TocArea` viene omessa per questo tipo di finestra.