2.Le fichier projet HPJ

Le(s) fichier(s) RTF bâti(s), il faut indiquer au compilateur d'aide les fichiers à compiler :

- les différents fichiers RTF

- le répertoire des fichiers images (codés par la macro {bmx ...}) s'il est différent de celui du projet

- les paramètres de la fenêtre d'aide : taille, position, couleurs, macros (parcours par BrowseButton) …

... et d'autres rubriques : [MAP] pour faire une aide contextuelle (propriétés HelpContext sous Delphi) ...

L'édition du scripte projet (extension HPJ) et sa compilation (extension HLP) sont prises en charge par Windows Help Project Editor (WHPE.exe) sous Win'3.1x.

Il faut que HC31.exe ,et le fichier HC31.err associé, soient "visibles" (dans le répertoire Windows ou System) pour pouvoir compiler. En effet, Whpe ne fait que les piloter via HcParse.dll .

Vous pouvez

• sélectionner divers fichiers RTF par le menu Edit, Add New or Existing File ...
• donner un titre à l'aide (et choisir la version 3.1) par le menu Edit, Project ...
• régler le taux de compression (maximal pour la compilation finale!) par le menu Edit, Compression...
• régler la taille de la fenêtre (main) par le menu Edit, Window Definitions ...
• indiquer les images hors du répertoire projet par le menu Edit, Graphics ...
• Vous pouvez dès lors Sauvegarder votre projet par File, Save Project As ...
• Vous avez créé un scripte HPJ que vous pouvez maintenant compiler par le menu Compile, Start.
• Pour voir le résultat, allez dans le menu File, Run Help On ...

Arrivé ici, vous avez obtenu une aide indépendante, qui peut être invoquée par tout programme ou par vous-même en double-cliquant sur le fichier HLP. Essayez !

Le fichier texte HPJ ressemble à ceux-ci :

--------------------------------------------------------------------------------------------------------------

; This help project requires hc 3.1
[OPTIONS]
errorlog = aide.err ; fichier recevant les erreurs de compilation
title = Aide et logiciel Delphi 1 ; le titre principal
compress = 0 ; la compression 0 1 2
warning = 3 ; affichage des avertissements
report = 1 ; rapport

[FILES]
aide28.rtf ; sources RTF

[MAP]
hlp_fichierRTF 1 ; chaîne contexte associée au numéro de contexte

[WINDOWS]
main = "Aide et logiciel Delphi 1", (100,100,800,800 ),, (192,192,192 ), (255,255,192 ) ; fenêtre d'aide titre, taille, couleurs...

[CONFIG]
BrowseButtons() ; permettre d'utiliser << et >>

--------------------------------------------------------------------------------------------------------------

Maintenant nous allons nous occuper de l'interfaçage à Delphi.

Sommaire | 1 le fichier texte RTF | 2 le fichier scripte HPJ | 3 l'interfaçage à Delphi 1 | 4 les améliorations | 5 un avenir proche