# &koffice;

Un'introduzione generale
Jost
Schenck

    jost@schenck.de

Giovanni
Bacci

     s206756@studenti.ing.unipi.it

Traduzione della documentazione
2001-06-02
0.01.01

&koffice; è una suite integrata per l'ufficio per l'ambiente desktop KDE (&kde;)

KDE
KOffice

## Ancora da fare in questo manuale

Questa è una lista di cose che ancora hanno bisogno di lavoro in questo manuale:

- Scrivere questa lista

- Praticamente ogni altra cosa.

Se qualcuno vuole essere di aiuto, fatemelo sapere all'indirizzo di seguito. Grazie.

Jost jost@schenck.de

## Introduzione

&koffice; è una suite integrata per l'ufficio per l'ambiente Desktop KDE (&kde;). &koffice; attualmente consiste dei seguenti programmi:

- &kword; (un programma di videoscrittura basato sulle cornici)
- &kspread; (un foglio di calcolo)
- &kpresenter; (presentazioni su schermo e lucidi)
- &kontour; (un'applicazione per il disegno vettoriale)
- &kformula; (un editor per formule matematiche)
- &kchart; (un programma per il disegno di grafici)
- &kivio;
- &kugar;

Dato che essi sono basati sul modello dei componenti KParts, i programmi di &koffice; sono pensati per lavorare molto bene assieme agli altri. Ogni componente di &koffice; può essere incluso in un altro documento di &koffice;. Per esempio puoi inserire una tabella che hai creato in &kspread; direttamente in un documento &kword;. In questo modo documenti complessi ed articolati possono essere creati usando i programmi di &koffice;.

Un sistema di moduli rende semplice estendere le funzionalità di &koffice;. Esistono già due applicazione, un registratore di macro ed una calcolatrice, che mostrano come questo possa essere fatto.

Questo manuale copre solo le funzionalità generali di &koffice;, quelle che sono comuni alla maggior parte o a tutti i programmi nella suite. Per informazioni dettagliate a proposito dei diversi programmi, fai riferimento agli altri manuali.

## Primi passi in &koffice;

## KParts - i blocchi che costituiscono &koffice;

Ogni applicazione di &koffice; è disegnata per soddisfare esigenze piuttosto specifiche. Per esempio, &kspread; è un programma per manipolare i fogli di calcolo, mentre &kword; è un programma per la videoscrittura. Concentrandosi su di un'area specifica, ogni programma ricerca di fare il meglio possibile in quest'area. Tuttavia, a seconda di che cosa vuoi fare con &koffice;, avrai spesso bisogno delle funzionalità fornite da una differente applicazione, ma nello stesso documento.

Supponiamo che tu stia preparando un documento in &kword; e che tu desideri illustrare qualche punto utilizzando una tabella. Benché &kword; fornisca una sua possibilità interna per l'inserimento delle tabelle, questo può non essere sufficiente per le tue necessità. Per esempio, puoi voler utilizzare certi formati per la valuta, oppure eseguire dei calcoli con le formule del foglio di calcolo. Bene, alcuni programmatori di &kword; certamente possono provare ad implementare questa funzionalità. Tuttavia &kword; non sarà mai efficiente come &kspread; in questo settore e cercando di implementare tutte le funzionalità di cui potresti aver bisogno, inizierebbe a divenire irragionevolmente complesso ed il codice sorgente sarebbe impossibile da manutenere.

L'alternativa a questo è KPart. La sua filosofia è semplice: lascia che ogni applicazione faccia ciò che le riesce meglio.

### Comporre i documenti con KParts

Con KParts i tuoi documenti possono utilizzare tutte le funzionalità offerte da tutte le applicazioni di &koffice;. Puoi trarre vantaggio da questo inserendo le così dette parti nel tuo documento. Ognuna di queste parti è essenzialmente un altro documento, in pratica un documento all'interno di un altro documento.

Nell'esempio menzionato in precedenza, dovresti semplicemente inserire una parte &kspread; nel tuo documento &kword;. Quindi, quando modifichi la tabella, &kspread; prenderà il controllo. Il controllo tornerà a &kword; quando termini di lavorare sulla tabella e ricominci a lavorare sul testo. L'unico cambiamento che noterai è che le barre degli strumenti e dei menu, mentre modifichi la tabella, riflettono le funzionalità di &kspread; invece di quelle di &kword;. L'abilità di inserire le funzionalità di una applicazione in un'altra è detta inclusione (embedding).

### Usare KParts nel tuo documento

Se non hai mai lavorato con dei documenti composti, all'inizio puoi trovarli un po' complicati. Le seguenti istruzioni passo passo ti mostrano che usare KParts è semplice come lavorare con una singola applicazione.

#### Inserire una parte &kspread; in un'applicazione &kword;

1. Avvia &kword;. Puoi farlo sia dal pannello, che digitando ``kword`` nella riga dei comandi.

2. Inizia un nuovo documento. Se vuoi inserisci un po' di testo.

3. Scegli Crea cornice per una tabella di KSpread dal menu Strumenti. Noterai che il cursore del mouse si è trasformato in una croce. Questa forma del cursore indica che sei invitato a selezionare un'area.

4. Premi il pulsante &LMB; del mouse dove vuoi che sia l'angolo in alto a sinistra della tua tabella, tienilo premuto e trascinalo fino all'angolo in basso a destra. Lascia il pulsante. Ecco fatto.

Facile, no? Adesso dovresti vedere una cornice di una tabella nel tuo documento &kword;. Adesso fai click dentro la tabella per vedere che cosa accade. Noterai che:

- La barra dei menu e le barre degli strumenti sono cambiate. Adesso coincidono con quelle di &kspread;.

- La tua cornice della tabella adesso contiene gli elementi di una vista di &kspread;, con le barre degli strumenti, una barra con le linguette per la selezione delle tabelle, &etc;.

Prova a modificare la tabella. Vedrai che non è diverso da utilizzare &kspread;. Effettivamente tu stai utilizzando &kspread;.

Adesso fai click in un punto del tuo documento &kword;, al di fuori dell'area della tabella. La barra dei menu e le barre degli strumenti dovrebbero tornare quelle di &kword;, e gli elementi della vista di &kspread; dovrebbero scomparire. La tua tabella resta e mostra tutte le modifiche che hai eseguito.

KParts è semplice da usare. Prova ad inserire altre parti o anche parti all'interno di parti.

## Ottimizzare &koffice; ed il tuo sistema.

Benché &koffice; dovrebbe funzionare tranquillamente senza nessuna modifica, ci possono essere alcune cose da ottimizzare per avere il meglio da &koffice;. Questo capitolo ti mostra che cosa puoi voler fare per avere i migliori risultati con la tua nuova suite per l'ufficio.

### Ottimizzare la riproduzione dei caratteri

I caratteri sono un argomento difficile in X Window. In questa sezione parleremo di alcuni problemi che sono riportati di frequente da persone che utilizzano &koffice;. Alcuni problemi non sono causati da un errore di &koffice;, ma dipendono dalla tua configurazione di sistema, ragione per cui puoi aver bisogno di modificare i file di configurazione del sistema per poterli risolvere. Se non hai accesso come utente root al tuo sistema, dovresti parlare del problema che hai al tuo responsabile del sistema e indirizzarlo a questo manuale. Dato che i problemi sui caratteri sono troppo complessi per discuterli tutti qui, puoi aver bisogno di consultare il Font HOWTO da cui ho preso le informazioni seguenti. Troverai lì maggiori dettagli.

#### Come ottenere caratteri ben proporzionati sullo schermo

ROBA

#### Come avere una corretta stampa

Mentre &koffice; gestisce automaticamente tutti i caratteri di X11 sullo schermo, la stampa può dare qualche problema: su molti sistemi la stampa è eseguita via ghostscript. Adesso, mentre &koffice; conosce i nomi dei caratteri usati da X Window, normalmente non conosce i nomi dei caratteri utilizzati da ghostscript. &koffice; cerca di sapere questi nomi, ma non sempre ci riesce.

Questo problema può essere risolto, anche se non è semplice. Può darsi che tu stia utilizzando una distribuzione che ha già fatto la maggior parte del lavoro per te (quindi se non hai motivo di lamentarti della stampa puoi saltare questa sezione). Quello che devi fare è dire a ghostscript come tradurre i nomi dei caratteri che &koffice; suppone ed utilizza per i nomi dei propri caratteri. Questo può essere fatto aggiungendo una riga ad un file chiamato `Fontmap`. Una riga con un nome alternativo (alias) assomiglia al seguente esempio:

##### Un nome alternativo (alias) nella mappa dei caratteri di ghostscript

    /Algerian-Roman /Algerian       ;

Fai attenzione perché uno spazio prima del ';' è obbligatorio. In questo esempio, Algerian-Roman è il nome che &koffice; utilizza per Algerian. Dovrai aggiungere delle linee come queste per i caratteri che &koffice; non mostra correttamente. Per rendere questo lavoro più semplice, Donovan Rebbechi ha scritto un breve programma in perl che puoi trovare qui: http://pegasus.rutgers.edu/~elflord/font_howto/kwdfont. Supponendo che il tuo file di caratteri sia `/usr/share/ghostscript/fonts/fontfile.ttf` digiterai ``kwdfont``/usr/share/ghostscript/fonts/fontfile.ttf`` per avere i giusti nomi alternativi. Il programma dovrebbe funzionare nella maggior parte dei casi. come già detto, dovresti dare un'occhiata al Font HOWTO per maggiori è più accurate informazioni.

### Personalizzare la &GUI; di &koffice;.

Benché &koffice; sia fornito di una &GUI; (acronimo di Graphical User Interface, interfaccia grafica per l'utente in italiano) che dovrebbe essere adeguata per le esigenze della maggior parte degli utenti, ci sono buone ragioni per cui puoi desiderare di cambiare l'aspetto del programma.

Mia madre, per esempio, è un po' spaventata dai pulsanti e dalle voci del menu che non comprende. Per adattare &koffice; alle sue necessità, ho ridotto la &GUI; alle sue funzionalità minime. Dato che lei deve solo scrivere lettere ed usare alcuni modelli, non c'è bisogno di molte delle funzionalità di salvataggio, caricamento, stampa, &etc;

Grazie al concetto di azione in &Qt; e &kde;, puoi personalizzare liberamente le barre degli strumenti ed i menu di &koffice;. Purtroppo al momento non ci sono finestre di dialogo semplici da utilizzare per fare ciò. &koffice; tiene la configurazione della &GUI; in file &XML; e quindi dovrai modificare questi. Probabilmente questa situazione cambierà in futuro, per adesso però avrai bisogno di qualche conoscenza di base di come è strutturato un documento &XML; (oppure di HTML che è un sottoinsieme del &XML;). [Il concetto di azione ha bisogno di essere approfondito -- kt.]

Normalmente, ogni applicazione di &koffice; ha almeno due di questi file &XML;: uno descrive la &GUI; dello struttura (fondamentalmente è quello che vedi quando non c'è nessun documento aperto) ed un altro che descrive la &GUI; della parte usata (questo è quello che vedi normalmente). Per esempio, per &kword; questi due file &XML; sono denominati `kword_shell.rc` e `kword.rc`.

Qui c'è un semplice esempio di questo tipo di file .rc

#### Un esempio di un semplice file .rc

    <!DOCTYPE QConfig ><qconfig>
    <menubar>
    <menu name="Edit"><text>Edit</text>
    <action name="edit_cut"/>
    <action name="edit_copy"/>
    <action name="edit_paste"/>
    <separator/>
    <action name="edit_find"/>
    </menu>
    <menu name="Insert"><text>Insert</text>
    <action name="insert_picture"/>
    <action name="insert_clipart"/>
    <menu name="Variable"><text>Variable</text>
    <action name="insert_var_datefix"/>
    <action name="insert_var_datevar"/>
    </menu>
    </menu>
    </menubar>
    <toolbars>
    <toolbar name="edit_toolbar" position="right">
    <action name="edit_cut"/>
    <action name="edit_copy"/>
    <action name="edit_paste"/>
    </toolbar>
    </toolbars>
    </qconfig>

## Come avere maggiori informazioni

### Altri manuali di &koffice;

Per informazioni dettagliate sulle diverse applicazioni di &koffice;, consulta i loro rispettivi manuali.

### Collegamenti

I seguenti collegamenti dovrebbero esserti d'aiuto se stai cercando maggiori informazioni a proposito di &kde; o di &koffice;.

- La homepage di &koffice;. Qui puoi trovare informazioni su come ottenere ed installare &koffice;, le novità a proposito dello sviluppo di &koffice;, immagini, &etc;

- &kde-http;. Il più avanzato ambiente desktop free per sistemi operativi derivati da unix. &koffice; fa uso delle librerie di &kde;.

- Troll Tech. I creatori delle librerie &Qt;. &kde; e &koffice; fanno uso delle &Qt;.

## Programmare &koffice;

Se vuoi partecipare allo sviluppo di &koffice;, le seguenti risorse possono essere interessanti:

- In http://developer.kde.org troverai molti articoli sulla programmazione con &Qt; e &kde;. Qui puoi trovare la versione in linea e completa della documentazione delle librerie di &kde;.

- Utilizza kdoc (nel modulo CVS `kdoc`) per creare la tua documentazione sulla libreria &kde;.

- Nei sorgenti di &koffice; troverai un'applicazione di esempio nella directory `example`.

## Copyright e Licenza

&koffice; è copyright degli sviluppatori di &koffice;.

Questo manuale è copyright di Jost Schenck. Può essere distribuito liberamente, purché le note relative al copyright siano incluse. Puoi modificarlo purché tu mi invii le modifiche o le renda disponibili sul CVS di &kde;. Non sarò responsabile per qualsiasi cosa risulti dall'uso di questo manuale.

Gli altri manuali di &koffice; sono sotto il copyright dei rispettivi autori.

&underFDL; &underGPL;

## Installazione

### Requisiti del sistema

Per poter installare ed utilizzare &koffice; devi avere:

- Un sistema &UNIX; funzionante (per esempio &Linux; o BSD) con un sistema &X-Window; configurato (per esempio XFree86).

- Le librerie &Qt; 2.1 di Troll Tech. Vedi ftp://ftp.troll.no per maggiori informazioni.

- L'ambiente desktop KDE 2.0 (&kde; 2.0). &koffice; non può essere compilato con versioni precedenti di &kde;. Informazioni su come ottenere ed installare &kde; 2.0 si possono trovare qui: &kde-http;

- I permessi necessari per poter installare software sul tuo computer. Se stai utilizzando un sistema isolato, questo non dovrebbe essere un problema. Se invece stai utilizzando un computer in rete, consulta prima il tuo amministratore di sistema.

Nota che, benchè tu abbia bisogno delle librerie di &kde; 2.0, puoi benissimo utilizzare &koffice; in un ambiente desktop differente (per esempio, assieme a &kde; 1.1, UDE o GNOME).

Se hai in mente di compilare &koffice; dal codice sorgente avrai anche bisogno di:

- `automake` 1.4 o più recente. Questo può essere scaricato da ftp://ftp.gnu.org/pub/gnu/automake

- `autoconf` 2.13 o più recente. Questo può essere scaricato da ftp://ftp.gnu.org/pub/gnu/autoconf

- Un compilatore C++ che supporti le eccezioni (preferibilmente egcs 1.1.x). Questo può essere scaricato da http://egcs.cygnus.com/

- I pacchetti di sviluppo delle &Qt; 2.1 di Troll Tech. Questi possono essere scaricati da ftp://ftp.troll.no/

Una volta che hai riscontrato che il tuo sistema soddisfa queste richieste, devi decidere se desideri compilare il codice sorgente o se installare da pacchetti binari pre-compilati.

Se vuoi ottenere la versione binaria più aggiornata di KOffice, puoi avere maggiori informazioni seguendo questi collegamenti: Ottenere i pacchetti binari.

Se dei pacchetti pre-compilati non sono disponibili per il tuo sistema, puoi scaricare il codice sorgente e compilarlo tu stesso. Le istruzioni a proposito di dove ottenere il codice sorgente (e di che cosa fare con il codice una volta che lo avrai ottenuto) possono essere trovate seguendo questo collegamento: Ottenere il codice sorgente.

Consulta la pagina iniziale di &koffice; per maggiori informazioni. Qui è dove puoi sempre trovare le informazioni più aggiornate sia sulle distribuzioni sorgenti e binarie.

### Ottenere i pacchetti binari

Puoi scaricare i pacchetti binari più recenti da:

http://koffice.kde.org/

oppure da uno dei molti siti mirror. La lista aggiornata dei siti mirror può essere trovata in:

http://www.kde.org/mirrors.html

E' importante che tu utilizzi un pacchetto binario che sia compatibile con il tuo sistema. Se utilizzi il sistema operativo &Linux; e non riesci a trovare un pacchetto binario sul sito internet di &koffice; o su uno dei suoi mirror, puoi provare ad ottenerlo dal sito internet della tua distribuzione.

### Dai pacchetti binari

Per installare &koffice; dai pacchetti binari precompilati, devi:

1. Accertati che il tuo computer possieda tutto il software richiesto installato e funzionante (ad esclusione di &koffice;, chiaramente). Puoi trovare i requisiti del sistema seguendo questo collegamento: Requisiti di sistema.

2. Scarica i binari di &koffice; in una directory temporanea.

3. Se il nome del file termina in `.rpm` (un file &RedHat; Package Management), &koffice; può essere installato con il seguente comando:

       $
       rpm-Unome_del_file

   .

   Se il nome del file termina con `.deb` (un file Debian Package), &koffice; può essere installato con il seguente comando:

       $ dpkg-i
       nome_del_file

   Se il nome del file termina in `.tar.gz` oppure in `.tgz` (un file tarball), &koffice; può essere installato con i seguenti comandi:

       $ cd /
       $ tar -xzvf nome_del_file

4. Questo è tutto. Adesso &koffice; dovrebbe essere installato sul tuo sistema.

Se hai un'interfaccia grafica per la gestione dei pacchetti, come per esempio &kpackage; o GnoRPM installato sul tuo sistema, puoi trovarlo di utilizzo più comodo rispetto alla riga di comando. Consulta la documentazione del programma per trovare come utilizzarlo per installare un pacchetto.

### Ottenere il codice sorgente

Puoi scaricare il codice sorgente più aggiornato da http://koffice.kde.org/ o da uno dei molti siti mirror. L'elenco aggiornato dei siti mirror può essere trovato a:

http://www.kde.org/mirrors.html

### Dal codice sorgente

Se vuoi compilare &kword; dal codice sorgente, devi:

1. Accertati che il tuo computer abbia installati tutti i requisiti software e funzionanti (ad eccezione di &koffice;, naturalmente). Puoi trovare i requisiti di sistema seguendo questo collegamento: Requisiti di sistema.

2. Scarica il codice sorgente di &koffice; in una directory temporanea.

3. Se il nome del file termina con `.src.rpm` (file &RedHat; Package Management), il codice sorgente di &koffice; può essere installato con:

       $ rpm-Unome_del_file

   Se il nome del file termina in `.src.tar.gz` oppure in `.src.tgz` (un file tarball), il codice sorgente di &koffice; può essere installato con:

       $ tar -xzvf nome_del_file

4. Il codice sorgente di &koffice; adesso dovrebbe essere installato nel tuo sistema.

### Problemi con la compilazione

Ancora da scrivere

&documentation.index;