# &khelpcenter;

## Manuale della guida di &kde;

### Guida

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 utente di applicazioni tra cui &plasma-workspaces; della comunità &kde; (&XML;).

Tutte le applicazioni (tra cui &plasma-workspaces;) della comunità 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.

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

Dall'avviatore di applicazioni

- Scegli la grande K nel pannello, quindi la scheda Applicazioni e poi scegli Aiuto oppure scrivi `aiuto` selezionando Aiuto. Ciò aprirà &khelpcenter; 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 tre schede: una contiene una vista ad albero che mostra tutta la struttura del centro d'informazione &khelpcenter;, l'altra contiene il glossario dei termini usati in &kde;. Nella terza scheda puoi configurare le Opzioni di ricerca.

##### La scheda Indice

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

Fondamentali

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

Manuale di Plasma

- Il manuale di &plasma; è la documentazione di &plasma-workspaces;.

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.

Voci Moduli delle Impostazioni

- Fornisce una lista di collegamenti ai vari moduli di configurazione delle &systemsettings;, oppure ai moduli di &konqueror;, come gestore di file o browser.

Moduli di KInfoCenter

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

Worker KIO

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

##### La schema Opzioni di ricerca

La ricerca nei file di aiuto è abbastanza intuitiva: inserisci nella casella di testo la parola (o le parole) che vuoi cercare, opzionalmente scegli le opzioni che vuoi, e premi Cerca. I risultati sono mostrati a destra, nel riquadro di visualizzazione.

Maiuscole e minuscole sono considerate allo stesso modo nella ricerca. Ad esempio, se cerchi Scorciatoia, saranno mostrati risultati che contengono anche scorciatoia.

Le opzioni disponibili sono:

Metodo

- Scegli come cercare usando più parole. Se scegli e, i risultati sono restituiti solo se tutti i termini della ricerca sono inclusi nella pagina. o restituisce risultati se qualsiasi dei termini di ricerca è stato trovato..

  Se le ricerche non danno i risultati sperati, controlla attentamente che le impostazioni delle ricerche non escludano i termini della ricerca sbagliati.

Risultati massimi

- Determina il numero massimo di risultati restituiti dalla ricerca.

Selezione del contesto

- Questa è usata per scegliere le sezioni in cui cercare. Le opzioni disponibili permettono di scegliere velocemente le combinazioni più comuni, mentre Personalizzato permette di scegliere specifiche sezioni.

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

Visualizza Modalità a schermo intero

- Cambia &khelpcenter; in modalità a schermo intero, in cui la finestra di &khelpcenter; occupa l'intero schermo e non ha le solite decorazioni della finestra. Per uscire dalla modalità a schermo intero, premere &Ctrl;&Shift; F.

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.

Segnalibri

- &Ctrl;B Segnalibri Aggiungi un segnalibro

- Aggiunge un segnalibro per la pagina corrente, aggiungendo il titolo della pagina al menu dei segnalibri. Usa l'azione Elimina segnalibro nel menu contestuale di un segnalibro per rimuoverlo dal menu.

Segnalibri Nuova cartella di segnalibri

- Apre la finestra di dialogo Nuova cartella dove puoi creare nuove sottocartelle nel menu dei segnalibri.

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;