dimanche 16 novembre 2008

Créez vos document scientifiques avec kile

Introduction

Nous sommes tous amené à écrire des documents qui peuvent être de simple lettres à des des rapports très long. Certains facteurs, comme la numérotation de pages, les références croisés, les citations, peuvent rendre la tâche de rédaction très difficile.

La qualité du document peut aussi avoir une importance crutiale dans certaines situations, à savoir, dans les papiers scientifique et plus précisément, dans les documents mathématiques. Heureusement, nous disposons aujourd'hui d'un grand nombre d'outils qui permettent l'éditions facile et efficace de documents dont Microsoft word et openoffice.org (writer).


Cependant, Latex reste l'outil incontournable à l'écriture de documents scientifiques, et ce, vu la qualité exceptionnelle des documents qu'il génère. D'ailleurs, certaines conférences trés sérieuses imposent aux scientifique de soumettre des documents écris en latex.


Pendant longtemps, l'édition de fichiers latex se faisait avec les éditeur emacs et vi. Aujourd'hui, et avec le développement des projets KDE et GNOME, d'autres alternatives comme Kile et texmaker ont été développé et offrent des interfaces graphiques très sophistiqués. Ces outils sont un argument de plus pour migrer vers latex.


Cet article est dédié à la présentation de l'outil kile et est organisé comme suit: Dans le premier paragraphe, nous présentons brièvement l'outil Latex et les commandes qui permettent de générer le fichier résultat en format PDF ou PS. Nous détaillons ensuite la procédure d'installation de kile. Enfin, nous présentons les différentes fonctionnalités qu'offre cet outil.



Avantages et inconvénient de latex


Contrairement aux outils qui adoptent l'approche WYSIWYG (comme microsoft word et oOo writer), Latex adopte une approche qui se concentre sur le fond et non pas sur la forme. Partant du principe qu'un document doit d'abord être être lu et non pas être vu comme un pièce d'art, latex se concentre sur la structure des documents. Les discussions entre les partisants des deux approches risque par moment d'être chaudes. Sans essayer de faire un comparatif entre ces outils, nous allons présenter les principaux avantages de Latex:


  • Latex est disponible gratuitement sur la plupart des plate-formes

  • Les document produits par Latex sont reconnus et utilisables et peuvent être imprimés sur la plupart des plate-formes sans perte de qualité ni de mise en page

  • Latex génère des documents de très bonne qualité typographique, et ce , puisqu'il utilise TEX comme outil de mise en page

  • Les formules mathématiques sont édités et produites d'une façon professionnelle. C'est l'un des principaux avantages de l'utilisation de Latex puisqu'il permet d'inclure et d'afficher facilement les formules mathématique (parfois, très complexes). Cette fonctionnalité est particulièrement utilisée aux chercheurs et aux ingénieurs (etc ...) qui ont besoin de produires des document avec beaucoups de mathématiques

  • La mise en page des documents est généré automatiquement par Latex. L'utilisateur doit se concentrer uniquement sur la structure et le contenu du docuement

    Les structures complexes comme les references, les notes de fin de page, la table de matière, la bibliographie sont gérée automatiquement

Evidemment, Latex possède quelques limites dont je cite:

  • Difficulté d'approntissage pour les gens habitués par les applications WYSIWYG

  • La personnalisation des documents est encore une tâche assez dificille malgrès la présence d'un tres grand de classes

  • Je rejoint les auteurs du tutorial apprendre latex en 88 minutes pour affirmer qu'avec latex, il est très dificile d'écrire un document mal organisé

Principe de fonctionnement


La figure 1 résume le principe de fonctionnement de latex.

L'utilisateur doit commencer par éditer sont texte source (disons source.tex) par son éditeur préféré. Il peut éventuellement, inclure des figures et des graphiques. L'utilisateur doit ensuite compiler sont fichier à l'aide de la commande

latex source.tex


L'outil latex va alors générer le fichier résultat source.dvi qui peut être par la suite imprimé, ou affiché sur l'ecran. Le plus souvent, ce fichier va être tranformé en un fichier de format PDF ou PS avec les commandes dvi2pdf et dvi2ps.


