# Manuel de &kformula;

## Introduction

&kformula; sert à écrire des formules. Il n'évalue rien. Tout ce qu'il fait est de les afficher.

&kformula; a été conçu pour votre plaisir d'éditer. Il rend agréables la saisie des lettres grecques, des fractions et toutes ces choses qui font qu'une formule ressemble à une formule.

Mais la plupart du temps, vous n'utiliserez pas &kformula; lui-même. Vous choisirez plutôt de l'utiliser à l'intérieur de &kword; ou de toute autre application &koffice;. C'est-à-dire que &kformula; n'est pas une application utile en elle-même, mais une extension de toutes les autres applications &koffice; dont vous serez tombé amoureux.

Partout où &kformula; apparaît, elle se comporte de la même façon.

## Notions de base

Un nouveau document &kformula; (vide) ressemble à un petit carré bleu. Ce carré concrétise l'idée centrale de &kformula;. Il représente une liste vide. L'idée derrière &kformula; est d'avoir différents éléments arrangés en listes. Un élément dans ce contexte peut être une lettre, un symbole de racine, ou n'importe quoi d'autre dans le même genre. Les listes sont combinées de manière à former une formule. C'est-à-dire qu'il y a des listes pour les indices, les limites inférieures et supérieures, et ainsi de suite. Bien entendu il y a la liste principale. C'est celle dont nous venons d'avoir un aperçu.

L'écriture d'une formule consiste à remplir la liste vide de lettres, de chiffres et de symboles mathématiques. C'est facile : utilisez votre clavier. Dès que vous tapez quelque chose, le symbole vide disparaîtra au profit de ce que vous venez d'ajouter. Les nouveaux caractères sont toujours placés à la position courante du curseur.

Il y a une barre d'outils intitulée Ajouter qui vous permet de créer des éléments plus complexes. Il y a des indices, des fractions, des radicaux et des matrices, pour n'en citer que quelques-uns. Tous ces éléments consistent en au moins une liste dans laquelle vous pouvez placer le curseur pour insérer de nouveaux éléments.

## Utilisation de &kformula;

Au-dessous se trouve une entrée de formule typique de &kformula;. Pour saisir les dérivées partielles et les lettres grecques, cliquez sur le symbole de boîte déroulante, sur la droite et sélectionnez le symbole adapté. Le symbole de boîte combo, dans la figure ci-dessous, porte le mot Cap. Cliquez sur le symbole de touche Retour à droite pour valider un symbole.

Capture d'écran de &kformula; Capture d'écran de &kformula;

La formule de Green ci-dessus peut être imprimée dans un fichier &PostScript;. Pour faire ceci, choisissez Fichier Imprimer... et configurez l'impression comme montré ci-dessous :

Voici une capture d'écran de la formule Green dans &kformula; Voici une capture d'écran de la formule Green dans &kformula;

Voici à quoi le fichier &PostScript; résultant doit ressembler :

Voici la sortie &PostScript; de &kformula;

Voyez la section Polices mathématiques pour les détails d'installation des polices. Vous devez installer les polices esstix pour obtenir ces résultats

### Autres fonctionnalités de &kformula;

Plus sur les formules

Pour écrire des matrices, cliquez sur le [ ] puis cliquez sur le symbole de matrice . Vous pouvez vous déplacer d'élément de matrice en élément de matrice en utilisant les touches fléchées Droite, Gauche, Haut et Bas. Un exemple de matrice est affiché ci-dessous.

Voici le résultat d'une matrice ;

## Référence des commandes

### La fenêtre principale de &kformula;

#### Le menu Fichier

&Ctrl;N Fichier Nouveau

- Crée un nouveau document de formule

&Ctrl;O Fichier Ouvrir

- Ouvre un document précédemment enregistré

Fichier Récemment ouverts

- affiche une sélection des documents récemment enregistrés que vous pouvez ouvrir

&Ctrl;S Fichier Enregistrer

- Enregistre le document

Fichier Enregistrer sous...

- Enregistre le document avec un nom que vous donnez

&Ctrl;P Fichier Imprimer

- Imprime le document

