Crer un fichier CHMDans ce tutoriel, je vais vous expliquer comment crer un fichier .chm. Pour rappel, les fichiers CHM sont les fichiers daide de Windows.

Pour suivre ce tutoriel, vous aurez besoins de : un diteur HTML (Notepadd++, Nvu, Dreamweaver...) Microsoft HTML Help Workshop (nous allons le tlcharger)

N'ayez pas peur la vue de Microsoft, car cest le logiciel le plus pratique pour crer un fichier CHM. Je prcise que ce logiciel est gratuit, mais en anglais.

Voil, nous pouvons commencer.

Sommaire du tutoriel : Prliminaires Ouverture et assistant Le projet La table des matires L'index On compile Ce que je ne vous ai pas dit

PrliminairesQue sont les fichiers CHM

CHM signifie Compiled HTML. En clair, ce sont des fichiers HTML compils. Ces fichiers sont lisibles sous toutes les versions de Windows, partir de la version 98. Il est galement possible de lire ces fichiers sous MacOS (il vous faut CHMViewer 1.1.5) et Linux (il vous faut chmviewer). Si vous voulez voir un exemple de fichier CHM, ouvrez leBloc-notes de Windows, et faites F1. D'autres logiciels et bibliothques existent pour manipuler les CHM sous Linux : archmage - Dcompresseur gnochm - Visualiseur pour GNOME kchmviewer, kchmviewer-nokde - Visualiseurs pour KDE libchm-bin, libchm-dev, libchm1 - bibliothques pour traiter les CHM xchm - Visualiseur pour X

L'avantage des fichiers CHM rside dans le fait que tout le contenu est inclus dans un seul fichier. Ainsi, l'aide d'un logiciel peut tre contenue dans un seul de ces fichiers, alors qu'une aide ou format1

HTML serait compose de plusieurs centaines de fichiers spars.

Microsoft HTML Help WorkshopPour commencer, allez tlcharger le logiciel ici : en direct de MS Une fois tlcharg, installez-le. Il existe plusieurs logiciels pour crer des fichiers CHM. Parmi eux : CHM Workshop. Ce gratuiciel est trs pratique pour convertir rapidement une page HTML en une page CHM. Mais il est tout automatis, et ne vous permet pas de crer votre sommaire comme vous le voulez, d'inclure les fichiers ncessaires (a pose des problmes avec les images appeles par des feuilles de style par exemple), donc, je ne vous en parlerai pas.

Les fichiers HTMLPour la pratique, nous allons faire un fichier CHM en partant de deux fichiers HTML tout fait. Histoire de vous montrez une vue d'ensemble de HTML Help Workshop, je vais utiliser 2 dfinitions de Wikipdia, en version allge (du point de vue design). Pour la simplicit, je vous ai compress ces 2 pages, ainsi que les fichiers ncessaires leur bon fonctionnement dans l'archive suivante (en .zip) : Tlchargez le ZIP, et dcompressez-le Un petite chose : les fichiers CHM ont besoins de Internet Explorer 4 (au minimum). Vous avez donc compris que les fichiers HTML doivent tre compatibles pour IE, puisque c'est son moteur de rendu qui est utilis pour afficher les CHM.

Ouverture et assistant

