Manuale utente della Guida di &kde;

2002-02-03 0.08.00 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 della squadra 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 squadra 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 tdebase, ed è disponibile in &kde-ftp; o puoi trovarlo nel pacchetto tdebase 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'applicazione 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 Apre il file di aiuto di &kedit; alla pagina dell'indice. Un &URL; locale khelpcenter Una pagina Man khelpcenter Una pagina di informazioni khelpcenter 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 . 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 argomenti usando i collegamenti ipertestuali. 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 <guilabel>Indice</guilabel> 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 <guilabel>Indice</guilabel> 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 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. 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. Riconoscimenti e Licenza &khelpcenter; Stesura originale di &Matthias.Elter; &Matthias.Elter.mail; Il responsabile attuale è &Cornelius.Schumacher; &Cornelius.Schumacher.mail; &underFDL; &underGPL;