Fichier Aperçu avant impression...

- Affiche comment le document imprimé apparaîtra

Fichier Informations sur le document...

- Fournit une boîte de dialogue où vous pouvez saisir votre nom, adresse électronique et une courte description du document

Fichier Envoyer un fichier...

- Appelle KMail, de telle manière que vous pouvez envoyer le fichier en tant que courrier électronique. Note : vous devez quand même attacher le fichier au courrier électronique

&Ctrl;W Fichier Fermer

- Ferme le document courant

&Ctrl;Q Fichier Quitter

- Quitte &kformula;

#### Le menu Édition

&Ctrl;Z Édition Annuler

- Annule une action. Vous pouvez revenir à l'état qui existait avant votre dernier changement

&Ctrl; &Maj; Z Édition Refaire

- Annule une annulation. Le contraire de l'action d'annulation. Ceci ramènera le changement que vous aviez fait initialement.

&Ctrl;X Édition Couper

- Coupe une pièce surlignée de texte de l'écran de &kformula;.

&Ctrl;C Édition Couper

- Copies un texte surligné de texte de l'écran de &kformula;.

&Ctrl;V Édition Coller

- Colle le texte que vous avez sélectionné avec Couper ou Copier vers l'écran de &kformula;.

&Ctrl;A Édition Sélectionner tout

- Surligne tout le texte dans l'écran de &kformula; pour soit le couper, soit le copier.

&Ctrl;R Édition Supprimer l'élément d'encadrement

- Supprime les parenthèses, crochets ou barres de valeur absolue. Cette action s'applique aux éléments d'encadrement juste autour du curseur.

&Ctrl;G Édition Convertir en grec

- Convertit un caractère Latin en symbole Grec.

Édition Modifier la chaîne de formule

- Ouvre un éditeur où vous pouvez modifier une formule existante.

Voyez la section Édition avancée pour les détails.

#### Le menu Élément

&Ctrl;2 Élément Ajouter... Ajouter une racine

- Insère une racine carrée.

&Ctrl;3 Élément Ajouter... Ajouter une fraction

- Insère une fraction.

Élément Ajouter... Ajouter une parenthèse

