?

sommaire

sur cette page :

   Introduction
   Le fichier de rubriques
   Création des liens
   Les liens « pop up »
   Insérer une image
   Le fichier de projet
   Lier les fichiers
      de rubriques

   La section Map
   Lier les fichiers BMP
   Compilation du
      fichier d'aide

   En résumé

autres pages :

   Aide HLP,
      Introduction

   Help Workshop,
      > Leçon 1 <
      leçon 2
      leçon 3
   Bientôt :
      L'apparence des
      fenêtres
      et Les images
      réactives

autres sites

   Les fichiers d'aide       standards
   Création d'un fichier
      d'aide .HLP



© Isabelle Côté

création de fichier d'aide hlp

Accueil > Iza > Aide HLP > Microsoft HelpWorkshop 4, leçon 1
Ou Page précédente

Vos premiers pas

Introduction

C'est ici que commence vraiment ce tutoriel. Pour l'exercice qui suit, je suppose que vous avez peut-être fait le tutoriel sur les événements souris (tutoriel VisualBasic de ce site) mais ça n'est vraiment pas nécessaire pour la réalisation du fichier HLP. Car les images et les fichiers VB dont vous aurez besoin sont disponibles sur ce site.

Donc, avant de commencer, je vous invite à télécharger le fichier projetHLP.zip qui contient les fichiers nécessaires à ce tutoriel.

Note :
Pour décompresser le fichier ZIP, cliquez sur le bouton Extraire ou Extract pour la version anglaise (de Winzip) afin de conserver l'intégralité des sous-dossiers. Vous pourrez cependant extraire les fichiers vers un dossier de votre choix, de préférence le dossier qui contient votre fichier de rubrique (RTF).

Vous aurez besoin aussi des logiciels suivants :

  • Ms Word 97 (ou une version plus récente) ou un autre traitement de texte valide.
  • Ms Help Workshop 4 (version testée et expliquée dans ce tutoriel).

Vous trouverez Help Workshop sur votre cd-rom de VisualBasic 6 ou Visual Studio. Vous pouvez aussi télécharger le programme Microsoft Help Workshop depuis le site de Microsoft. Cette dernière version, plus récente, règle les problèmes de compatibilité entre le format RTF de Word 97 et le Compilateur de Help Workshop. C'est donc cette version que je vous conseille d'utiliser.

Nous allons d'abord faire un fichier de rubriques au format RTF avec le minimum d'éléments requis pour créer un fichier d'aide simple. Nous allons voir ensuite comment organiser les rubriques dans Ms Help Workshop afin de compiler notre fichier d'aide. Finalement vous pourrez consulter votre fichier HLP afin de pouvoir voir le résultat obtenu.

|   Haut de la page   |   Sommaire   |

Le fichier de rubriques

Dans Word (ou un autre traitement de texte) Créez un nouveau document et enregistrez-le au format RTF. Vous trouverez, dans la boîte de dialogue Enregistrer sous, le format RTF dans la liste déroulante Type de fichiers. Donnez à votre fichier le nom de AideHLP. Placez ce fichier dans un nouveau dossier que vous aurez prévu pour cet exercice et cliquez sur Enregistrer. Vous pouvez créer votre nouveau dossier directement dans la fenêtre Enregistrer sous en cliquant sur le bouton Créer un dossier.

Comme nous l'avons vu plus haut (dans la page générale sur l'aide HLP), il faut d'abord créer un fichier au format RTF qui sera ensuite transformé en fichier d'aide par le compilateur du programme Help Workshop. Le compilateur utilisera le code RTF pour séparer les différentes rubriques en pages individuelles et créer les liens entre elles.

