1. Téléchargez et installez le logiciel
Commencez par créer, sur votre disque dur, un dossier que vous nommerez Aide ; vous y stockerez tous les fichiers de votre projet. Ouvrez votre navigateur Web et rendez-vous à l’adresse
www.vizacc.com/gen_download.php, puis faites défiler la page vers le bas et cliquez sur le lien HelpMaker Build 7.1. 475 (ou un numéro de version plus élevé, s’il y a
eu une mise à jour). Téléchargez le fichier (6,3 Mo) et lancez l’installation.
2. Créez un nouveau document
HelpMaker installé, lancez-le et cliquez sur New… (Ctrl + N) puis sur le bouton Next. Cliquez sur le bouton à droite du champ Enter the path and filename of… (voir écran
1). Sélectionnez le dossier C:Aide et tapez Mondoc dans le champ Nom du fichier. Cliquez sur Enregistrer. Enfin, dans le champ Project Name, saisissez de nouveau
Mondoc puis cliquez sur Next et sur Finish.
3. Définissez la structure de votre document
Vous allez commencer par définir les chapitres et les pages de votre document. Nous verrons plus loin comment relier tous ces éléments. A l’origine, HelpMaker crée trois chapitres (Chapter 1,2 et 3), contenant chacun
une simple page (Topic). Pour ajouter un chapitre, faites un clic droit sur Help Contents et sélectionnez Add Child. Dans la zone Insert Type, cochez l’option Chapter. Dans le champ
Treeview Text, tapez le nom de votre nouveau chapitre. Cliquez sur OK. Pour ajouter une page dans un chapitre, faites un clic droit sur ce chapitre (ou sur Help Contents pour insérer une page indépendante de
tout chapitre) et sélectionnez Add Child. Dans le champ Treeview Text, tapez le nom de votre nouvelle page (voir écran 2). Cliquez sur OK. HelpMaker met à votre disposition des
‘ fenêtres
surgissantes ‘, plus couramment appelées pop-ups, que vous pourrez utiliser à la manière des classiques annotations de bas de page. Pour ajouter un pop-up, faites un clic droit sur le lien Popups et sélectionnez
Add Child.
4. Renommez et déplacez les éléments
A tout moment, vous pouvez déplacer un élément (page, chapitre ou fenêtre pop-up) par simple glisser-déposer. Pour supprimer un élément de votre document, faites un clic droit dessus et sélectionnez Move to Trash.
Pour renommer un élément, sélectionnez-le dans le volet de gauche de HelpMaker, appuyez sur la touche F2, tapez le nouveau nom et validez par Entrée. Pour choisir la page que votre fichier d’aide affichera toujours à
l’ouverture, faites un clic droit sur cette page et sélectionnez Set as default topic (voir écran 3).
5. Ajoutez textes et illustrations
Dans le volet gauche de HelpMaker, cliquez sur la page dans laquelle vous voulez insérer du texte. Dans le volet de droite, tapez ce texte dans la partie jaune ou copiez-le depuis votre logiciel de traitement de texte. Tapez le
titre de la page dans la zone grise placée au-dessus. La barre d’outils de HelpMaker vous permet de modifier la police du texte, sa taille, sa graisse ou encore son alignement, de la même façon qu’un traitement de texte. Pour insérer une
illustration, cliquez dans le texte à l’emplacement voulu et déroulez le menu Insert, Picture. Vous pouvez modifier la justification d’une image de la même manière que celle d’un texte. Pour changer la taille de l’image, faites un clic
droit dessus et, dans le menu qui apparaît, sélectionnez Format picture. Cochez l’option Lock Aspect Ratio afin que l’image que vous redimensionnez conserve toujours le même rapport largeur/hauteur, puis modifiez la valeur
du champ Height (voir écran 4) pour augmenter ou réduire la taille de votre image. Cliquez sur OK lorsque vous avez fini.
6. Insérez les liens interactifs
Vous allez maintenant créer des liens qui permettront aux personnes qui liront votre fichier d’aide de passer directement d’une page à une autre, comme dans une page Web ou dans les fichiers d’aide de Windows. Dans le volet de
gauche, choisissez la page qui doit recevoir le lien. Dans le volet de droite, sélectionnez les mots ou l’image que vous voulez rendre cliquables (vous pouvez sélectionner un mot en double-cliquant dessus). Ces mots apparaîtront soulignés dans le
document avec une couleur différente. Faites un clic droit sur l’élément en question et optez pour Hyperlink. Si cette commande n’apparaît pas dans le menu, choisissez Ignore all pour désactiver le contrôle orthographique,
sans intérêt ici. La commande Hyperlink sera désormais accessible. Pour qu’un clic sur ce lien déclenche l’ouverture d’une fenêtre surgissante, cliquez sur Link to Popup Window, sinon cliquez sur Normal Link (voir
écran 5). Dans la liste de droite, sélectionnez la page visée par le lien et cliquez sur OK.
7. Compilez votre fichier…
Lorsque vous avez fini de structurer votre document, cliquez sur MonDocdans le volet de gauche de HelpMaker. Il faut maintenant choisir un type de fichier. HelpMaker vous donne le choix entre HLP ou CHM. Nous vous
conseillons d’opter pour le format CHM (c’est l’option HTML-Help). Certes, ce format est moins compact que le HLP ?” les fichiers obtenus sont donc plus volumineux ?”, mais il offre plus de possibilités au niveau de la
présentation. Dans le cadre Target, cliquez sur HTML-Help (voir écran 6). Cochez l’option 16m color mode… pour profiter pleinement des couleurs de vos photos. Cliquez sur le bouton Compile.
La durée de la compilation dépend de la taille du document, du nombre d’images qu’il contient et de la puissance de votre PC.
8. … et vérifiez-le
L’opération terminée, votre fichier d’aide s’ouvre automatiquement (voir écran 7). Parcourez-le, vérifiez qu’il se comporte bien de la manière voulue, puis refermez-le. Si vous voulez effectuer des corrections,
cliquez sur Close et corrigez votre document. Sinon, cliquez sur Explore Help Directory. Vous retrouverez, entre autres, un fichier nommé Mondoc.chm. C’est ce dernier que vous devez diffuser à vos
correspondants.
9. Conservez votre fichier source
Après la compilation, vous retrouverez, dans le dossier Aide et dans les sous-dossiers créés, de nombreux fichiers. Deux d’entre eux jouent un rôle primordial. Le premier, Mondoc.chm, évoqué au paragraphe
précédent, correspond au fichier d’aide résultant. Le second, Mondoc.sh5, situé dans le sous-dossier _tmphhp, est très important lui aussi : c’est le fichier source dont vous aurez besoin si vous souhaitez modifier
votre projet. Pour l’ouvrir, vous n’aurez qu’à lancer HelpMaker, choisir l’option Open (Ctrl + O) et ouvrir le fichier Mondoc.sh5.