- Insère une paire de parenthèses, &cad; ( ). Vous pouvez aussi simplement écrire ( pour insérer une paire de parenthèses.

&Ctrl;3 Élément Ajouter... Ajouter une fraction

- Insère une fraction.

&Ctrl;6 Élément Ajouter... Ajouter une intégrale

- Insère le signe intégrale

&Ctrl;7 Élément Ajouter... Ajouter une somme

- Insère un signe de somme (sigma).

&Ctrl;4 Élément Ajouter... Ajouter un produit

- Insère le signe produit.

&Ctrl;8 Élément Ajouter... Ajouter une matrice

- Insère une matrice. Une boîte de dialogue surgit, avec la taille par défaut de 3x3. Vous pouvez spécifier le nombre de lignes et de colonnes dans cette boîte.

Élément Ajouter... Ajouter une matrice1x2

- Insère un vecteur avec une colonne et deux lignes.

&Ctrl;U Élément Ajouter... Ajouter un exposant

- Ajoute un exposant comme ceci :

&Ctrl;L Élément Ajouter... Ajouter un indice

- Ajoute un indice :

  Voyez la section Index et Intégrales définies pour les détails sur les index.

Élément Ajouter... Ajouter une espace mince

- Insère une petite espace.

Élément Ajouter... Ajouter une espace moyenne

- Insère une espace une fois et demie plus large.

Élément Ajouter... Ajouter une espace large

- Insère une espace double.

Élément Ajouter... Ajouter une espace quadruple

- Insère une espace de largeur quadruple.

Élément Matrice Insérer une colonne

- Insère une colonne dans une matrice existante. La colonne est insérée là où le curseur se trouve.

Élément Matrice Ajouter une colonne

- Ajoute une colonne à une matrice existante. La colonne est ajoutée à droite.

Élément Matrice Supprimer une colonne

- Supprime une colonne dans une matrice existante. La suppression survient là où le curseur est positionné.

Élément Matrice Insérer une ligne

- Insère une ligne dans une matrice existante. La ligne est insérée là où le curseur se trouve.

Élément Matrice Ajouter une ligne

- Insère une ligne dans une matrice existante. La ligne est insérée en bas.

Élément Matrice Supprimer une ligne

- Supprime une ligne dans une matrice existante. La suppression survient là où le curseur est positionné.

Élément Délimiteur gauche

- Permet l'insertion de délimiteurs variés, &cad; (, { et [.

Élément Délimiteur droit

- Permet l'insertion de délimiteurs variés, &cad; ), } et ].

&Ctrl;I Élément Insérer un symbole

- Insère le symbole, sélectionné dans la barre d'outils de symboles.

#### Le menu Configuration

Ici, vous pouvez choisir comment &kformula; est configuré. Vous pouvez sélectionner les barres d'outils que vous voulez afficher ou le type de polices à utiliser.

Configuration Surlignement selon la syntaxe

- En cochant ces éléments, vous déterminez si les nombres seront affichés en couleur

Configuration Afficher la barre d'outils de fichiers

- Affiche/Cache la barre d'outils qui contient les icônes cliquables pour fichier nouveau, ouvrir et enregistrer. Imprimer et aperçu avant impression sont aussi ici.

Configuration Afficher la barre d'outils d'édition

- Affiche/Cache la barre d'outils d'édition. Ici se trouvent les icônes pour couper, et coller, comme Annuler et Refaire.

Configuration Afficher la barre d'outils Ajouter

- Cette barre d'outils contient tous les éléments mathématiques comme la somme les intégrales, les exponentielles, &etc;

Configuration Afficher la barre d'outils de symboles

- Ceci bascule la boîte déroulante qui contient Delta, le symbole de dérivée partielle, les flèches de limites, les opérateurs booléens et d'autres symboles mathématiques.

Configuration Afficher la barre d'outils de matrice

- Ceci affiche/Cache la barre d'outils de matrice. Elle contient les icônes cliquables qui permettent la création et l'édition de matrices.

#### Configurer les raccourcis

Le Configuration Configurer les raccourcis-clavier... vous permet de spécifier les associations de touches

Ci-dessous se trouve un exemple de la manière de configurer un raccourci pour faire une espace large.

Image du dialogue de raccourci

- Cliquez sur le bouton personnalisé.

- Cliquez ensuite sur le bouton Primaire.

- Faites `CTRLEspace` et le dialogue doit apparaître. Le raccourci-clavier est maintenant saisi.

Image du dialogue de raccourci-clavier

En actionnant les touches `CTRL Espace`, on obtient maintenant une espace large.

#### Configurer les barres d'outils

Le Configuration Configurer les barres d'outils... sert à ajouter des boutons aux barres d'outils.

Image du dialogue des barres d'outils

- Pour ajouter un bouton à la barre d'outils de fichiers,

  Image du dialogue des barres d'outils

  assurez-vous que Fichier <KOfficeShell> est affiché dans la boîte déroulante du haut.

- Cliquez sur un des éléments dans le panneau de gauche. Cet élément aura maintenant un fond bleu montrant qu'il a été sélectionné.

- Puis cliquez sur le bouton Flèche droite pour le mettre dans le panneau de droite.

- Cliquez sur `Appliquer` puis cliquez sur `OK`

Le nouvel élément devrait être dans la barre d'outils.

#### Configuration de &kformula;

C'est dans Configuration Configurer &kformula;... que vous pouvez choisir les tailles des polices et installer des polices additionnelles.

- La section Formule vous permet de sélectionner les polices et les couleurs de surlignement.

- La section Polices vous permet d'installer d'autres polices. voyez la section Polices mathématiques supplémentaires.

#### Le menu Aide

&help.menu.documentation;

## Techniques d'édition pour utilisateurs confirmés

### Insertion de nom

Une fonctionnalité à part est l'insertion de nom. Le carré bleu dans lequel vous avez écrit est en fait une liste. De plus, cette liste peut contenir d'autres listes. Quand vous saisissez une barre oblique inverse (`\`), vous obtenez de suite une nouvelle liste vide, qui se différencie des autres, car elle utilise une police de caractères différente et sert à saisir des éléments tels que des noms de fonctions. Il y a en outre une idée cachée derrière l'insertion de nom. Votre clavier n'offre qu'un jeu de caractères limité en comparaison de la quantité impressionnante de symboles mathématiques. Pour les obtenir, il suffit de saisir leur nom et d'appuyer ensuite sur la barre d'espace. Le nom que vous venez de saisir sera alors remplacé par son symbole. Dans ce contexte, la touche Espace signifie sors d'ici, c'est-à-dire à placer le curseur dans la liste contenante. Le curseur sera positionné à la fin de ce que vous avez écrit, mais sera aussi entouré de la formule originale après avoir actionné la barre d'espacement.

Une autre chose que vous pourriez vouloir insérer est des espaces. Nous savons tous que l'impression de formules dépend énormément des bons espacements. Et vous pouvez faire exactement ce que vous voulez en utilisant une liste de noms.

Dans le carré bleu, faites :`\,Espace` pour obtenir une petite espace.

Faites :`\<Espace` pour obtenir une espace moyenne.

Faites :`\;Espace` pour obtenir une espace large.

Faites :`\quad(NDT???)Espace` pour obtenir une espace large quadruple.

De la même manière, les symboles mathématiques spécifiques peuvent être insérés. `\ point Espace` insère le chemin intégral concernant un contour fermé. Au-dessous se trouve le résultat de `\ point Espace`

Image du chemin intégral

### Édition de formules

Le menu Édition Modifier la chaîne de formule... permet à l'utilisateur de modifier les formules ASCII qui ont été copiées depuis d'autres applications comme Scilab, et de les transformer directement en type mathématique. Un exemple rendra ceci plus clair. Ci-dessous se trouve une capture d'écran de Scilab de l'`INRIA`

Image de Scilab

Copier et coller le texte commençant par `x*sin(30*x)` dans l'éditeur de formules comme montré ci-dessous :

Image de l'éditeur de formules Scilab

Si vous cliquez sur OK, l'éditeur se plaindra d'une analyse avortée. Il ne peut pas reconnaître un des symboles de la formule. La formule affichée montre que le symbole Pi n'est pas correctement rendu. Ceci signifie que le `%` doit être supprimé. Faites cela et &kformula; affichera la police mathématique correctement, comme montré ci-dessous.

Rendu de formule Scilab dans &kformula;

L'éditeur de formules acceptera la plupart des expressions mathématiques du langage C, comme les formules d'un programme Runge-Kutta ci-dessous :

    void derivs(float x, float y[], float dydx[])
    {
     dydx[1] = y[2];
     dydx[2] = -0.8*x*y[2] - sin(x)*y[1];
    }

Ici, `dydx[1]` est la dérivée de premier ordre et `dydx[2]` est la dérivée de deuxième ordre. Après avoir copié la formule, vous devrez la modifier avec &kformula;. Voici comment ceci se fait. Copiez d'abord et collez l'expression du bas dans l'éditeur de formules.

Runge-Kutta dans l'éditeur ;

Puis, enlevez les `[ ]`, ne laissant que les y.

Runge-Kutta modifiée

Maintenant, cliquez sur OK et placez le curseur par un `y` et supprimez-le. Insérez les symboles appropriés comme montré ci-dessous.

Runge-Kutta dans &kformula;

Les expressions que &kformula; est capables de gérer ne peuvent pas toutes être traduites en C valable. Par exemple, l'expression exposant :

Exposant dans &kformula;

est affichée comme `()**()`, ce qui n'est pas une déclaration C valable pour les exposants. De même, les matrices 1 sur 2 s'affichent comme `()/()`. Ceci n'est pas un tableau C valable.

### Intégrales définies et les index

#### Intégrales définies

Une intégrale définie est faite en utilisant &Ctrl;U pour la limite supérieure d'intégration et &Ctrl;L pour la limite basse de l'intégration.

Intégrale définie

Repositionnez le curseur devant l'intégrale après avoir donné la première limite.

#### Positionnement des index

Les exposants ou les index peuvent être positionnés en surlignant le texte désiré. Dans cet exemple, une flèche est nécessaire au-dessus du P, dans dP. En utilisant &Ctrl;U, le symbole de vecteur désiré se place à la mauvaise place, c'est-à-dire au-dessus du d.

Le problème se règle en ne surlignant que le P dans puis en effectuant &Ctrl;U. Voici le résultat correct.

## Polices mathématiques

Pour imprimer des fichiers PostScript de &kformula;, vous avez besoin des polices esstix. Ces polices peuvent être obtenues sur ftp://ftp.elsevier.nl/pub/styles/esstix/esstix.zip

### Installation des polices avec le ¢reConfiguration;

Après avoir téléchargé les polices, installez-les dans un dossier nommé `esstix`. Vous pouvez les décompacter avec l'application &ark; de &kde;. Cliquez du bouton droit sur `esstix.zip` et sélectionnez Extraire ici.... Puis, démarrez l'installateur de polices de &kde; en allant dans le menu K et en sélectionnant la commande Centre de configuration Système Installateur de polices. Vous devriez obtenir l'écran suivant :

Image de l'installateur de polices de &kde; Image de l'installateur de polices de &kde;

Vous devrez être `root` pour lancer l'installateur de polices. Cliquez sur le bouton Mode administrateur et saisissez votre mot de passe `root`. Cliquez sur le bouton Changer de dossier. Ceci devrait amener un panneau où vous pouvez sélectionner le dossier où vos polices sont situées. Dans cet exemple, elles sont stockées dans `/home/poincare/esstix`.

Image de l'installateur de polices de &kde; Image de l'installateur de polices de &kde;

Cliquez sur le dossier `esstix` puis cliquez sur le bouton OK. Vous devriez obtenir le résultat suivant.

Image de l'installateur de polices prêt à installer Image de l'installateur de polices prêt à installer

Cliquez sur l'entrée du haut. En maintenant enfoncée la touche &Maj;, cliquez sur la dernière police esstix en bas. Votre sélection devrait ressembler à ça.

Image de l'installateur de polices installant Image de l'installateur de polices installant

Vous devriez utiliser les fichiers natifs AFM. Configurez votre Configuration Système comme montré ci-dessous. La case Générer les AFM avec devrait être décochée.

Image de l'onglet de configuration Image de l'onglet de configuration

Retournez à l'onglet Polices. Cliquez sur le bouton Installer. Les polices s'installeront. Après ceci, vous devez cliquer sur le bouton Appliquer. L'écran d'accueil suivant apparaîtra :

Image du ¢reConfiguration; appliquant les polices Image du ¢reConfiguration; appliquant les polices

Répondez Oui à la boîte de dialogue Appliquer les changements du système maintenant. Vous avez terminé d'installer les polices esstix.

### Polices mathématiques additionnelles

Les polices mathématiques additionnelles peuvent être installées par Configuration Configurer Kformula... Polices mathématiques

Ajout de polices mathématiques

D'abord, installez les polices désirées avec l'installateur de polices dans le ¢reConfiguration;. Ceci les rendra disponibles pour votre ordinateur. Puis entrez dans la section Polices mathématiques et ajoutez-les en utilisant la Flèche droite, comme montré ci-dessus. Les polices Symbole Euclid, qui ont été ajoutées ci-dessus, sont maintenant disponibles dans la boîte combo Insérer un symbole.

## Remerciements et licence

&kformula; copyright Ulrich Küttler

Co-developpeur : Andrea Rizzi

Documentation copyright 2002 Jonathan Drews j.e.drews@att.net

&underFDL; &underGPL;

## Installation

### Comment obtenir &kformula;

&install.intro.documentation;

### Configuration nécessaire

&kformula; fait partie de &koffice; sur La page de &kformula;. Vous devez avoir &koffice;installé. &kformula; ne fonctionner pas sans le reste de &koffice;

### Compilation et installation

&install.compile.documentation;

### Configuration

Certaines polices ne fonctionneront pas avec &kformula;. Vous devrez en essayer plusieurs pour obtenir un rendu satisfaisant.

&documentation.index;