Créer un fichier d'aide CHM

Publié le 21/01/2009 18:46:30


Type de licence
Référence de votre poste

Les fichiers CHM ou HtmlHelp sont des fichiers d'aides Windows XP et Vista, ils remplacent l'ancien format HLP qui n'est plus officiellement supporté.

Ils sont construits à partir de fichiers HTML comme un site web, et utilisent des fichiers CSS pour déclarer les styles, vous pouvez aussi employer des fichiers javascript et Flash.

Prérequis

Help&Web se charge de générer les fichiers HTML et les autres fichiers associés mais pour la création finale de l'aide CHM vous avez besoin d'installer le compilateur gratuit de Microsoft.

Si besoin, téléchargez et exécutez htmlhelp.exe, il va installer les fichiers nécessaires pour compiler des aides htmlhelp.

Depuis Help&Web allez dans le menu Projet|Compilation et renseignez le champ compilateur (hhw.exe) en référençant le fichier hhw.exe qui se trouve dans le répertoire créé par htmlhelp.exe, par défaut C:\Program Files\HTML Help Workshop\hhw.exe

Décochez la case "Ouvrir le Html Help WorkShop" pour qu'Help&Web commande automatiquement le compilateur, dans le cas contraire celui-ci se lancera et vous permettra d'effectuer des réglages spécifiques avant de réaliser la compilation finale.

Fig. 134 Configurer les compilateurs d'aides

Styles

Les fichiers CSS permettent de définir les styles employés dans votre aide, pour gérer vos feuilles de styles allez sur l'onglet Style d'Help&Web, lisez le chapitre qui leurs est consacré dans le manuel d'Help&Web.

Javascript

Vous pouvez utiliser dans votre aide des scripts javascript, Help&Web le fait par exemple lorsque vous installez le moteur de recherche, consultez le tutorial javascript pour avoir toutes les informations nécessaires.

Flash

Les aides CHM supportent aussi les animations Flash, Help&Web met à votre disposition le composant Flash pour vous en faciliter leur insertion, vous le trouverez dans l'onglet Insérer section Composant > Flash

Fig. 135 Insertion d'une animation Flash

Directive conditionnelle

Help&Web vous permet d'incorporer des rubriques, ou des portions de rubriques, en fonction de diverses conditions et notamment du format de publication, dans le cas des aides CHM la condition est _HTMLHELP_ , ces aides étants basées sur le format html la condition _HTML_ est aussi valable.

Lisez le manuel au chapitre des directives conditionnelles pour apprendre à vous en servir.

Publication

Pour générer votre aide CHM depuis Help&Web il vous suffit de vous rendre sur l'onglet Publier et cliquer sur le bouton CHM dans la section Format, les fichiers nécessaires seront alors créés par Help&Web puis assemblés avec le compilateur Html Help WorkShop.

Distribution

Vous n'avez qu'un seul fichier à distribuer, le fichier .chm au nom de votre projet, vous le trouverez dans le répertoire HTMLHELP de votre projet, il contient l'ensemble des fichiers et des images y compris les éventuels javascript et flash.