Introduction à Htmldoc Par

I  n  t  r  o  d  u  c  t  i  o  n

Objectif de ce didacticiel :
Nous allons voir, à travers un exemple, comment réaliser une documentation au format PDF avec un document source en HTML. Ce didacticiel décrit sommairement les principales fonctions de HTMLdoc.

Pré-requis :
Si vous n'avez jamais réalisé de documents au format HTML, la lecture du didacticiel sur la création de pages HTML est indispensable.
 

Htmldoc est, au départ, un programme développé par une société commerciale pour ses besoins internes. Elle la finalement diffusé sous Licence GNU/GPL afin que chacun puisse profiter librement de cet outil.

Le format html, dérivé du SGML, permet de structurer un ensemble d'informations mais ne peut prendre en compte des paramètres de mise en page. Les seuls formats (libres) qui puissent gérer un document structuré et avec mise en page sont le Postcript et le PDF. La fonction de Htmldoc est donc de pouvoir générer des documentations parfaitement imprimables sans perdre la structure du document. D'un côté, Htmldoc utilise un ficher source en HTML et il va en sortir un document Postscript ou PDF. Ce programme reconnaît la majorité des balises HTML 3.2 et peut générer des fichiers PDF au format 1.2 et 1.3, encryptés ou non.

Installation
A moins de vouloir compiler HTMLdoc, dans ce cas il vous faudra la bibliothèque de widgets FLTK, l'installation est relativement simple. Htmldoc est aussi disponible pour Windows. Après avoir téléchargé et décompressé l'archive sur le site d"ESP (http://www.easysw.com/htmldoc), vous pouvez lancer l'installation en lançant le script d'installation  htmldoc.install en tant que root. Htmldoc est opérationnel. Pour lancer le programme il suffit de saisir dans une console : htmldoc.