# &koffice;

## Encore à faire dans ce manuel

Ceci est une liste de chose qui ont encore besoin de travail dans ce manuel.

- Écrire cette liste.

- Et tout le reste.

Si quelqu'un veut aider, faites-le moi savoir à l'adresse ci-dessous. Merci

Jost jost@schenck.de

## Introduction

&koffice; est une suite du bureautique pour l'environnement du bureau K (&kde;). &koffice; est actuellement composé des programmes suivants :

- &kword; (un traitement de textes basé sur des cadres)
- &kspread; (un tableur)
- &kpresenter; (une présentation sur écran en en diaporama)
- &kontour; (a vector drawing application)
- &kformula; (un éditeur de formules mathématiques)
- &kchart; (une application de création de diagrammes/graphiques)
- &kivio;
- &kugar;

Du fait qu'ils sont basés sur les composants KParts, les programmes &koffice; sont conçus pour fonctionner très bien ensemble. Tout composant &koffice; peut être intégré dans un autre document &koffice;. Par exemple, pour pouvez insérer un tableau que vous avez créé avec &kspread; directement dans un document &kword;. De cette manière, les documents composites complexes peuvent être créés en utilisant les programmes &koffice;.

Un mécanisme d'extensions peut facilement augmenter les fonctionnalités de &koffice;. Pour le moment, il y a deux applications, un enregistreur de macros et une calculette qui montrent comment ceci fonctionne.

Ce manuel ne couvre que les caractéristiques générales de &koffice;, celles qui sont communes à la plupart des programmes de la suite. Pour des informations détaillées sur les différents programmes, jetez un coup d'oeil aux autres manuels.

## Premiers pas dans &koffice;

## KParts - les blocs constitutifs de &koffice;

Chaque application &koffice; est conçue pour remplir des besoins spécifiques. Par exemple, &kspread; est un programme pour manipuler des feuilles de calcul, alors que &kword; est un programme de traitement de textes. En cliquant sur une zone spécifique, chaque programme vise à la perfection dans cette zone précise. Cependant, en fonction de ce que vous faites avec &koffice;, vous aurez souvent avantage à utiliser différentes applications dans le même document.

Supposons que vous préparez un document dans &kword; et voulez illustrer certains points en utilisant un tableau. Alors que &kword; fournit ses propres fonctionnalités d'insertion de tableaux, cela peut ne pas suffire à vos besoins. Par exemple, vous pouvez vouloir utiliser certains formats monétaires ou faire des calculs en utilisant un tableur. Maintenant, certains programmeurs de &kword; vont certainement essayer d'implémenter cette fonction. Cependant, &kword; ne sera jamais aussi bon que &kspread; pour cette fonction, et si l'on voulait implémenter tout ce qui vous est utile, cela se terminerait en un code source tellement complexe qu'il serait impossible à maintenir.

L'alternative est KParts. Sa philosophie est simple : laisser chaque application faire ce qu'elle fait le mieux.

### Documents composés avec KParts

Avec KParts, vos documents peuvent utiliser toutes les fonctionnalités offertes par toutes les applications &koffice;. vous bénéficierez de ceci en insérant des composants dans votre document, c'est-à-dire des documents dans un document.

Dans l'exemple mentionné ci-dessus, vous insérerez simplement un composant &kspread; dans votre document &kword;. Puis, lorsque vous éditerez votre tableau, &kspread; prendra le contrôle en arrière-plan. Le contrôle reviendra à &kword; quand vous arrêterez de travailler sur le tableau et reviendrez sur le texte. Le seul changement que vous noterez est que les barres d'outils et les menus, en éditant le tableau, reprennent les fonctionnalités de &kspread; au lieu de &kword;. Cette possibilité d'inclure les fonctionnalités d'une application est nommée intégration.

### Utiliser KParts dans votre document

Si vous n'avez jamais travaillé avec des documents composites, vous pouvez trouver cela troublant au début. Les instructions suivantes pas à pas vous montrent que l'utilisation de KParts est aussi facile que de travailler avec une seule application.

### Insérer un composant &kspread; dans une application &kword;

1. Démarrez &kword;. Vous pouvez le faire à partir soit du tableau de bord, soit en saisissant ``kword`` en ligne de commande.

2. Commencez avec un document vide. Vous pouvez saisir un texte d'essai.

3. Choisissez Cadre d'objet - tableur dans le menu Outils. Vous noterez que le pointeur de la souris se transforme en croix. Cette forme du curseur indique que vous êtes supposé sélectionner une zone.

