Introduction à Htmldoc Par Toussaint Frédéric

Utilisation de HTMLDOC

Configuration des entrées "Input"

Le premier Onglet concerne la configuration des entrées (Input). Le Type de document vous permet de préciser que vous souhaitez simplement transformer une page web en fichier PDF (type web page) et l'autre optiion "book" vous permet de suivre la structure du document HTML afin de pouvoir générer automatiquement un index de la documentation. Dans ce mode vous devez faire attention à bien respecter la stuctrure du document sinon Htmldoc peut avoir une erreur fatale.

Le bouton "add files" vous permet d'insérer les fichiers sources en HTML, vous pouvez en spécifier plusieurs, ils seront lus dans l'ordre indiqué (c'est pour cela que vous avez des boutons "Move up et Move down" au cas où vous auriez besoin de modifier l'ordre des fichiers.

Le champ "logo image" vous permet de spécifier une imgage d'en-tête pour votre documentation, elle sera répétée sur chaque page, nous pourrons paramétrer par la suite l'emplacement de ce logo sur chaque page.

Le champ "Title File/image" vous permet de préciser un logo pour la page d'acceuil mais cela peut être aussi un document précis au format HTML qui contiendra votre page de garde.

Vous pouvez enregistrer votre travail grâce au bouton "save as", htmldoc créera un fichier .book dans le répertoire indiqué.

Le bouton "Generate" permet de lancer la création du document, mais il faudra d'abord spécifier les paramètres de sortie avant de lancer cette commande.

Les paramètres de sortie "Output"

Les différents formats de sortie :

Dans cet onglet vous pouvez choisr entre obtenir une sortie au format Postscript (PS) , Portable Document Format (PDF) ou HTML. Dans le champ "outpout path", vous pouvez préciser ici un nom de fichier.
Des cases à cocher vous permettent de spécifier si vous souhaitez avoir une page de garde (Title page); et si vous souhaitez utiliser la compression jpeg pour le format PDF, les tirettes vous autorisent la modification du taux de compression.

L'onglet Page

Dans cet onglet vous allez pouvoir indiquer le format de page pour la sortie PDF ou PS (universal, A4, letter). La case "2-sided" permet de générer des documents recto verso et la case "Landscape" permet d'orienter le document en mode paysage.

Les quatre cases correspondent aux marges du document.

La section "Header et Footer" (En-tête et pied de page) se subdivisent en 3 parties, qui correspondent au côté gauche, milieu et côté droit du document. Vous avez plusieurs possibilités pour le remplissage de ces champs :

• Blank : vide, rien à insérer
• Title : insertion de l'image ou du document Title page de l'onglet Input.
• Chapter Title : le titre de la section sera insérer (disponible en mode Book)
• Heading : Titre du document
• Logo : insertion du logo définit dans l'onglet Input
• 1,2,3, ii, III, abc, ABC : Numérotation classique
• 1N 1C : numérotation relative (ex: page 1/4)
• Date, time : insertion date et/ou heure

L'onglet TOC

Cet onglet n'est disponible que si vous êtes dans le mode Book (Onglet Input). Vous pouvez spécifier ici l'apparence de votre page d'index, qui affiche la structure complète du document.

Vous pouvez préciser le nombre de niveaux,  et comme pour l'onglet précédent, les en-têtes.

Onglet Color

Permet de paramétrer certains attributs de page :

• Body color : pour modifier la couleur des pages du document (par défaut blanc)
• Body image : permet d'insérer un filigrame dans le document
• Text Color : attention cela affecte la couleur de la police sauf si une autre est spécifiée dans le document source. (par défaut, respecte la couleur du source)
• Link color : le format PDF gère les liens, vous en préciser la couleur (par défaut bleu)
• Link style : vous pouvez avoir des liens soulignés ou non.

Onglet Font :

Dans cet onglet vous pouvez préciser la taille des polices, l'espacement entre les lignes, le type de Police (Times, Helvetica ou courrier) pour le corps, les en-têtes et pied de page et l'encodage (pour nous Français, c'est ISO 8859-1)

Onglet PS :

Si vous avez opté pour une sortie en Postscript, vous pouvez spécifer si vous souhaiter un postscritp de niveau 1, 2 ou 3.

Onglet PDF :

Cet onglet permet de paramétrer certaines options disponibles pour le format PDF.

• Version du PDF : 1.1, 1.2 et 1.3 sont disponibles
• Page mode : permet de préciser le type de document à générer : le mode Outline donnera un document avec la table des matières visible, le mode document, affichera seulement les pages du document, le mode fullscreen est utilisé pour faire des présentations.
• Page Layout : vous permet de spécifer comment les pages seront visualisées dans Acrobat. Une page ou plusieurs colonnes.
• First page : précise la page qui doit d'abord être affichée, table des matières ou page1 ou chapitre 1.
• Page effect : acrobat peut générer des animations de transitions à la lecture, c'est ici que vous pouvez indiquer le type d'effet à générer.Si vous spécifiez un effet, vous pouvez alors en préciser la durée grâce aux deux tirettes.
• Links : les liens seront respectés si vous cochez cette option.

Onglet Encrytion

Vous pouvez protéger vos oeuvres de la copie, des modifications, de l'impression grâce à cet onglet. Il suffit de préciser que vous souhaitez encrypter votre document et de lui indiquer les modes. N'oubliez pas de donner un mot de passe.

Onglet Option

Html editor : Vous pouvez préciser un éditeur html externe , celui-ci sera lancé quand vous ferez un double clic sur le nom du fichier HTML dans l'onglet Input.

Browser width : paramètre important car cela va permettre à htmldoc de simuler une largeur de page.

Search path : dans certains cas,  les images sont insérées avec des liens relatifs dans le code HTML, vous pouvez préciser ici un lien absolu à suivre