Vous allez donc taper le texte de quelques rubriques en y ajoutant les titres et les sauts de pages requis. Voici comment procéder.

  1. Tapez d'abord le titre suivant :
       Titre de ma rubrique
    et attribuez lui le style Titre 1 (barre d'outils format, première liste déroulante).
  2. Créez un second paragraphe (touche Entrée) et tapez y un court texte. Par exemple :
       Texte de ma rubrique.
    C'est votre rubrique principale. C'est elle qui sera affichée en tout premier dans votre fichier d'aide.
  3. Créez un autre paragraphe et tapez y ceci :
       Lien vers une autre rubrique
     
  4. Créez un saut de page : Insertion > Saut, puis cliquez sur Saut de page et sur OK (CTRL + Entrée donne le même résultat). Si vous utilisez WordPerfect : Insertion > Nouvelle Page.
  5. Bouton Affichage normal Cliquez sur Affichage > Normal ou sur le bouton Affichage normal à gauche de la barre de défilement horizontale pour que vous puissiez visionnez toutes vos rubriques les unes à la suite des autres sans espaces blancs des bas de pages.
  6. Dans la nouvelle page, tapez un nouveau titre :
       Autre rubrique
    Puis du texte :
       Texte de l'autre rubrique avec plus d'explications sur le sujet.
  7. Ajoutez un autre saut de page.
  8. Dans cette troisième page, tapez le texte de la rubrique de type pop up. Ne tapez que le texte qui apparaît ici en caractères gras.
       Explications (ajoutez ici un saut de ligne : MAJ + Entrée)
       apparaissant dans une fenêtre pop up.
  9. Donnez au mot Explications l'attribut Gras (Word 97 : CTRL + G, WordPerfect 8 : CTRL + B). Ne laissez pas de paragraphe vide sous l'explication. Ça laisserait un espace blanc à la fin du paragraphe qui serait moins esthétique dans la bulle pop up.
  10. Ajoutez un dernier saut de page à la fin du fichier. Puis tapez :
       Texte de l'aide contextuelle
  11. Enregistrez votre fichier.
Suggestion d'un internaute :
Pour aérer le texte, la boîte de dialogue Paragraphe (Format / Paragraphe) vous permet d'ajouter de l'espacement avant et après vos paragraphes.
Personnellement je n'y songeais plus, puisqu'il y a longtemps que j'ai modifié le style Normal affin de toujours obtenir de l'espacement entre mes paragraphes.
Modifier le style Normal : (avec Word) Votre curseur se trouvant dans un paragraphe de style Normal, cliquez sur Format / Sytles, bouton Modifier, puis le bouton déroulant Format / Paragraphe de la boîte de dialogue Modifier le style. Une fois vos modification faites au style de paragraphe cliquez sur OK. Puis, dans la boîte de dialogue Modifier le style, cochez la case Ajouter au modèle et validez en cliquant sur OK. Cliquez sur Appliquer dans la boîte de dialogue Style pour valider et fermer.
Avec WordPerfect, cliquez sur Format / Styles ou faites ALT+F8. Dans la Liste des Styles, sélectionnez Style Document puis cliquez sur Modifier. Faites vos modifications dans l'Éditeur de styles. Si vous voulez que ces modifications s'appliquent à tous vos nouveaux documents, cochez la case Utiliser par défaut. Cliquez sur OK pour valider puis sur Fermer pour fermer la Liste des styles.
Vous ouvrirez rapidement l'Éditeur de styles si la fenêtre de codes est ouverte (ALT+F3) en double-cliquant sur le bouton-code Style ouvert: Style Document.
Merci à Pierre pour sa judicieuse suggestion.

|   Haut de la page   |   Sommaire   |

Création de liens

Maintenant que vous avez composé vos rubriques, il vous faut créer les différents liens ou sauts qui les relieront entre elles.

Pour pouvoir créer des liens, il faut d'abord identifier nos rubriques. Le compilateur est un instrument capricieux et il faut satisfaire ses exigences. Tous les identifiants (noms internes des rubriques) devront commencer par IDH_. Autrement, vous pourriez voir apparaître des messages d'erreurs après la compilation de votre fichier d'aide.

Pour créer les identifiants (ID) de vos rubriques d'aide :

  1. En premier lieu, si les caractères non imprimables (espaces, sauts de lignes, sauts de pages, marques de paragraphe, etc.) ne sont pas affichés, affichez les en cliquant sur le bouton  ¶  de la barre d'outils standard.
  2. Placez le curseur au début du premier titre (devant le premier caractère) et insérez une notre de bas de page : Insertion > Note.
  3. Dans la boîte de dialogue Note de fin ou de bas de page, Vérifiez que l'option Note de bas de page soit bien l'option sélectionnée. Dans la zone Numérotation, cliquez sur l'option personnalisé. Le curseur se trouve maintenant dans la zone de saisie à droite de l'option Personnalisé. Tapez y le symbole # (dièse). Cliquez sur OK.
  4. Une notre de bas de page vient d'être ajoutée. Tapez y l'identifiant : IDH_PRINCIPAL. N'oubliez pas le caractère de soulignement et les lettres majuscules.
  5. Placez le curseur devant le deuxième titre et insérez une note similaire (#). Cette fois, donnez lui l'identifiant IDH_SECONDAIRE.
  6. Placez maintenant le curseur devant le mot Explication, premier mot de la dernière rubrique, et entrez une note de bas de page (#) avec l'identifiant IDH_EXPLICATIONS.
  7. Pour la dernière rubrique, placez le curseur devant le paragraphe Texte de l'aide contextuelle et insérez une note de pas de page (#) et tapez le nom de l'identifiant IDH_CONTEXTUEL.
  8. Enregistrez votre fichier.

Vous venez de placer les signets qui permettront de créer des liens. Vous êtes probablement familier avec les fenêtres d'aide HLP de Windows. Deux sortes de liens y apparaissent. Des liens qui « sautent » vers d'autres rubriques et des liens qui affichent une définition. Ces derniers sont appelés « pop up » dans le jargon informatique.

Vous allez maintenant créer un lien de type jump (saut) pointant vers une autre rubrique. On utilise le soulignement pour les liens de type « pop up » et le soulignement double pour les liens de type « jump » (saut). On place le nom de l'identifiant immédiatement après le mot ou la phrase servant de lien et le style Texte masqué indiquera au compilateur l'adresse du lien. Voici comment procéder :

  1. Placez le curseur à la fin de la phrase Lien vers une autre rubrique et tapez le nom de l'identifiant de la rubrique à lier : IDH_SECONDAIRE.
  2. Sélectionnez la phrase en prenant soin de ne pas sélectionner l'identifiant. Ouvrez la boîte de dialogue Police (Format > Police), déroulez la liste Soulignement et choisissez Double. Cliquez sur OK.
  3. Sélectionnez l'identifiant. Attention de ne pas sélectionner ni la phrase qui servira de lien ni la marque de paragraphe.
  4. Cliquez sur Format > Police. Dans la boîte de dialogue Police, dans la zone Attributs, juste en haut de l'aperçu, cochez la case Masqué et cliquez sur OK.
    Vous venez de créer un lien de type « jump ».
  5. Enregistrez votre fichier.
    Il n'y aura pas de lien vers la rubrique IDH_CONTEXTUEL. Vous verrez ce que l'on en fera lors de la prochaine leçon.
Note :
Si vous utilisez WordPerfect, le seul moyen pour vous de voir le texte masqué est d'afficher la fenêtre de code : Visualisation > Afficher les codes ou ALT + F3.

Quelques conseils avant de continuer. Pour la création de véritables rubriques d'aide, vous aurez besoin d'un grand nombre d'identifiants et vous risquez de vite vous y perdre. J'ai l'habitude de maintenir une liste manuscrite des titres de rubriques et de leurs identifiants. Cette liste devient fort utile lors de la mise en place des liens et aussi lors de la création du fichier de compilation (fichier de projet). Utilisez des noms assez courts et significatifs. Il vous sera plus facile de vous les rappeler et de les taper sans faire d'erreur.

|   Haut de la page   |   Sommaire   |

Des liens pour les rubriques « pop up »

La création de liens vers vos rubriques pop up se fait un peu de la même façon. Il vous suffit de donner au mot ou au groupe de mots qui serviront de lien l'attribut Souligné. Voici la marche à suivre :

  1. Placez le curseur juste après le mot explications dans le texte de l'Autre rubrique, sans laisser d'espace.
  2. Tapez, en majuscules, l'identifiant de la rubrique pop up :
       IDH_EXPLICATIONS.
  3. Sélectionnez le mot explications, rien d'autre et appliquez lui le style souligné
    (bouton Soulignement de la barre d'outils Format).
  4. Sélectionnez l'identifiant IDH_EXPLICATIONS en prenant soin de ne pas sélectionner la marque de paragraphe ni le mot souligné.
  5. Ouvrez la boîte de dialogue Police : (Format > Police ou, pour Word :CTRL + D, pour WordPerfect : F9) et cliquez sur l'attribut Masqué puis sur OK.
  6. Enregistrez votre fichier.

|   Haut de la page   |   Sommaire   |

Insérer une image

Cette fois, le code d'un document RTF que produit le logiciel de traitement de textes ne peut pas grand chose pour gérer l'insertion d'images. Il vous faudra entrer à la main le code nécessaire. Heureusement ça n'est pas trop compliqué !

La syntaxe du code à utiliser ressemble à ceci :

   {bmx fichierimage.bmp}x correspond à une des valeurs suivantes :

Valeur Description
c Place l'image bitmap comme un caractère dans le texte.
Exemple : {bmc monimage.bmp}
l Aligne l'image bitmap à la marge de gauche, le texte en habillage à droite de l'image.
Exemple : {bml monimage.bmp}
r Aligne l'image bitmap à la marge de gauche, le texte en habillage à gauche de l'image.
Exemple : {bmr monimage.bmp}
t Est utilisé en combinaison avec une des valeurs ci-haut. Indique que les pixels blancs de l'image peuvent être convertis dans la couleur la plus proche de celle du fond de la fenêtre. Cette valeur peut être utilisée avec les bitmaps 16 couleurs.

Le format de fichier image utilisé ici est le bitmap de windows (bmp). Mais on peut utiliser aussi le format bitmap indépendant du périphérique (DIB pour Device Independent Bitmap), les métafichiers Windows (WMF), les images à zones réactives (SHG) et les "Windows help multi-resolution bitmaps" (MRB). Dans cette rubrique et celles qui suivent, nous utiliseront les formats BMP et SHG uniquement.

Le nombre de couleurs utilisés peut influencer sur l'affichage final de l'image. Certaines machines, en configuration minimale ne pourront afficher les bitmaps crées en 16 bits de couleurs ou plus. Aussi, il est recommandé de créer vos bitmaps en 16 (couleurs de base du système) ou 256 couleurs. Reportez-vous à la section Traitement des images de ce site.

Pour cet exercice, vous devrez placer une image alignée à gauche. Vous pourrez essayer par la suite l'alignement à droite (bmr) ou comme un caractère (bmc). Voici la marche à suivre :

  1. Placez le point d'insertion (curseur) juste à la fin du lien vers une autre rubrique, devant la marque de paragraphe et appuyez sur la touche Entrée.
    Si vous utilisez Word, il se peut que l'attribut Masqué soit toujours actif. Sélectionnez la marque du paragraphe (¶) que vous venez de créer (celui juste à droite du texte masqué). Ouvrez la boîte de dialogue Police et désactivez la case à cocher Masqué s'il y a lieu. (Avec WordPerfect et sa fenêtre de codes, vous pouvez mieux contrôler l'emplacement du code de paragraphe. Ce nouveau paragraphe ne devrait pas contenir l'attribut Masqué.)
  2. Entrez le code et le texte qui suit :
       {bml interface.bmp}Une image placée à gauche du texte
  3. Enregistrez votre fichier

Vous trouverez l'image interface.bmp dans le fichier projethlp.zip que vous avez téléchargé. Si vous ne l'avez pas encore fait, je vous invite à le faire maintenant afin de pouvoir continuer l'exercice.

Rappel :
Pour décompresser le fichier ZIP, cliquez sur le bouton Extraire ou Extract pour la version anglaise (de Winzip) afin de conserver l'intégralité des sous-dossiers. Vous pourrez cependant extraire les fichiers vers un dossier de votre choix, de préférence le dossier qui contient votre fichier de rubrique (RTF).

Voici à quoi ressemble maintenant votre fichier de rubriques.

Fichier de rubriques

|   Haut de la page   |   Sommaire   |

Le fichier de projet

C'est maintenant le moment de dire au logiciel Help Workshop ce qu'il doit faire avec votre fichier de rubrique. Pour ce faire, vous allez créer un fichier de projet et y ajouter les différentes composantes nécessaires à la compilation de votre fichier d'aide. Vous allez d'abord créer le fichier de projet. Voici comment procéder :

  1. Démarrez Help Workshop : Démarrer > Programmes > Microsoft Help Workshop > Help Workshop.
  2. Cliquez sur File > New (CTRL + N).
  3. Dans la boîte de dialogue New, choisissez Help Project et cliquez sur OK.
  4. Dans la boîte de dialogue Project File Name,
    • sélectionnez le dossier où se trouve votre fichier RTF
    • et donnez le nom AideHLP à votre fichier.
    • Ne tapez pas d'extension et ne cherchez pas le type dans la zone Type de fichier. Cliquez sur OK. L'extension HPJ sera ajoutée automatiquement.

Votre fichier de projet comporte déjà une section [OPTIONS] contenant deux valeurs. La première correspond à la langue utilisée pour vos fichiers d'aide. Il s'agit ici de la langue telle que spécifiée dans les paramètres régionaux de votre système d'exploitation (Windows, plus spécifiquement). La deuxième valeur correspond au fichier de rapport qui est créé automatiquement pendant (ou après... allez savoir...) la compilation de votre fichier d'aide. Ce rapport est très utile en cas d'erreur pendant la compilation. Il pourra vous aider à apporter les correctifs nécessaires.

|   Haut de la page   |   Sommaire   |

Lier les fichiers de rubriques au fichier de projet

Il vous faut maintenant lier votre fichier de rubriques à votre fichier de projet. Cela indiquera au compilateur quel est (ou sont) le (ou les) fichier(s) de rubriques doit être ajouté et compilé pour créer le fichier d'aide complet. Voici comment procéder :

  1. Cliquez sur le bouton Files à droite de la fenêtre de Microsoft Help Workshop.
  2. Dans la boîte de dialogue Topic Files, Cliquez sur le bouton Add .
  3. Dans la boîte de dialogue Ouverture (ou Open...), sélectionnez votre fichier aideHLP.rtf et cliquez sur Ouvrir (à moins que ce ne soit Open).
  4. Dans la boîte de dialogue Topic Files, cliquez sur OK.

Une section [Files] contenant le nom de votre fichier de rubriques vient d'être ajoutée à votre fichier de projet.

|   Haut de la page   |   Sommaire   |

La section [Map] du fichier de projet

Il ne suffit pas d'ajouter le nom du fichier de rubriques pour que le compilateur sache quoi faire avec celui-ci. C'est ici que normalement votre liste manuscrite des noms d'identifiants et des titre de rubriques intervient. Mais pour cette fois, comme nous n'avons que trois rubriques et que Word est probablement encore ouvert nous n'auront pas besoin d'une telle liste. Vous pourrez consulter votre fichier RTF directement dans Word (ou votre traitement de textes habituel) pour trouver les noms d'identifiants. Vous aurez besoin de ces identifiants pour créer la section [MAP] de votre fichier de projet.

La section [MAP] liste toutes les rubriques. Vous leur attribuez aussi chacune un numéro. Cette procédure vous permettra par la suite d'associer vos rubriques d'aide à de l'aide contextuelle dans vos fenêtres d'applications comme les boîtes de dialogue pas exemple. Profitons de l'explication qui suit pour préparer notre fichier pour l'aide contextuelle (que nous verrons dans la prochaine leçon) :

  1. Cliquez sur le bouton Map de la partie de droite de la fenêtre de Help Workshop.
  2. Dans la boîte de dialogue Map, cliquez sur le bouton Add .
  3. Dans la fenêtre Add Map Entry, sous l'item Topic ID, Entrez : IDH_PRINCIPAL.
  4. Sous Mapped numeric value, entrez : 101.
  5. Cliquez sur OK.

Répétez ces opérations 2 à 5 avec les valeurs suivantes :

ID Numero Map
IDH_SECONDAIRE 102
IDH_EXPLICATIONS 501
IDH_CONTEXTUEL 801
  1. Cliquez sur OK pour valider et fermer la boîte de dialogue Map.

|   Haut de la page   |   Sommaire   |

Lier les fichiers images au fichier de projet

Re-rappel :
Si vous ne l'avez pas encore fait, c'est le moment ou jamais !
Télécharger le fichier projetHLP.zip. Pour décompresser le fichier ZIP, cliquez sur le bouton Extraire ou Extract pour la version anglaise (de Winzip) afin de conserver l'intégralité des sous-dossiers. Vous pourrez cependant extraire les fichiers vers un dossier de votre choix, de préférence le dossier qui contient votre fichier de rubrique (RTF).

Vous devez aussi indiquer dans quel dossier Help Workshop doit trouver le fichier image que vous avez inséré dans votre fichier de rubriques. Après l'extraction des fichiers (projetHLP.zip) vous devriez trouver le fichier interface.bmp dans le dossier AideBMP. Pour indiquer le nom du dossier dans votre fichier de projet, vous devez :

  1. Dans la fenêtre de Help Workshop, cliquez sur le bouton Bitmaps .
  2. Dans la boîte de dialogue Bitmaps Folders, cliquez sur le bouton Add .
  3. Si vous avez enregistré votre fichier de projet dans le même dossier que le fichier de rubriques (et de surcroît, le dossier ou se trouve les fichiers décompressés dont le dossier AideBMP), vous devriez voir le chemin de votre dossier de travail dans la zone Location de la boîte de dialogue Choose folder containing bitmap files.
    Double-cliquez sur le nom du dossier AideBMP dans la liste Folders.
  4. Cliquez sur OK pour valider et fermer la boîte de dialogue Choose folder containing bitmap files, puis à nouveau sur OK pour valider et fermer la boîte de dialogue Bitmap folders.

Voilà ! C'est fait ! Vous êtes prêt à compiler votre fichier d'aide !

|   Haut de la page   |   Sommaire   |

Compilation du fichier d'aide

C'est la partie la plus facile. Sauf s'il y a des erreurs, bien entendu. Votre fichier RTF est prêt et enregistré. Votre fichier de projet est prêt et il ne reste plus qu'à l'enregistrer et lancer la compilation. Alors, retenez votre respiration, croisez les doigts d'une main et de l'autre cliquez sur le bouton Save and Compile en bas, à droite de la fenêtre de Microsoft Help Workshop.

Une fois la compilation terminée, Help Workshop affiche le rapport de compilation. Si tout c'est bien passé, vous devriez pouvoir lire sur la dernière ligne du rapport :
   0 notes, 0 warnings.
Si ce n'est pas le cas, c'est que quelque chose n'a pas bien été fait. Voyons un peu ce qui aurait pu se passer. Si tout est parfait, vous pouvez maintenant visionner votre fichier d'aide.

Les notes et les avertissements (warnings) se trouvent habituellement au début du rapport. J'ai volontairement provoqué quelques erreurs pour illustrer différentes situations. Il a pu se produire l'une des situations suivantes :

Avertissement ou Note Explication et solution
HC3021: Warning: topic #1 of C:\Mes documents\AideHLP.rtf : Cannot find the bitmap "interface.bmp."

  • C:\Mes documents\AideHLP.rtf représente le chemin complet de votre fichier RTF de rubriques. Ce chemin peut être différent sur votre ordi.

Cet avertissement vous indique que le fichier interface.bmp n'a pu être trouvé. Il faut vérifier si vous avez indiqué le bon dossier.

  • Dans la fenêtre de Help Workshop, cliquez sur le bouton Bitmaps.
  • Dans la boîte de dialogue Bitmap folders, véfifiez que c'est bien le dossier AideBMP qui se trouve dans la liste. Si c'est un autre dossier, cliquez sur le bouton Remove. Puis, cliquez sur le bouton Add.
  • Dans la boître de dialogue Choose folder containing bitmap files, repérez le dossier AideBMP dans la liste Folders et DOUBLE-CLIQUEZ dessus. C'est bien un double-clic qu'il faut faire ici. Un simple clic ne sélectionnera pas votre dossier.
  • Cliquez sur OK, et encore une fois sur OK pour valider et fermer les deux boîtes de dialogue.
  • S'il n'y avait que ce seul problème à résoudre, vous êtes prêt à compiler de nouveau. Cliquez sur le bouton Save and Compile.
HC6008: Error:
No files have been specified in the [FILES] section of the Project file.

Ni une note, ni un avertissement. C'est un message d'erreur vous avertissant qu'aucun fichier de rubrique n'a été lié. Si c'est votre cas, c'est que vous avez tout bonnement sauté une partie de l'exercice. Retournez à la section Lier les fichiers de rubriques au fichier de projet pour corriger la situation.

Une fois que vous aurez réglé le problème, cliquez sur Save and Compile pour enregistrer et compiler le fichier.

HC3038: Warning:
The following Topic IDs are not defined in the [MAP] section of the Project file: IDH_EXPLICATIONS Topic 3 of C:\Mes documents\AideHLP.rtf

  • C:\Mes documents\AideHLP.rtf représente le chemin complet de votre fichier RTF de rubriques. Ce chemin peut être différent sur votre ordi.

Ceci signifie que l'une de vos rubriques n'a pas été définie dans la section [MAP].

  • Cliquez sur le bouton Map dans la fenêtre de Help Workshop.
  • Dans la boîte de dialogue Map, cliquez sur le bouton Add.
  • Dans la boîte de dialogue Add Map Entry, ajoutez dans la zone Topic id l'identifiant mentionné dans l'avertissement et le numéro correspondant dans la zone Map numeric value. Reportez vous à La section Map du fichier de projet de cette page en cas de besoins.
  • Cliquez sur OK puis encore sur OK pour valider et fermer les deux boîtes de dialogue.
  • Si c'est le seul problème que vous deviez régler, cliquez sur Save and Compile pour enregistrer et compiler votre fichier d'aide.
HC3038: Warning:
The following Topic IDs are not defined in the [MAP] section of the Project file: IDH_EXPLICATIONS Topic 3 of C:\Mes documents\AideHLP.rtf
HC1010: Note:
The following mapped Topic IDs were not used in any topic: IDH_EXPLICATION

  • C:\Mes documents\AideHLP.rtf représente le chemin complet de votre fichier RTF de rubriques. Ce chemin peut être différent sur votre ordi.

D'abord un avertissement indique qu'un identifiant du fichier RTF n'est pas défini dans la section MAP. Puis une note dit qu'un identifiant de la section MAP n'est pas utilisé dans aucune rubrique. Si c'est votre cas, vous avez commis une erreur en transcrivant le nom d'identifiant dans la section MAP. Les deux mots n'étant plus identique, ils sont considérés comme des identifiants distinct. L'un n'étant pas défini dans section MAP et l'autre pas utilisé dans vos rubriques (fichier RTF).

  • Dans la fenêtre Help Workshop, cliquez sur MAP.
  • Dans la fenêtre Map, sélectionnez l'identifiant erroné dans la liste Map topic IDs to numeric values et cliquez sur Edit.
  • Dans la boîte de dialogue Edit Map Entry, corrigez l'identifiant fautif et cliquez sur OK pour valider.
  • Clilquez encore une fois sur OK pour valider et fermer la bo&icric;te de dialogue Map.
  • De nouveau, s'il s'agissait de la seule (ou dernière) erreur à corriger, vous êtes maintenant prêt à compiler votre fichier. Cliquez sur Save and Compile.

Pour visionner votre fichier d'aide :

Repérez le fichier AideHLP.hlp dans l'explorateur de Windows et double-cliquez dessus. Votre fenêtre d'aide devrait ressembler à ceci :

Votre fenêtre d'aide

|   Haut de la page   |   Sommaire   |

En résumé

Vous venez de créer votre premier fichier d'aide HLP. Il est plutôt rudimentaire, mais assez bien dans l'ensemble.

Dans cette leçon, vous avez appris :

  • à créer un fichier de rubrique au format RTF,
  • à créer des liens dans votre fichier de rubriques,
  • à insérer une image dans une rubrique,
  • à créer un fichier de projet,
  • à lier vos fichier de rubrique et d'images à votre fichier de projet,
  • à créer une liste (map) de sujet en vue de créer l'aide contextuelle,
  • à compiler vos fichiers en un fichier d'aide HLP
  • et enfin, à identifier et résoudre certains problèmes.

Essayez les différents liens. Vous avez peut-être remarqué qu'en cliquant sur le bouton précédent ou le bouton Sommaire, vous revenez toujours à la votre rubrique principale.

À travers les leçons suivantes, vous apprendrez, entre autres, à planifier un fichier de sommaire pour afficher la fenêtre Sommaire. Vous apprendrez aussi à créer un index de mots clés et à créer une image réactive. Mais d'abord, dans la leçon suivante, vous apprendrez comment lier votre fichier d'aide à un projet VisualBasic et comment créer de l'aide contextuelle dans vos fenêtres d'application.

|   Page précédente   |   Page suivante   |

|   Haut de la page   |   Sommaire   |