4. Cliquez sur le &BGS; là où vous voulez le coin supérieur gauche de votre tableau, maintenez le bouton enfoncé et descendez vers le coin en bas à droite. Lâchez le bouton. Voilà, c'est fait.

Facile, n'est-ce pas ? Vous devriez maintenant voir un cadre dans votre document &kword;. Cliquez maintenant dans le tableau pour voir ce qui se passe. Vous noterez que :

- Votre barre de menus et votre barre d'outils ont changé. Elle sont maintenant celles de &kspread;.

- Votre cadre de tableau contient maintenant les éléments d'une vue de &kspread;, avec des ascenseurs, une barre d'onglets pour la sélection des tableaux, &etc;

Essayez d'éditer le tableau. Vous verrez que ce n'est pas différent de l'utilisation de &kspread;. En fait, vous utilisez &kspread;.

Cliquez maintenant quelque part dans votre document &kword;, en dehors du tableau. Les barres de menus et d'outils devraient redevenir celles de &kword;, les éléments propres à &kspread; disparaissant. Votre tableau restera et reflétera toujours les changements que vous y avez faits.

Les composants KParts sont faciles à utiliser

## Optimiser &koffice; et votre système

Alors que &koffice; devrait fonctionner d'emblée, il peut y avoir des choses qui permettent d'en tirer davantage. Ce chapitre vous montre ce vous pouvez vouloir faire pour obtenir les meilleurs résultats de votre nouvelle suite bureautique.

### Optimisation de la sortie des polices

Les polices de caractères sont une difficulté sous X-Window. Dans cette section, nous couvrirons certains problèmes souvent rapportés par les gens qui utilisent &koffice;. Certains problèmes ne sont pas des défauts de &koffice; mais dépendent de la configuration de votre système, ce qui explique qu'il vous faudra peut-être modifier les fichiers de configuration pour les régler. Si vous n'avez pas accès au compte root sur votre système, veuillez demander à votre administrateur et montrez-lui ce manuel. Comme les problèmes des polices sont trop complexes pour être tous traités ici, vous devrez peut-être consulter le Font HOWTO dans lequel j'ai extrait les informations suivantes. Vous y trouverez plus de détails.

#### Comment obtenir de belles polices zoomables à l'écran

DIVERS

#### Comment obtenir de bonnes impressions

Alors que &koffice; peut gérer automatiquement toutes les polices X11 à l'écran, la sortie imprimante peut poser des problèmes : sur la plupart des systèmes, l'impression se fait par ghostscript. Comme &koffice; connaît les noms des polices utilisées par X-Window, il ne connaît normalement pas les noms des polices utilisés par ghostscript. &koffice; essaye de deviner ces noms, ce qui, malheureusement, ne fonctionne pas à tous les coups.

