Améliorations

4.Améliorations

Limitations/Conseils

Le compilateur ne peut traiter que des volumes limités de données. (64 Ko)

Si des erreurs apparaissent concernant des problèmes mémoires, vérifiez qu'il n'y a pas d'image insérée directement dans l'éditeur de texte, essayez de diviser votre fichier texte en plusieurs fichiers.

Si le volume de l'aide est vraiment très important, vous devrez utiliser le compilateur d'aide en mode protégé HCP.exe. Pour éviter de jongler , ...

N'hésitez pas à renommer HCP.exe en HC31.exe (et son fichier err en HC31.err) afin que Whpe l'utilise. Il est clair que Windows doit fonctionner en mode protégé.

L'édition du fichier d'aide peut s'avérer longue. Il ne faut donc pas hésiter à travailler sur une machine puissante pour l'élaboration d'un projet d'aide. Le fichier compilé pourra être ventilé sur des machines courantes sans problème.

Les images

Pour insérer une image, il suffit de placer la macro-commande {bmx fichier.bmp} où x prend les valeurs :

l pour un alignement à gauche (left)
r pour un alignement à droite (right)
c pour une image ayant le comportement d'un caractère.

(pour centrer une image, il faut utiliser l'alignement du paragraphe)

Les format DIB, BMP, WMF, SHG et MRB sont supportés. Théoriquement seules 16 couleurs sont affichables... Je conseille autant que possible d'utiliser les couleurs Windows, quitte à convertir ou dégrader une image : cela évite les problèmes de flip/flap de couleurs des logiciels.

Il est possible mais déconseillé d'insérer des images directement dans le fichier RTF.

Il faut être conscient des limitations du compilateur (voir ce qui précède Limitations).

Le logiciel Shed.exe permet de définir des images *.SHG qui comporte des HotSpots pour la navigation hypertexte. (barres de boutons, cartes , ...)

Le logiciel Mrbc.exe permet de définir des images *.MRB ayant différents résolutions. Néanmoins selon le système, Winhelp supporte les images 256 couleurs sans utiliser MRBC.

Affichage défilant/non défilant (Scrolling & non-scrolling zone)

Pour rendre un en-tête de page fixe, c'est-à-dire que la zone principale d'information peut défiler (scroll) mais les premières restent figées, il suffit de formater les lignes concernées en paragraphes solidaires (format, paragraphe..)

Le compilateur de scripte HPJ permet de régler la couleur de ces 2 zones.

Saut à l'intérieur d'une page

Vous pouvez insérer des sauts hypertextes vers une partie de la page actuellement affichée.

Cela paraît difficile puisque les sauts se font vers les chaînes contextes des pages repérées par (#).

Il suffit simplement d'ajouter au lieu d'arrivée du saut une note de bas de page # pour créer chaîne contexte locale. Pour sauter vers ce point, utilisez la syntaxe habituelle hot spot en double souligné et chaîne contexte en masqué. (C'est ce que j'utilise pour le plan de la page Le fichier RTF )

Tableaux/ Bordures

Le fichier RTF peut comporter des tableaux.

Ceux-ci sont plus efficaces que les tabulations pour formater les paragraphes.
Néanmoins, la mise en forme des bordures n'est pas supportée par le compilateur d'aide...

Paradoxalement, les bordures pour un texte simple sont supportées.

Il faut donc être astucieux et savoir que de toute façon une mise en forme tableau est traduite une mise en forme par tabulations dans l'aide. Quelques essais vous permettront d'avoir une présentation propre.

Utiliser des macros commandes simples

Vous pouvez piloter l'aide depuis la page d'aide sans passer par les menus ou boutons.

Pour simuler >>, on peut écrire page suivante par .

Attention, mettre un espace entre le ! et la macro, le tout en caractères cachés.

Il y a aussi la macro Prev()... Voici un saut pour une liste exhaustive des macros .

Maintenant vous pouvez aussi découvrir les changements à venir

Pour plus de détails (mais en anglais) consulter l'aide en ligne sur la création d'aide Windows fournie avec Delphi dans le fichier cwh.hlp .