A propos de l'utilisation d'Almost Free Text (AFT)

AFT est un système d'aide à la saisie de texte source en LaTeX, écrit par Todd A. Coram

Objectif de ce mini-tutoriel

Créer très facilement des documents au format HTML, TeX et PDF, en utilisant un outil de saisie simplifiant l'entrée des commandes de mise en page

Principe

Pour installer AFT, utilisez votre gestionnaire de paquets préféré ou rendez-vous sur le site officiel.

AFT a été créé pour les connaisseurs de LaTeX comme pour ceux qui n'en n'ont jamais entendu parler (j'exagère un peu). Commencez par lancer un éditeur de texte comme Vi ou Gedit ou encore Kate  ¹. Entrez votre texte comme vous le feriez sur un Wiki, sauf que les commandes ne sont pas les mêmes (on utilise des astérisques ou encore des tabulations, ce qui rend la mémorisation des commandes on ne peut plus simplissime). Une fois le fichier enregistré, l'idée est de le compiler en utilisant AFT, ce qui aura pour effet de le transformer en fichier HTML ou TeX. Le fichier HTML que vous lisez en ce moment a été obtenu à partir du texte suivant entré dans un éditeur de texte.

Et la syntaxe ?

Eh oui, il faut bien un manuel pour s'y retrouver parmi les quelques commandes à connaître. Vous serez surpris par le caractère intuitif de tout cela. En moins de 30 minutes, vous comprendrez l'essentiel.

• Vous pouvez lire le manuel en français à cette adresse
• Télécharger la version francaise en PDF

Générer un fichier HTML

Une fois que vous avez entré votre texte et que vous l'avez enregistré, il vous reste à ouvrir un terminal et vous rendre dans le dossier où vous avez enregistré le fichier (ou tout simplement, clic droit dans le dossier et "ouvrir un terminal ici"). Il reste ensuite à compiler le texte avec aft :

$ cd home/mondossier
$ aft nomdufichier

Cela aura pour effet de créer un nouveau fichier nomdufichier.html comme celui que vous êtes en train de parcourir actuellement. La mise en page et la feuille de style de ce document sont automatiquement générés par AFT.

Générer un fichier Tex

Il s'agit du même type d'opération; Cette fois il s'agit d'utiliser AFT et lui attribuant une fonction (-type) qui lui permet de générer une sortie au format TeX. Ainsi :

$ cd home/mondossier
$ $ aft -type tex nomdufichier

Vous voici dès lors en possession d'un fichier TeX nomdufichier.tex, que vous pouvez par exemple modifier avec un éditeur. C'est l'avantage d'AFT de vous permettre de saisir très facilement du texte et de vous le retourner en un document TeX complet que vous pouvez par la suite améliorer si vous en avez envie. Vous pouvez cependant maîtriser certaines subtilités de votre format de sortie (comme passer quelques commandes HTML ou LaTeX) au cours de la saisie du document source. Voyez le manuel pour cela.

Si le fichier TeX que vous avez généré vous convient, et même sans vérifier, vous pouvez directement le transformer en PDF avec une commande classique :

$ pdflatex nomdufichier

Vous voici dès lors en possession d'un beau fichier PDF comme celui-ci.

  [1] - Faites attention lors de l'enregistrement a l'encodage des caracteres UTF-8 ou ISO 8859-15.

This document was generated using AFT v5.096