# &khelpcenter;

## Manuale della guida di &kde;

### Guida di &plasma;

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

L'ambiente di lavoro di &plasma; e tutte le applicazioni base di &kde; sono fornite di documentazione, grazie agli sforzi della squadra di Documentazione. Se vuoi aiutare, iscriviti alla mailing list e contatta all'indirizzo kde-doc-english@kde.org la squadra di documentazione. Non è richiesta alcuna esperienza, basta avere pazienza e voglia di fare.

Se vuoi aiutare con la traduzione della documentazione di &kde; nella tua lingua, puoi consultare le informazioni - tra cui i coordinatori di ciascun gruppo di traduzione - sul sito web di localizzazione.

#### Installazione

&khelpcenter; è parte dell'ambiente di lavoro di &plasma;. Può essere scaricato sul sito del progetto &kde;, oppure trovato nel pacchetto &khelpcenter; del tuo sistema.

### Come trovare l'Aiuto

Puoi accedere a &khelpcenter; in diversi modi:

Dal menu Aiuto

- Il caso più comune è dall'interno di un'applicazione. Scegli F1 Aiuto Manuale di `applicazione` per aprire il manuale di quella `applicazione`.

Dal menu Kickoff di lancio applicazioni

- Scegli la grande K nel pannello, quindi la scheda Applicazioni e poi scegli Aiuto per aprire &khelpcenter;, che partirà con la pagina di partenza predefinita.

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:/`kwrite``

  Apre il file di aiuto di &kwrite;, alla pagina dei contenuti.

Un &URL; locale

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

Una pagina di «man»

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

Una pagina di «info»

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

Avviare `khelpcenter` senza alcun parametro apre la pagina di partenza predefinita.

### L'interfaccia di &khelpcenter;

L'interfaccia di &khelpcenter; ha due riquadri.

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

I documenti contengono strumenti di navigazione propri, permettendoti di spostarti sia in modo sequenziale attraverso un documento, usando i collegamenti Successivo, Precedente e Contenuti, sia di spostarti liberamente usando i collegamenti presenti.

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 sistema di aiuto, e i file che lo compongono, rispettivamente a sinistra e a destra.

#### Il riquadro dei contenuti

Il riquadro dei contenuti 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 dei contenuti presenta due schede: una contiene una vista ad albero che mostra tutta la struttura del centro informazioni &khelpcenter;, l'altra contiene il glossario dei termini usati in &kde;.

##### La scheda Indice

La scheda Indice contiene nella sua struttura ad albero i seguenti elementi principali:

Fondamentali di &kde;

- I «Fondamentali di &kde;» ti introducono alle varie funzioni di &kde; Software Collection e descrivono molte operazioni comuni che puoi effettuare in tutte le applicazioni &kde;.

Manuale di Plasma

- Il manuale di &plasma; è la documentazione della parte più visibile di &kde;, l'interfaccia principale del desktop.

Aiuto su Internet

- Una pagina con collegamenti alle guide su Internet e ad informazioni aggiuntive fornite alla comunità di &kde;.

Manuali delle applicazioni

- Documentazione delle applicazioni native del &kde;. Tutte le applicazioni &kde; hanno documentazione in formato &XML;, che viene convertito in HTML quando 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.

Moduli del centro di controllo

- Fornisce una lista di collegamenti ai vari moduli di configurazione delle &systemsettings;.

Moduli di KInfoCenter

- Contiene una lista di collegamenti alla documentazione dei vari moduli di KInfoCenter.

Kioslave

- Contiene una lista di collegamenti alla documentazione dei vari moduli KIO.

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.

Scrollkeeper

- Documentazione non &kde; aggiuntiva installata nel sistema.

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.

#### 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 di &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;.

Nella parte sinistra vedrai una lista ad albero con due scelte: Alfabeticamente o Per argomento. Entrambe contengono le stesse voci, solo ordinate in modo diverso, per permetterti 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

Indice

- Apre la pagina di partenza di &khelpcenter;.

Indietro

- Va alla pagina che hai visitato precedentemente. Premi il segno di spunta alla destra dell'icona per mostrare una lista delle pagine visitate precedentemente. Selezionarne una aprirà direttamente quella pagina.

Avanti

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

Copia

- Copia il testo negli appunti per incollarlo in altre applicazioni.

Cerca

- Trova una o più parole nella pagina corrente.

Aumenta dimensione caratteri

- Incrementa il corpo del carattere nel riquadro di visualizzazione.

Diminuisci dimensione caratteri

- 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

- &Ctrl;P File Stampa

- Stampa il contenuto della pagina mostrata. Puoi trovare i manuali in formato PDF sul sito della documentazione di &kde;.

&Ctrl;Q File Esci

- Chiude ed esce da &khelpcenter;

Modifica

- &Ctrl;C Modifica Copia

- Copia negli appunti il testo selezionato.

&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 Imposta la codifica

- Cambia la codifica della pagina corrente. Normalmente l'impostazione predefinita, Predefinita, dovrebbe essere sufficiente; tuttavia, se pagine scritte in lingue diverse dall'inglese non si vedono correttamente, puoi scegliere una codifica specifica usando questo menu.

Vai

- &Alt;Home Vai Indice

- Apre la pagina di partenza di &khelpcenter;.

&Ctrl;Pag Su Vai Pagina precedente

- Va alla pagina precedente della documentazione corrente.

&Ctrl;Pag Giù Vai Pagina successiva

- Va alla pagina successiva della documentazione corrente.

&Alt;Sinistra Vai Indietro

- Va alla pagina che hai visto precedentemente.

&Alt;Destra Vai Avanti

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

Impostazioni

- Impostazioni Configura caratteri...

- Ti permette di configurare la famiglia e la dimensione dei caratteri usati in &khelpcenter;.

Inoltre &khelpcenter; ha le voci dei menu Impostazioni e Aiuto comuni di &kde;; per maggiori informazioni, consulta i capitoli Menu Impostazioni e menu Aiuto dei «Fondamentali di &kde;».

### Riconoscimenti e licenza

&khelpcenter;

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

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

Traduzione italiana: Isabella Avanza iavanza@tiscalinet.it

Traduzione italiana: Massimiliano Donno massidonno@infinito.it

Traduzione italiana: Pino Toscano toscano.pino@tiscali.it

&underFDL; &underGPL;