Présentation
Documentation
L'équipe
Sérialisation
 
Programmes
Objets
Libs Utilitaires
Libs Internes
   
 
Editeur
Syntaxes
Windows
Versions
   

SCR/AL1 - TOME VII. Version Windows

7. Les fichiers d'aide sous Win32

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.

7.1 SCR4_A2R : transformation de fichiers A2M en RTF

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

7.2 Le programme hcw 4.x

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