Ce problème peut être réglé, quoique ce ne soit pas très facile. Peut-être utilisez-vous une distribution qui a fait le plus gros du travail pour vous (vous n'avez alors aucune raison de vous plaindre, et vous pouvez sauter cette section). Ce que vous devez faire est dire à ghostscript comment traduire les noms (devinés) des polices. Ceci peut être fait en ajoutant des lignes au fichier nommé `Fontmap`. Une ligne d'alias dans `Fontmap`. ressemble à l'exemple suivant :

##### Une ligne d'alias dans le Fontmap de ghostscript

    /Algerian-Roman /Algerian       ;

Veuillez noter qu'une espace avant le point-virgule est obligatoire. Dans cet exemple, Algerian-Roman est le nom que &koffice; utilise pour Algerian. Vous devrez ajouter de telles lignes pour les polices de &koffice; qui ne s'affichent pas correctement. Pour faciliter ceci, Donovan Rebbechi a écrit un script Perl que vous pouvez trouver à http://pegasus.rutgers.edu/~elflord/font_howto/kwdfont. En supposant que vous avez un fichier de polices `/usr/share/ghostscript/fonts/fontfile.ttf`, vouez saisirez ``kwdfont` `/usr/share/ghostscript/fonts/fontfile.ttf`` pour obtenir les alias appropriés. Le script devrait fonctionner dans la plupart des cas. Comme mentionné, vous devriez jeter un coup d'oeil à Font HOWTO pour des informations plus détaillées.

### Personnaliser le &GUI; de &koffice;

tien que &koffice; sorte de la boîte avec un &GUI; (interface utilisateur), qui devrait combler les besoins de la plupart des utilisateurs, il y a de bonnes raisons pour changer l'apparence du programme.

Ma mère, par exemple, a un peu peur des boutons et des entrées de menus qu'elle ne comprend pas. Pour adapter &koffice; à ses besoins, j'ai réduit le &GUI; à des fonctionnalités minimales. Comme elle n'a besoin que d'écrire des lettres et d'utiliser certains modèles, elle n'a pas besoin de fonctions comme enregistrer, ouvrir, imprimer, &etc;

Grâce au concept d'action de &Qt; et &kde;, vous pouvez librement personnaliser les barres d'outils et de menus de &koffice;. Malheureusement, pour le moment, il n'y a pas de dialogue facile à utiliser pour faire ceci. &koffice; stocke sa configuration de &GUI; dans des fichiers &XML; et vous devrez les éditer à la main. Par chance, cette situation changera dans l'avenir ; pour le moment, vous devrez avoir quelques connaissances de base sur le fonctionnement des documents &XML; (ou HTML, qui est un sous-ensemble de &XML;).

Normalement, chaque application &koffice; a au moins deux de ces fichiers &XML; : l'un qui décrit le &GUI; de l'atelier (en gros, ce que vous voyez lorsqu'il n'y a pas de document ouvert) et un qui décrit le &GUI; des différents composants (ce que vous voyez normalement). Par exemple, pour &kword;, ces deux fichiers se nomment `kword_shell.rc` et `kword.rc`.

Voici un exemple simple d'un tel fichier rc.

#### Exemple de fichier rc simple

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

## Comment obtenir plus d'informations

### Autres manuels de &koffice;

Pour des informations détaillées sur les différentes applications de &koffice;, veuillez consulter leurs manuels respectifs.

### Liens

Les liens suivants devraient être utiles si vous cherchez d'autres informations sur &kde; et &koffice;.

- La page de &koffice;. Ici, vous pouvez trouver des informations sur la manière d'installer &koffice;, des actualités sur &koffice;, le développement, les captures d'écran, &etc;

- &kde-http;. L'environnement de bureau le plus avancé et absolument libre pour les systèmes d'exploitation de type Unix. &koffice; fait usage des bibliothèques &kde;.

- Troll Tech. Les créateurs de la boîte à outils C++ &Qt;. &kde; et &koffice; font usage de &Qt;.

## Programmer &koffice;

Si vous voulez faire du développement &koffice;, les ressources suivantes peuvent avoir de l'intérêt.

- Sur http://developer.kde.org, vous trouverez beaucoup de documents sur la programmation en &Qt; et &kde;. Ici, vous trouverez la version en ligne de la documentation complète de la bibliothèque &kde;.

- Utilisez kdoc (dans le module CVS `kdoc`) pour générer votre propre documentation de bibliothèque &kde;.

- Dans les sources de &koffice;, vous trouverez une application exemple dans le dossier `example`.

## Copyright et Licence

&koffice; est protégé par copyright par l'équipe de &koffice;.

Ce manuel est copyright Jost Schenck. Il peut être distribué librement tant que cette notice de copyright y est incluse. Vous pouvez la changer tant que vous m'envoyez les changements ou les incorporez au CVS de &kde;. Je ne suis responsable de rien de ce qui peut se produire en conséquence de l'utilisation de ce manuel.

Les autres manuels de &koffice; sont copyright leurs auteurs respectifs.

&underFDL; &underGPL;

## Installation

### Prérequis

Pour installer &koffice;, vous devez avoir :

- Un système &UNIX; en état de marche (par exemple, Linux ou BSD), avec un système &X-Window; configuré (par exemple XFree86).

- La bibliothèque &Qt; 2.1 de Troll Tech. voir ftp://ftp.troll.no/ pour plus d'informations.

- L'environnement de bureau K 2.0 (&kde; 2.0). &koffice; ne peut pas être compilé avec des versions plus anciennes de &kde;. Des informations sur l'obtention et l'installation de KDE se trouvent sur &kde-http;.

- La permission d'installer des logiciels sur votre ordinateur. Si vous êtes sur un système isolé, ceci ne devrait pas être un problème. Cependant, si vous utilisez un ordinateur en réseau, voyez d'abord ceci avec votre administrateur.

Veuillez noter que, alors que vous avez besoin des bibliothèques &kde; 2.0 sur votre système, vous pouvez toujours utiliser &koffice; dans un environnement de bureau différent (par exemple &kde; 1.1, UDE, ou GNOME).

Si vous comptez compiler &koffice; à partir du code source, vous aurez aussi besoin de :

- `automake` 1.4 ou plus. Il peut être téléchargé de : ftp://ftp.gnu.org/pub/gnu/automake/

- `autoconf` 2.13 ou ultérieur. Il peut être téléchargé de : ftp://ftp.gnu.org/pub/gnu/autoconf/

- Un compilateur C++ qui supporte les exceptions (de préférence egcs 1.1.x). Il peut être téléchargé sur http://egcs.cygnus.com/

- Les paquetages de développement &Qt; 2.1 de Troll Tech. Ils peuvent être téléchargés de ftp://ftp.troll.no/

Une fois que vous avez déterminé que votre système comporte ces éléments, vous devriez décider si vous voulez compiler le code source ou installer des paquetages binaires précompilés.

Si vous voulez obtenir la version exécutable la plus récente de KOffice, vous pouvez trouver plus d'informations en suivant ce lien : Obtenir des paquetages binaires.

Si les binaires précompilés ne sont pas disponibles pour votre système, vous pouvez télécharger le code source et le compiler vous-même. Des instructions sur l'endroit où obtenir le coude source actuel (et quoi en faire une fois que vous l'aurez) se trouvent en suivant ce lien : Obtenir le code source.

