1.Le fichier RTF| Une aide sous Windows est contenue dans
un fichier d'extension *.HLP. C'est le logiciel
WinHelp.exe qui gère ce fichier : affichage des pages,
sauts hypertextes, navigation avant/arrière, recherches,
historique ... Ce ficher HLP est créé à partir d'un scripte *.HPJ par un compilateur, fournit par Microsoft. Ce scripte *.HPJ fait référence à des fichiers Textes au format *.RTF contenant le texte proprement dit de l'aide. Le format RTF, pour Rich Text Format, est un format "standard" de texte développé à l'origine par Microsoft. Pour créer un fichier RTF pour l'aide, il faut que le format RTF supporte les ajouts de notes de bas de pages. Ceci est possible avec MS Word (2,6,7 mais pas 8). La navigation hypertexte est assurée par différentes mises en forme du fichier RTF. |
Tout d'abord chaque page de rubrique doit comporter des notes de bas de pages.
Il y a 4 types de notes :
| # | Chaîne contexte | Elle identifie une rubrique. Caractères valides 0-9A-Za-z point et _ |
| $ | Titre de la rubrique | Ce libellé apparaît dans la boîte de Recherche et dans l'historique. |
| K | Mots clés (Keywords) | Mots et phrases qui apparaissent dans la liste de recherche (option) Séparés par un point virgule. |
| + | Index de parcours | Ordre des pages pour le parcours par les boutons << et >> (option) syntaxe conventionnelle theme:ordre |
Ces notes (les 2 dernières sont facultatives) doivent être placées au début de la première ligne de la rubrique.
Voici résumées les 3 façons de naviguer dans les pages d'une aide :
- on utilise les flèches de parcours << et >> quand elles sont disponibles. (selon que les notes index (+) sont insérées ou non ...)
- les sauts hypertextes de page Saut vers la page 2 (pour revenir ici, vous appuierez sur le bouton Précédent sous les menus)
- les pages fugitives ou surgissantes Surgissement de la page 2 (la page disparaît par un simple clic souris ou une action du clavier)
(bien sûr on peut naviguer avec les modules Rechercher et Historique)
3 Codage des sauts hypertextes
Pour définir un saut (hypertexte) on écrit un texte double souligné, sur lequel on cliquera, suivi par la chaîne contexte (#) de destination en caractères masqués.
Vous avez alors défini ce qu'on appelle un HotSpot (Point Chaud) :
le texte double souligné est la partie visible du saut pour l'utilisateur,
le texte masqué est le code invisible de saut hypertexte...
Double souligné entraîne un saut dans la même fenêtre.
Simple souligné ouvre une fenêtre surgissante, qui disparaît par un clic souris.
Voilà pour le principe général de la conception d'un fichier RTF simple.
Vous pouvez dès maintenant passer à la
compilation,
mais tout d'abord éditez le
scripte projet nécessaire à cette compilation.
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