SCR/AL1 - TOME VII. Version Windows
Introduction
La logique de traitement des fichiers d'aide reste identique à ce qu'elle était dans les versions antérieures: à partir d'un fichier d'aide construit à l'aide d'un éditeur Ascii ou en ayant recours aux programmes de génération automatique de fichiers, on construit un fichier structuré contenant des sujets successifs éventuellement imbriqués.
Le fichier résultant de ce traitement est alors compilé pour obtenir un fichier d'aide de SCR/AL1, exploitable dans les applications.
D'autres exploitations peuvent être faites de ce fichier si on tire parti du programme scr4_hm. Ce dernier programme permet de générer un fichier en langage a2m.
Les fichiers a2m peuvent alors être filtrés de façon à obtenir un des outputs suivants:
On le voit, ces multiples possibilités permettent d'intégrer le résultat de la construction des fichiers d'aide dans de nombreux environnements.
Génération d'une aide pour Windows 95
Dans le cas de la génération d'une aide pour Windows 95, le processus est le suivant:
Ces deux derniers points font l'objet des chapitres suivants.
Interprète le contenu d'un fichier a2m et génère un fichier .rtf et éventuellement d'autres pour obtenir un input pour la création d'un fichier d'aide Win32.
Syntax
SCR/AL1 Version 4.32 [02/97] - Copyright (c) 1987-1997 JM & B PAUL (SN:942)
Syntax : scr4_a2r -option args ... @responsefile
OPTION ARGUMENTS REQ DEFAULT DESCRIPTION
------ --------- --- ------- -----------
-i filename Y a2m input file
-o filename N rtf output file
-hcw N generate Win95 help format
-ini filename N Ini file
-title text N Help Title
-fs nn N Default Font Size
-tfs nn N Table Font Size
-tcol1 nn N Table Col 1 width (mm)
-tcoln nn N Table Col 2-n width (mm)
-tcolor nn N Table Colors (0|1)
-tvlines nn N Table Vertical lines (0|1)
-thlines nn N Table Horizontal lines (0|1)
-s N Silent mode (no message)
-h N Display this message
La syntaxe des fichiers a2m est décrite dans un chapitre spécifique.
Fichier a2m.ini
Le fichier a2m.ini (ou un autre) contient des paramètres pour l'impression et la lecture du fichier a2m.
Certains paramètres ne sont pas gérés par le compilateur d'aide de Windows 95, notamment dans les attributs des tableaux.
Générer un fichier pour Word
Supposons que l'on ait le fichier tmp.a2m et que l'on souhaite obtenir le fichier tmp.rtf. Il suffit de lancer la commande :
$ scr4_a2r -i tmp
Générer une aide Windows 95
Si on souhaite générer une aide sous Windows 95, les fichiers suivants sont générés par le programme A2mToRtf() :
Pour construire le fichier d'aide, il faut disposer du compilateur d'aide de Microsot : hcw.exe. Le processus se déroule comme suit :
scr4_a2r -i myfile.a2m -o myhelp.rtf -hcw
hcw /A/C myhelp
winhelp myhelp
Exemple
$ scr4_a2r -i tmp.a2m -hcw
Objet
Ce programme fourni avec les compilateurs C de Microsoft et de Borland permet de "compiler" un fichier d'aide écrit en RTF avec les contraintes spécifiques liées aux fichiers d'aide.
Le programme scr4_a2r utilisé avec l'option -hcw génére les fichiers nécessaires.
Syntaxe
Toutes les informations nécessaires sont disponibles dans le fichier d'aide de ce programme. La syntaxe la plus courante est:
hcw /C/A filename
Fichiers générés
Deux fichiers générés doivent être distribués: le fichier .cnt et le fichier .hlp. Le premier est construit pas scr4_a2r et le second par hcw.
Le fichier .cnt est un fichier Ascii qui peut être adapté à la main et qui reprend la table des matières avec le texte et la référence de chaque sujet repris dans le fichier HLP.
Le fichier .hlp est un fichier au format d'aide de Windows (95).
Copyright © 1998-2015 Jean-Marc Paul and Bernard PAUL - Envoyez vos remarques ou commentaires à bernard@xon.be