# &koffice;

Un'introduzione generale
Raphael
Langerhorst

    raphael.langerhorst@kdemail.net

Jost
Schenck

    jost@schenck.de

Giovanni
Bacci

     s206756@studenti.ing.unipi.it

Traduzione della documentazione
2005-10-27
1.5.0

&koffice; è una suite integrata per l'ufficio per l'ambiente desktop &kde;.

KDE
KOffice

## Introduzione

### Componenti di &koffice;

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

- &kword; (un programma di videoscrittura)

- &kspread; (un foglio di calcolo)

- &kpresenter; (presentazioni su schermo e lucidi)

- &kivio; (un'applicazione per i diagrammi di flusso)

- Karbon14 (un'applicazione per il disegno vettoriale)

- &krita; (un'applicazione di disegno)

- &kugar; (uno strumento per generare rapporti di qualità professionale)

- Kexi (un ambiente integrato per gestire i dati)

- &kchart; (un programma la generazione di grafici)

- &kformula; (un editor per formule matematiche)

Dato che questi componenti sono basati sul modello KPart, i componenti di &koffice; sono pensati per lavorare molto bene tra di loro. 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 si possono creare dei documenti complessi e articolati usando &koffice;.

Un meccanismo di plugin facilita l'estensione delle funzionalità di &koffice;. In alcuni componenti troverai molti plugin, e puoi imparare a scriverli da te. C'è anche una sezione di questo manuale dedicata allo sviluppo di plugin che ti dovrebbe spiegare le prime cose.

Questo manuale copre solo le funzionalità generali di &koffice;, quelle che sono comuni alla maggior parte o a tutti i componenti della suite. Per informazioni dettagliate a proposito dei vari programmi, fai riferimento al manuale appropriato.

### Panoramica delle funzionalità di &koffice;

#### Integrazione

&koffice; fornisce un'infrastruttura su cui vengono montati tutti i componenti. Attraverso questa infrastruttura si ottiene una elevata integrazione. È possibile sviluppare anche dei propri componenti, a loro volta integrabili. Questa tecnologia viene descritta in maggior profondità nel capitolo su KPart.

#### Leggerezza

Sebbene offra così tanti componenti, &koffice; è molto leggero, veloce e occupa poca memoria. Ciò è possibile anche perché &koffice; si basa su &kde;, che è già un'infrastruttura molto potente per le applicazioni.

Un obiettivo di &koffice; è anche non sovraccaricare l'interfaccia utente con funzionalità raramente necessarie. Il risultato è un'interfaccia utente semplice e immediata, che ti permette di lavorare efficientemente.

La leggerezza può anche voler dire che a volte non troverai una funzionalità molto particolare che ti serve. In questo caso, puoi sempre aggiungere la funzionalità da te estendendo &koffice;. &koffice; non vuole ingigantirsi aggiungendo tantissime funzionalità che solo pochi utenti userebbero. Queste possono sempre essere rese disponibili con plugin o script aggiuntivi, mantenendo &koffice; leggero.

#### Completezza

&koffice; offre un'ampia gamma di componenti, comprensivi della maggior parte delle necessità domestiche e aziendali. Si possono sempre implementare funzionalità aggiuntive con script, plugin o anche interi componenti basati sull'infrastruttura di &koffice;.

#### Formato OpenDocument di OASIS

È di importanza capitale per qualsiasi suite di produttività aderire a degli standard, in particolare al livello del formato dei file per permettere lo scambio di documenti senza problemi con altre suite. Questo impedisce di trovarsi bloccati con un fornitore, che è particolarmente importante per le aziende ma anche per le singole persone.

Per questo motivo &koffice; ha adottato il formato OpenDocument di OASIS come suo formato di file nativo.

#### Funzionalità di &kde;

Siccome &koffice; è costruito su &kde;, tutte le funzionalità che ti aspetteresti da un'applicazione di &kde; sono presenti anche in &koffice;. Ciò include DCOP, KPart, integrazione con il desktop, configurabilità e così via. Tutto ciò rende l'aspetto di &koffice; molto familiare e lo integra nell'ambiente desktop, permettendo di lavorare uniformemente.

## Tecnologia di &koffice;

### KPart - i mattoni di &koffice;

Ogni applicazione di &koffice; è progettata 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 cerca 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 un'altra applicazione, ma nello stesso documento.

Supponiamo che tu stia preparando un documento in &kword; e che tu desideri illustrare qualche punto usando una tabella. Benché &kword; abbia una sua possibilità interna per l'inserimento delle tabelle, potrebbe non essere sufficiente per le tue necessità. Per esempio, potresti voler usare certi formati per la valuta, oppure eseguire dei calcoli con le formule del foglio di calcolo. Bene, alcuni programmatori di &kword; certamente possono provare a 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, e il codice sorgente sarebbe impossibile da mantenere.

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

#### Comporre i documenti con i KPart

Con i KPart, i tuoi documenti possono usare tutte le funzionalità offerte da tutte le applicazioni di &koffice;. Puoi trarre vantaggio da questo inserendo le cosiddette parti nel tuo documento. Ognuna di queste parti è essenzialmente un altro documento, in pratica un documento in 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;. La capacità di inserire le funzionalità di una applicazione in un'altra è detta incorporazione.

#### Usare i KPart nel tuo documento

Se non hai mai lavorato con dei documenti composti, all'inizio potrebbero sembrarti un po' complicati. Le istruzioni seguenti ti mostrano un passo alla volta che usare i KPart è semplice come lavorare con un'applicazione sola.

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

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

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

3. Scegli Inserisci Riquadro per oggetto Foglio elettronico . Noterai che il cursore del mouse si è trasformato in una crocetta. Questa forma del cursore indica che sei invitato a selezionare un'area.

4. Premi il &LMB; dove vuoi che sia l'angolo in alto a sinistra della tua tabella, tienilo premuto e trascinalo fino all'angolo in basso a destra. Rilascia il pulsante. Adesso apparirà una finestra che ti darà la possibilità di inserire un documento esistente o di crearne uno nuovo. Crea un foglio di calcolo vuoto. Ecco fatto, hai finito.

Facile, vero? Adesso dovresti vedere il riquadro di una tabella nel tuo documento &kword;. Adesso fai doppio clic dentro la tabella per vedere che cosa accade. Noterai che:

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

- Il tuo riquadro della tabella adesso contiene gli elementi di una vista di &kspread;, con le barre di scorrimento, una barra delle linguette per la selezione delle tabelle, &etc;

Prova a modificare la tabella. Vedrai che non è diverso da usare &kspread;. In effetti tu stai usando &kspread;.

Adesso fai clic 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.

I KPart sono semplici da usare. Prova a inserire altre parti o anche parti all'interno di parti.

## Configurare &koffice; e 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 fare per avere i risultati migliori con la tua nuova suite per l'ufficio, e adattarla alle tue necessità. &koffice; è molto configurabile, fino ai dettagli delle barre per gli strumenti e lo schema dei menu.

### Ottimizzare la riproduzione dei caratteri

I caratteri sono un argomento difficile in X Windows. In questa sezione parleremo di alcuni problemi che sono riportati di frequente da persone che usano &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 al tuo sistema come amministratore, dovresti parlare del problema con il responsabile del tuo 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. Lì troverai maggiori dettagli.

#### Come ottenere caratteri ben proporzionati sullo schermo

ROBA

#### Come ottenere una stampa corretta

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

Questo problema può essere risolto, anche se non è semplice. Può darsi che tu stia usando 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; indovina e usa per i nomi dei propri caratteri. Questo può essere fatto aggiungendo una riga a un file chiamato `Fontmap`. Una riga con un nome alternativo (alias) in questo file 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; usa per Algerian. Dovrai aggiungere delle linee come queste per i caratteri che &koffice; non visualizza 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 nomi alternativi giusti. Il programma dovrebbe funzionare nella maggior parte dei casi. Come abbiamo 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; (Graphical User Interface, interfaccia grafica per l'utente) che dovrebbe essere adeguata per le esigenze della maggior parte degli utenti, ci sono buone ragioni per cui puoi voler cambiare l'aspetto del programma.

Mia mamma, per esempio, è un po' spaventata dai pulsanti e dalle voci del menu che non capisce. Per adattare &koffice; alle sue necessità, ho ridotto la &GUI; alle sue funzionalità minime. Dato che lei deve solo scrivere lettere e 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 e i menu di &koffice;. Purtroppo al momento non ci sono finestre semplici da usare per farlo. &koffice; salva 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 HTML che è un sottoinsieme di &XML;).

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), e 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`.

Ecco un semplice esempio 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 collegamenti seguenti dovrebbero esserti d'aiuto se stai cercando maggiori informazioni su &kde; o &koffice;.

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

- La pagina Web di KDE. &kde; è l'ambiente desktop più avanzato e assolutamente libero e gratuito per sistemi operativi derivati da unix. &koffice; usa le librerie di &kde;.

- Trolltech. I creatori delle librerie C++ &Qt;. &kde; e &koffice; usano le &Qt;.

## Programmare per &koffice;

### Introduzione

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

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

- Nei sorgenti di &koffice; troverai un'applicazione esemplificativa nella cartella `example`.

## Diritto d'autore e licenza

&koffice; è il risultato degli sforzi comuni di molti sviluppatori. Ogni file sorgente di &koffice; è sotto il copyright delle persone che l'hanno scritto e i loro nomi si possono trovare all'inizio di ogni file sorgente con la licenza che si applica al file sorgente. I nomi degli sviluppatori principali si possono trovare a http://www.koffice.org/people.php.

Questo manuale è copyright di Jost Schenck. Può essere distribuito liberamente, purché le note relative al diritto d'autore siano incluse. Puoi modificarlo purché tu mi invii le modifiche o le depositi sul CVS di &kde;. Non sarò responsabile per conseguenza derivante dell'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 e usare &koffice; devi avere:

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

- Le librerie &Qt; 3.3 di Trolltech. Vedi www.trolltech.com per maggiori informazioni.

- L'ambiente desktop &kde; 3.3 o successivo. &koffice; non può essere compilato con versioni precedenti di &kde;. Le informazioni su come ottenere e installare &kde; si possono trovare qui: &kde-http;

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

Nota che, benché tu abbia bisogno delle librerie di &kde; 3.3 (o successivo), puoi benissimo usare &koffice; in un altro ambiente desktop (per esempio XFCE o GNOME).

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

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

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

- Un compilatore C++ che supporti le eccezioni, preferibilmente una versione recente di GCC. (Vedi http://gcc.gnu.org per informazioni su come ottenerlo e installarlo).

- I pacchetti di sviluppo &Qt; di Trolltech. Se questi pacchetti non sono installati sul tuo sistema, e non sono inclusi nella distribuzione del tuo sistema operativo, probabilmente dovrai compilare &Qt; dal codice sorgente. Questi sorgenti possono essere ottenuti da http://www.trolltech.com/download/index.html.

Una volta che hai verificato che il tuo sistema soddisfa queste richieste, devi decidere se vuoi compilare il codice sorgente o se vuoi installare da pacchetti binari precompilati.

Se vuoi ottenere la versione binaria più aggiornata di &koffice;, puoi avere maggiori informazioni a questo collegamento: Ottenere i pacchetti binari.

Se non sono disponibili pacchetti precompilati per il tuo sistema, puoi scaricare il codice sorgente e compilarlo tu stesso. Si possono trovare le istruzioni su dove ottenere il codice sorgente (e di che cosa farci una volta che lo hai ottenuto) a questo collegamento: Ottenere il codice sorgente.

Vedi la pagina Web di &koffice; per maggiori informazioni. Qui è dove puoi sempre trovare le informazioni più aggiornate sia sulle distribuzioni in sorgente e binarie!

### Ottenere i pacchetti binari

Puoi scaricare i pacchetti binari più recenti da:

http://koffice.kde.org/releases/1.4.0-release.php

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

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

È importante usare un pacchetto binario che sia compatibile con il tuo sistema. Se usi 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 a ottenerlo dal sito internet della tua distribuzione.

### Dai pacchetti binari

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

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

2. Scaricare i file binari di &koffice; in una cartella temporanea.

3. Se il nome del file termina con `.rpm` (file della gestione di pacchetti di &RedHat;), &koffice; può essere installato con il comando seguente:

       $rpm-U nomefile

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

       $ dpkg-i nomefile

   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 nomefile

   In questi esempi nomefile dovrebbe essere sostituito con il nome completo del pacchetto, incluso il percorso completo se non sei nella cartella dove hai salvato il 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, installata sul tuo sistema, puoi trovarti più comodo rispetto alla riga di comando. Consulta la documentazione del programma per capire come usarlo 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 &koffice; dal codice sorgente, devi:

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

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

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

       $ rpm-U nomefile

   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 nomefile

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

&documentation.index;