Veuillez voir la site web de &koffice; pour des détails plus complets. C'est l'endroit où vous pouvez toujours trouver les informations les plus à jour à la fois sur les binaires et le source.

### Obtenir les paquetages binaires

Vous pouvez obtenir les paquetages binaires sur :

http://koffice.kde.org/

ou un des sites miroirs. La liste actuelle des sites miroirs se trouve à :

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

Il est important que vous utilisez un paquetage binaire compatible avec votre système. Si vous utilisez le système &Linux; et ne pouvez pas trouver les paquetages binaires sur le site web de &koffice; ou un des miroirs, vous pourrez l'obtenir sur le site web de votre distribution.

### À partir des paquetages binaires

Pour installer &koffice; à partir des binaires précompilés, vous devrez :

1. Assurez-vous que votre ordinateur a tous les logiciels nécessaires et en état de marche (sauf &koffice;, bien sûr). Vous pouvez trouver les conditions nécessaires en suivant ce lien : Prérequis.

2. Téléchargez les binaires de &koffice; dans un dossier temporaire.

3. Si le nom du fichier se termine par `.rpm` (fichier du système de gestion de paquetages de &RedHat;), &koffice; peut être installé grâce à la commande suivante :

       $
       rpm-Unomdufichier

   .

   Si le nom du fichier se termine par `.deb` (fichier de paquetage Debian), &koffice; peut être installé grâce à la commande suivante :

       $ dpkg-i
       nomdufichier

   Si le nom du fichier se termine par `.tar.gz` ou `.tgz` (un fichier archive), &koffice; peut être installé grâce aux commandes suivantes :

       $ cd /
       $ tar -xzvf nomdufichier

4. C'est tout. &koffice; devrait maintenant être installé sur votre système.

Si vous avez une interface graphique pour la gestion des paquetages, comme &kpackage; ou GnoRPM sur votre système, vous pouvez la trouver plus commode que la ligne de commandes. Consultez la documentation de ce programme pour apprendre comment l'utiliser pour les installations.

### Obtenir le code source

Vous pouvez télécharger le code source actuel de : http://koffice.kde.org/ ou depuis l'un de ses nombreux miroirs. La liste des sites miroir peut être trouvée à l'adresse :

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

### À partir du code source

Si vous voulez construire &kword; à partir du code source, vous devrez :

1. Assurez-vous que votre ordinateur a tous les logiciels nécessaires installés et en état de marche (sauf &koffice;, bien sûr). Vous pouvez trouver la configuration nécessaire en suivant ce lien : Prérequis.

2. Téléchargez les binaires de &koffice; dans un dossier temporaire.

3. Si le nom du fichier se termine par `.src.rpm` (fichier du système de gestion de paquetages de &RedHat;), le code source de &koffice; peut être installé grâce à :

       $ rpm-Unomdufichier

   Si le nom du fichier se termine par `.src.tar.gz` ou `.src.tgz` (un fichier archive), le source code de &koffice; peut être installé grâce à :

       $ tar -xzvf nomdufichier

4. Le code source de &koffice; devrait maintenant être installé sur votre système.

### Problèmes avec la compilation

À écrire

&documentation.index;