Il est interressant de savoir que même si votre fichier source contient des erreurs (qui ne sont pas critiques), latex va générer le document cible. Ceci peut aider à déboguer le fichier source en detectant visuellement où se trouve l'erreur.











Présentation de kile


Latex est un logiciel de traitement de fichier de code source latex. Il offre à l'utilisateur une interface graphique qui lui permettra facilement d'insérer les balises latex. Bien que latex peut être vu comme un éditeur de texte, il ne faut pas surtout pas la prendre comme un équivalent à Word ou tout autre éditeur WYSIWYG.


Grace à aux grand nombre de fonctionnalités implimentés, latex va faciliter l'apprentissage et l'utilisattion de Latex. Ainsi, vous n'avez à taper aucune commande textuelle pour générer votre cible. Cependant, vous ne pouvez utiliser kile si vous n'avez aucune connaissance Latex.


Installation de kile

Aujourd'hui, kile est integré par defaut dans la plupart des distributions linux. Vous pouvez l'installer directement au moment de l'installation de votre système ou, avec les commandes (o combien utiles)

apt-get install kile

sur la distribution ubuntu (etc ...) et

yum install kile

sur fedora (redhat, ....)

De toute évidence, l'installation de kile suppose que latex est déjà installé. Comme interagit en plus avec beauoups d'autres outils comme le lecteur pdf, le correcteur orthographique, les outils d'exportation vers les format pdf et ps ......, je vous suggère de faire une vérification du système (menu settings --> vérification du système). Cette action demande à kile de vérifier si tous les logiciels sont il a besoin sont installé. Un état va être affiché ainsi qu'une fenêtre d'avertissemant si un logiciel critique est manquant (voir figure 2)


Pour le bon fonctionnement de votre système, prenez le temps d'installer au moins les logiciels critiques (comme KDVI).










Les menus de kile

File: comme la plupart des logiciels graphiques, kile dispose du menu file (fichier) qui contient les fonctionnalités classiques comme l'ouverture, la sauvegarde, la fermeture et l'impression de documents. Vous pouvez aussi créer un modèle à partir d'un document ou supprimer un modèle. Enfin, ce menu contient trois fonctionnalités qui peuvent être très pratiques dans certaines situations à savoir: exporter un document vers HTML, convertir un document vers un format de votre choix et enfin, la fonction statistique qui renvoies les statistiques du documents.

Edit: le menu edit contient aussi les fonctions classiques d'édition de texte comme l'annulation de frappe, le couper/copier/coller, les fonctions de sélection et de recherche dans le texte. Ce menu offre aussi des fonctions intelligentes de navigation dans le document source et qui permettent de selection un environnement, de passer d'un item à en autre à l'intérieur d'un environnement et de supprimer un environnement.

View: ce menu est commun à toutes les applications KDE et contient les fonctions liée à l'affichage des documents dans kile.

Projet: C'est le menu principale de kile puisqu'il permet la création et le chargement de projet latex. En effet, bien que kile permet l'édition d'un fichier source latex sans ouvrir de projet, il est fortement conseillé de créer un nouveau projet pour chaque document que vous voulez générer. Un projet peut vous aider considérablement à traiter vos document en vous permettant l'accès à des fonctionnalités complexe comme la complétion de code et la gestion de bibliographie. Lors de la compilation, vous n'aurez même pas à indiquer quel est le document maître. Lors de la création d'un nouveau projet, un assistant vous proposera de créer un document à partir des modèles disponibles. Si aucun modèle ne vous convient, vous pouvez démarrer votre projet avec une page vierge.


Quand vous avez créé ou chargé votre projet, ce menu vous permet d'ajouter ou de supprimer des fichiers au projet. En plus, il offre une fonction pour l'archivage du projet (très intéressante pour tout informaticien qui se respecte).