Pour commencer, ouvrez HTML Help Workshop. Comme vous pouvez le constater, le programme n'a pas l'air trs intuitif (mais l'air ne fait pas la chanson ). Cliquez sur le menu Files, puis sur New. . Cliquez

Dans la bote de dialogue, slectionnezProject. C'est alors que le magicien arrive sur Suivant.

2

Dans cette nouvelle tape, cliquez sur Browse, et allez dans le dossier o vous avez dcompress l'archive ZIP que je vous ai donne. Dans le champ Nom de fichier, tapez le nom du fichier .hhp que vous allez crer. Moi je mets Dfinitions:

Euh, c'est quoi un fichier HHP ? On ne fait pas un CHM ici ? Ah, je l'attendais cette question Eh bien le fichier HHP est un fichier qui va contenir tout ce dont HTML Help Workshop a besoin pour crer un fichier CHM. C'est un peu le fichier de configuration. Revenons-en notre assistant. Cliquez sur Suivant. Dans cette nouvelle tape, l'assistant demande si on a dj cr certains fichiers. Cochez juste la case HTML files. Cliquez sur Suivant. Maintenant, il s'agit, comme vous l'aurez dj compris, de renseigner les fichiers HTML qui seront utiliss. Pour l'exercice, vous allez seulement ajouter le fichier gif.html. Cliquez maintenant sur Suivant, puis sur Terminer.

Le projetVoici ce que vous devriez obtenir (ou peu prs) :

3

Ce que vous voyez dans le cadre de gauche, c'est en fait le contenu du fameux fichier HHP. J'ai repris et expliqu les diffrentes options : Compatibility : c'est la version de compatibilit du fichier Compiled file : c'est le nom que portera le projet une fois compil en CHM Default topic : c'est la page qui sera ouverte par dfaut lors de l'ouverture du fichier CHM Display compile progress : afficher ou nom la progression lors de la compilation Language : la langue du fichier CHM. Comme je suis belge, Windows met que je parle le franais de Belgique (oufti, qu' malin, ts)

Sous la rubrique Files sont affichs tous les fichiers qui seront compils. Pour l'instant, nous n'en avons qu'un, mais a va changer

Modifier le projetLes informations disponibles sous la rubrique Options sont modifiables. Il vous suffit de doublecliquer sur une des informations, pour faire apparatre une fentre de configuration. Dans l'onglet General, vous pouvez attribuer un titre votre fichier. C'est toujours bien pratique a . Par ailleurs, vous pouvez aussi modifier la page par dfaut. Pour le moment, vous n'avez ?).4

qu'un seul fichier, donc par dfaut, c'est le fichier par dfaut (vous me suivez

Pour ce qui est des 3 autres onglets, il vaut mieux ne pas y toucher, c'est juste un conseil d'ami

Ajouter des fichiersVous pouvez videmment ajouter d'autres pages HTML votre projet. Pour cela, cliquez sur cette icne : Une jolie petite fentre s'ouvre, vous prsentant les fichiers contenus dans votre projet. Pour en ajouter, cliquez sur Add. Profitez-en pour ajouter le fichier png.html. C'est un peu bte dire, mais pour ajouter des images, des fichiers de type CSS, JS et SWF, nous allons utiliser la mme mthode. Le malheur, c'est que dans la fentre d'explorateur ne sont affichs que les fichiers HTML. Vous devrez donc taper compltement le nom de chaque fichier, comme ceci :

Faites de mme avec les autres fichiers (titre1.png et fond.gif) Si vous avez beaucoup de fichiers incorporer, fermez HTML Help Workshop, et ouvrez le fichier Dfinitions.hhp avec le Bloc-notes, et ajoutez la main les diffrents fichiers :

5

La table des matiresNous arrivons maintenant la partie qui demande le plus de temps, et qui est gnralement pratique, pour ceux qui vont lire votre fichier CHM. Dans la fentre de HTML Help Workshop, cliquez sur l'onglet Contents. Dans la bote de dialogue qui s'ouvre, cliquez sur OK. C'est alors que vous vous retrouvez dans une fentre d'exploration, vous demandant de nommer un fichier .hhc. Appelez-le Dfinitions.hhc. Ce fichier HHC est le fichier qui contiendra les paramtres de votre table des matires. De retour dans le la fentre principale du logiciel, nous allons pouvoir commencer crer. Cliquez sur l'icne nouveau dossier : pour insrer un dossier. Une fentre s'ouvre. Dfinissez-y le titre de votre

Cliquez sur OK. Comme vous pouvez le constater, le dossier Dfinitions est maintenant ajout dans votre table des matires. Si vous le dsirez, vous pouvez changer l'icne qui lui est attribue. Pour cela, cliquez une fois dessus, puis cliquez sur . Dans la fentre qui s'ouvre, allez sous l'onglet Advanced. Faites + ou - dans la liste choix Image index, jusqu' ce que vous trouviez l'icne qui vous convient. Moi je vais choisir celle-ci :

Nous allons ajouter maintenant un lien vers la page gif.html. Pour cela, cliquez sur . Comme pour le dossier, attribuer lui un titre. Quand c'est fait, cliquez sur Add, pour ajouter un lien. Choisissez dans la liste la page lier. Remarquez que la liste prsente les pages HTML via leur titre, ce qui n'est pas plus mal, je trouve.

6

Voici ce que j'obtiens :

Cliquez sur OK pour valider. Comme pour le dossier vous pouvez changer l'icne. Excutez la mme dmarche pour le fichier png.html. Et comment on fait si on veut encore faire des sous-dossiers, et des sous-fiches (des ancres) ? Ben ce n'est pas trs compliqu. Par exemple, nous allons insrer des liens vers des ancres dans le fichier gif.html (les ancres y sont dj mises, j'avais prvu le coup ).

7

Cliquez sur GIF. Ajoutez un fichier, comme nous l'avons fait prcdemment. Dfinissez les options, mais dans le lien, ajoutez le nom de l'ancre (#machin), comme ceci :

Dis donc toi, comment je sais o sont les ancres ? Ben, comme c'est vous qui avez thoriquement cod la page, vous devriez le savoir, non ? Cela dit, HTML Help Workshop est aussi une sorte d'diteur HTML. Petit exemple : Nous allons ouvrir la page gif.html, pour voir o sont ces fameuses ancres. Pour cela, cliquez sur GIF, dans l'arborescence de votre table des matires. Ds que c'est fait, cliquez sur l'icne La page gif.html s'ouvre alors dans le cadre de droite de l'diteur. Vous pouvez donc voir les ancres qui y sont. Ah oui, petite astuce : dans la page, je n'ai pas fais mes ancres avec la balise A ; j'utilise btement l'attribut ID de la balise H2 Le problme, c'est que ce lien s'est ajout sous GIF. Or, nous voudrions que ce soit une sous-partie de GIF. Pour cela, cliquez sur . Dans la bote de dialogue qui s'ouvre, cliquez sur Oui. C'est fait. Changez-l'icne, pour montrer que c'est une sous-partie. Faites attention : le lien PNG a t dcal aussi. Vous devez le ddcaler en utilisant l'icne avec "la flche dans l'autre sens" (logique non ?). Voil. Moi, j'ai continu faire les ancres pour GIF, et puis pour PNG. Faites-le aussi, pour vous entraner :

8

L'indexL'index n'est pas du tout obligatoire, mais a peut tre un petit plus. Je ne vais pas m'tendre dessus, car sa ralisation est assez simple, mais fastidieuse. Je vais juste vous expliquer le principe. L'index est en fait une liste de mots-cls, comme ceci :

Chaque mot cl renvoie une ou plusieurs pages. Par exemple, moi je vais faire une architecture comme ceci : Formats d'images o GIF o PNG

9

Voici les configurations pour chacun des mots-cls :

10

On compileC'est le moment de compiler notre petit fichier. Commencez par enregistrer votre projet (cliquez sur la petite disquette). Pour compiler, allez dans le menu Files, puis cliquez sur Compile. Vrifiez que le champ Project files pointe bien sur le fichier Dfinitions.hhp :

Cliquez sur Compile. Dans le cadre de droite, toute une srie d'informations apparat. Ces infos font tat du bon ou mauvais droulement de la compilation (il pourrait trs bien vous manquer des fichiers par exemple).11

La compilation est finie ds que vous voyez crit Created c:\......... Dans notre exemple, c'est relativement rapide. Mais si vous faites un fichier d'aide avec 1000 fichiers HTML, des images, des fichiers de script et tout, ce sera plus long Vous pouvez maintenant voir le rsultat. Pour cela cliquez sur la petite paire de lunettes rose. Petit conseil : pour vrifier si toutes les images on bien t prises en compte, dplacez votre fichier .chm final de dossier, et ouvrez-le, pour voir si des images ne sont pas manquantes.

Ce que je ne vous ai pas ditVous avez certainement dj remarqu que dans certains fichiers CHM, il est possible d'effectuer une recherche sur le texte, ainsi que de mettre en Favoris. Pour faire cela, nous avons besoins de crer une nouvelle dfinition de fentre. Eh eh eh oui, bien sur. Et c'est quoi a ? Ben c'est juste une srie de paramtres qui vont dfinir l'interface du fichier CHM. Alors, allez dans l'onglet Project, et cliquez sur cette icne : . Dans la bote qui s'ouvre, tapez Dfinitions. C'est le nom que j'ai dcid d'attribuer l'ensemble des paramtres de dfinition de la fentre. Validez. Dans l'onglet Gnral, dfinissez un titre. Moi je mets Dfinitions derechef.

Sous l'onglet Buttons, cochez Hide/Show (afficher/masquer le menu), Back (Page prcdente), Forward (page suivante), Options, Print (imprimer), Refresh (Actualiser), etHome (page d'accueil). Ce seront les boutons prsents dans la barre de menu de votre CHM.

12

Si vous cochez Home, allez sous l'onglet Files, et renseignez le champ Home, par la page qui fera office de page de dmarrage. Dans l'onglet Position, mettez les 4 champs 0. Comme cela, la fentre s'ouvrira au centre, avec des dimensions en rapport avec la rsolution de l'cran. Cochez aussi la case, de faon ce que la fentre s'ouvre dans les dimensions et la position laquelle elle tait lors de la dernire lecture.

Sous l'onglet Navigation Pane, cochez les 3 dernires cases cocher. Cela a pour fonction d'ajouter la fonction de recherche, ainsi que la gestion des favoris. La liste Default tab dfinit l'onglet qui sera ouvert par dfaut. Par commodit, je vous recommande de placer cette liste en position Contents, c'est plus joli, comme la table des maties quand on ouvre un livre explicatif.

13

Sous l'onglet Extended Styles, vous pouvez cocher Tool window, pour faire genre que vous savez faire un fichier CHM avec une barre de titre fine (je vous laisse tester cette otption). Les outres options ne sont pas utiles. Cliquez sur OK. Il est possible qu'un assistant s'ouvre, en vous disant (en anglais), qu'il y a des problmes. C'est cause de la recherche. Faites Suivant. L, cochez les 2 cases. Cliquez sur Suivant, puis sur Terminer.

Informations sur le tutoriel Retour en haut Cr : Le 05/04/2006 13:22:33 Modifi : Le 14/02/2009 11:37:49 Avancement : 100% Licence : Copie non autorise 46 commentaires

14