# Manuale utente della Guida di &kde;

## Guida di &kde;

Il sistema di aiuto di &kde; è stato realizzato per accedere con facilità al sistema di aiuto di &UNIX; (man e info), così come è possibile fare per la documentazione nativa di &kde; (&XML;).

Tutte le applicazioni base del &kde; sono fornite di documentazione, grazie agli sforzi del team di Documentazione. Se vuoi aiutare, chiedi informazioni al coordinatore della Documentazione, Lauri Watts, all'indirizzo lauri@kde.org. Non è necessario che tu abbia esperienza, basta avere pazienza e voglia di fare.

Se vuoi partecipare alla traduzione della documentazione di &kde; nella tua lingua madre, il coordinatore delle traduzioni Thomas Diehl thd@kde.org darà il benvenuto a te e all'aiuto che darai. Puoi trovare altre informazioni, tra cui l'elenco dei coordinatori di ogni team nazionale, sul collegamento Internationalization web site, oppure nella sezione Contatti di questo documento.

### Installazione

&khelpcenter; è parte integrante dell'installazione base di &kde;, e viene installato in ogni copia di &kde;. Puoi trovarlo nel pacchetto kdebase, ed è disponibile in &kde-ftp; o puoi trovarlo nel pacchetto kdebase del tuo sistema.

## Come trovare l'Aiuto

Al &khelpcenter; puoi accedere in diversi modi:

Dal menu Aiuto

- Il caso più comune è dall'interno di un'applicazione. Scegli Aiuto Indice per aprire l'Aiuto dell'apllicazione partendo dalla pagina dell'indice.

Dal menu K

- Fai clic sulla grande K sul pannello, e seleziona Aiuto per aprire &khelpcenter; alla pagina iniziale.

Dal pannello

- Anche il pannello, &kicker;, contiene un'icona per aprire &khelpcenter;. Di nuovo, viene mostrata la pagina iniziale, che comprende l'indice.

Dalla riga di comando

- &khelpcenter; può anche essere avviato digitando un &URL; per visualizzare uno specifico file. Puoi anche accodare un &URL; ai comandi `info` e `man` per raggiungere una data pagina. Vedi di seguito esempi di sintassi:

  L'Aiuto di un'applicazione

- `khelpcenter` `help:/`kedit``

  Apre il file di aiuto di &kedit; alla pagina dell'indice.

Un &URL; locale

- `khelpcenter` `file:/ `usr/local/src/qt/html/index.html``

Una pagina Man

- `khelpcenter` `man:/`strcpy``

Una pagina di informazioni

- `khelpcenter` `info:/`gcc``

Digita `khelpcenter` senza parametri per aprire la pagina di benvenuto.

## L'interfaccia di &khelpcenter;

L'interfaccia del Centro informazioni &khelpcenter; ha due riquadri.

La barra degli strumenti e i menu sono spiegati in menu-and-toolbar-ref.

Ogni documento contiene i suoi strumenti di navigazione, e ti consente di muoverti dall'inizio alla fine del documento usando i collegamenti Successivo, Precedente, e Home, oppure di spostarti ad altri argomentiusando gli hyperlinks.

I collegamenti ti possono portare ad un'altra parte dello stesso documento, o a un documento diverso, e puoi usare le icone Indietro (Freccia a sinistra) o Avanti (Freccia a destra) sulla barra degli strumenti per muoverti attraverso i documenti che hai visto in questa sessione.

I due riquadri mostrano l'indice del'Aiuto, e i file che lo compongono, rispettivamente a sinistra e a destra.

### Il riquadro Indice

Il riquadro Indice nel &khelpcenter; viene mostrato sul lato sinistro della finestra. Come è logico, puoi muovere la barra di scorrimento per leggere agevolmente il contenuto di ogni riquadro.

Il riquadro Indice presenta due linguette; una contiene il menu che mostra tutta la struttura del centro informazioni &khelpcenter;, la seconda contiene il glossario dei termini usati in &kde;.

#### Il menu Indice

L'Indice contiene i seguenti elementi:

Introduzione

- Benvenuto in &kde; - un'introduzione all'Ambiente Desktop KDE.

Introduzione a &kde;

- La Guida rapida di &kde;. Contiene una panoramica dell'interfaccia &kde; e aiuti e suggerimenti specifici su come lavorare più rapidamente con &kde;.

Il Manuale utente di &kde;

- Il Manuale Utente di &kde; è una profonda esplorazione di &kde;, che spazia dall'installazione alla configurazione e personalizzazione, fino all'uso.

I Manuali delle applicazioni

- Documentazione delle applicazioni native del &kde;. Tutte le applicazioni &kde; hanno documentazione in formato &XML;, che viene convertito in HTMLquando viene visualizzato. Questa sezione elenca tutte le applicazioni &kde;, fornendoti una breve descrizione e un collegamento alla documentazione completa.

  Le applicazioni sono mostrate in una struttura ad albero che riecheggia la struttura del menu K, rendendo più immediato trovare l'applicazione che cerchi.

Pagine man di &UNIX;

- Le pagine "man" di &UNIX; sono il formato tradizionale di documentazione on-line dei sistemi &UNIX;. La maggior parte dei programmi del sistema hanno pagine "man". Inoltre, le pagine "man" esistono per le funzioni di programmazione e i formati dei file.

Sfoglia le pagine info

- La documentazione in formato TeXinfo è usata da molti applicativi &GNU;, tra cui `gcc` (il compilatore C/C++), `emacs`, e molti altri.

Esercitazioni

- Brevi esercitazioni con specifico argomento o informative.

Le FAQ su &kde;

- Le domande più frequenti su &kde; e le relative risposte.

&kde; nel Web