Compilation: Quand vous voulez voir le résultat de votre travail, c'est au menu compilation que vous avez affaire. C'est un menu riche en fonctionnalités. Il vous permet par exemple de faire une compilation rapide de votre document, ou d'une partie (sous document, sélection) de votre document. Ce menu offre aussi l'accès à tous les outils de compilation disponibles sur votre système comme bibtex, pdflatex …... Vous n'avez donc à tapez aucune commande sur la console. Les fonctions de conversion et d'affichage des différents format sont aussi disponibles. Notons que le bon fonctionnement de ces tâche dépend des logiciels installés sur votre système (paragraphe installation de kile). Vous avez aussi la possibilité de paramétrer les outils que vous voulez utiliser (menu setting).

Notez enfin que si l'étape de compilation génère des erreurs, kile vous place votre curseur directement sur la ligne de l'erreur.



Latex: Ce menu est d'une importance capitale puisqu'il vous assiste dans la création de vos documents latex. En effet, l'apprentissage des balises latex reste l'un des facteurs qui freinent la migration des éditeur vers latex. Heureusement, avec kile, ce problème n'existera presque plus vu que ce menu offre la majorité des balises latex. De plus, ceux ci sont trié par catégorie. Par exemple, dans le sous-menu structure nous trouvons les balises \part, \chapter, \section ….. Notons aussi l'existence du menu bibliographie qui permet de gérer la bibliographie dans les document scientifiques. Notez que la dernière partie de ce menu est dédié aux commandes d'insertion de de fichiers (image, sous-fichier, ….).

La dernière option de ce menu permet d'édition et la modification des balises utilisateurs.

Assistant: Ce menu vient compléter la puissance et la souplesse du menu Latex en offrant à l'utilisateur des assistants qui permettent d'éditer des objet complexes tel que les tableaux, les figures et les matrices. Contrairement aux options de menu latex qui insèrent les balises latex directement dans la code source, ces assistants permettent d'éditer ces objets d'une manière graphique.










Cet assistant ajoutera le code suivant directement dans votre fichier source:

\begin{displaymath}

% use packages: array

\begin{array}{lll}

3 & 4 & 2 \\

2 & 3 & 5 \\

1 & 2 & 3

\end{array}

\end{displaymath}


Ainsi, avec les quatre menus que nous venons de voir, il est possible d'éditer un fichier latex sans avoir ni à écrire des commandes latex dans le fichier sources, ni à taper des commandes de compilation sur le terminal. De plus, avec les différents outils de conversion disponibles, il est possible de convertir le document cible vers différents format possible.


En plus de tous les menus que nous venons de présenter, les développeurs de kile (à l'image de tous les développeurs de logiciels KDE) ont pris de soin d'offrir aux utilisateurs des barres d'outils très utiles qui offrent un accès plus rapide aux fonctionnalités simples mais fréquemment utilisées comme la comme \frac{}{} qui permet d'afficher les quotient ou la commande \sqrt{}{} qui permet de dessiner le signe racine. De plus, une barre latérale, qui est l'une des meilleures fonctionnalités de kile (à mon avis), permet d'accéder:

  • une zone de navigation dans le système de fichier qui permet d'ouvrir des fichiers

  • une zone qui affiche la structure hiérarchique du document (ou du projet) en actif

  • une zone qui permet l'accès aux symboles mathématiques (parfois très complexes et très difficiles à retenir) comme les flèches, les vecteurs, les lettres grecs, …..













Malgré que kile dispose d'une variétés de fonctions qui sont stables et efficaces, il reste indispensable de connaître les bases de latex. Kile peut être vu comme une aide mémoire efficace et pratique. Il peux aussi servir d'outil pour l'apprentissage de Latex.


La stabilité des outils implémentés dans kile ne nous laisse pas à l'abri de commaitre des erreurs. Si vous utilisez l'interface graphique pour insérer une figure, il y a toujours un risque d'oublier de mettre la métrique de la largeur ou la longueur de de figure. Une compilation va alors générer des erreurs que seul un connaisseur (quitte à ce qu'il soit même débutant) peut corriger.



Sur le NET

Exellent tutoriel pour l'apprentissage de latex et kile: http://www.tice.ac-versailles.fr/logicielslibres/spip.php?article94



Le site officiel de kile: kile.sourceforge.net

Le site du projet latex: http://www.latex-project.org/