- Collegamenti a &kde; sulla rete, al sito ufficiale di &kde; e altri siti utili.

Contatti

- Informazioni su come mettersi in contatto con gli sviluppatori &kde;, e su come sottoscrivere le mailing list di &kde;.

Come sostenere &kde;

- Come aiutare.

### Le sezioni Man e Info

Le pagine "man" sono il sistema standard di manualistica di &UNIX;, e sono state usate da molti sistemi operativi per anni. Sono estremamente approfondite, e sono veramente la miglior fonte di informazioni sulla maggior parte dei comandi e applicazioni &UNIX;. Quando qualcuno ti risponde "RTFM" (Read The F*** Manual, ovvero: leggi il dannato manuale), il manuale cui si riferisce è quasi sempre una pagina man.

Le pagine man non sono perfette. Tendono ad essere molto approfondite, ma anche estremamente tecniche, dato che spesso sono scritte da sviluppatori per sviluppatori. In qualche caso ciò le rende abbastanza complesse, o addirittura incomprensibili per molti utenti. Tuttavia, rimangono la migliore fonte di informazioni attendibili per la maggior parte delle applicazioni a riga di comando, e molto spesso sono l'unica fonte.

Ti sei mai chiesto cosa significhi il numero che trovi nelle indicazioni del tipo "man(1)"? (1) indica la sezione del manuale nella quale si trova l'argomento. Noterai che anche &khelpcenter; usa i numeri per dividere le molte pagine man nelle sue sezioni, rendendoti più facile trovare le informazioni che stai cercando, se stai solo dando una scorsa.

Ci sono anche le pagine Info, che tendono a sostituire le pagine man. Chi fa manutenzione su alcune applicazioni non aggiorna più le pagine man, quindi se trovi sia la pagina man che la info, quest'ultima è probabilmente la più aggiornata. La maggior parte delle applicazioni hanno l'una o l'altra. Se l'applicazione per la quale stai cercando informazioni è una utility &GNU;, molto probabilmente troverai una pagina info, non una pagina man.

#### Navigazione nelle pagine Info

I documenti Info sono ordinati gerarchicamente, a ogni pagina ci si riferisce come a un nodo. Tutti i documenti Info hanno un nodo Top, &ie; la pagina d'apertura. Puoi ritornare alla pagina Top di un documento facendo clic su Top.

I pulsanti Precedente & Successivo sono utilizzati per spostarsi alla precedente o successiva pagina dello stesso livello.

Facendo clic su un elemento del menu all'interno di un documento, ti sposti ad un livello gerarchicamente più basso. Puoi risalire la scala gerarchica facendo clic su Su.

Le pagine man hanno una struttura simile alle info, con la sezione dell'indice al primo livello e ciascuna pagina di manuale al livello sottostante. Gli argomenti sono lunghi una pagina.

### Il Glossario &kde;

Il glossario fornisce un rapido punto di riferimento, dove trovare la definizione di termini che non ti sono familiari. Questi spaziano da applicazioni o tecnologie specifiche del &kde;, a termini comuni a tutto l'ambiente &UNIX;.

Nel riquadro di sinistra puoi vedere una lista ad albero, con due possibilità di scelta: Alfabeticamente o Per argomento. Entrambe contengono gli stessi termini, ma diversamente ordinati, per consentirti di trovare velocemente ciò che ti interessa.

Scorri la lista ad albero sulla sinistra: sulla destra apparirà l'argomento che hai selezionato.

### I menu e la barra degli strumenti

&khelpcenter; ha un'interfaccia molto ridotta, che ti consente di concentrarti sulla ricerca dell'aiuto, invece di farti perder tempo nel cercare di imparare come funziona il sistema di aiuto.

Le icone che trovi sulla barra degli strumenti sono:

### Icone della barra degli strumenti

Indietro

- Ti riporta alla pagina precedente.

Avanti

- Ti porta alla pagina successiva. L'icona è attiva solo se hai già usato Indietro

Stampa

- Stampa il contenuto della pagina corrente.

Cerca

- Trova una o più parole nella pagina corrente.

Aumenta carattere

- Incrementa il corpo del carattere nel riquadro di visualizzazione.

Diminuisci carattere

- Diminuisce il corpo del carattere nel riquadro di visualizzazione. Questa icona è abilitata solo se in precedenza hai ingrandito il testo.

Il menu contiene le seguenti voci:

File

- File Stampa frame

- Stampa il contenuto della pagina corrente.

&Ctrl;Q File Esci

- Chiudi il file corrente e il &khelpcenter;

Modifica

- &Ctrl;A Modifica Seleziona tutto

- Seleziona tutto il testo della pagina corrente.

&Ctrl;F Modifica Trova

- Trova una o più parole nella pagina corrente.

Visualizza

- Visualizza Mostra il sorgente del documento

- Visualizza il codice HTML della pagina che stai vedendo.

Visualizza Imposta la codifica

- Cambia la codifica della pagina corrente. Normalmente l'impostazione predefinita Automatica dovrebbe bastare, ma se hai problemi visualizzando pagine scritte in lingue diverse dall'italiano, potresti aver bisogno di impostare un codice specifico in questo menu.

Vai Indietro

- Va alla pagina che hai visto precedentemente.

Vai Avanti

- Se hai precedentemente usato il comando Indietro dall'icona o dal menu, puoi riprendere a scorrere in avanti con questo comando.

Vai ...

- In fondo all'elenco di voci del menu Vai troverai la cronologia delle pagine visitate più recentemente. Per rivederne direttamente una, basta che la selezioni e fai clic.

## Riconoscimenti e Licenza

&khelpcenter;

Stesura originale di &Matthias.Elter; &Matthias.Elter.mail;

Il responsabile attuale è &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

&underFDL; &underGPL;