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

SCR/AL1 - TOME I. Les programmes

31. 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.

Syntaxe

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.

• -i indique le nom du fichier input (.a2m n'est pas requis)
• -o indique le nom du fichier output (.rtf). Si ce nom n'est pas fourni, le nom du fichier input avec le suffixe .rtf est utilisé
• -hcw indique l'on souhaite créer une aude pour Windows 95. Dans ce cas, trois fichiers sont créés : .rtf, .hpj et .cnt. Ces fichiers servent d'input à HCW.
• -ini donne le nom du fichier .ini qui sert à initialiser les paramètres. Par défaut, ce fichier est a2m.ini.
• -title indique le titre du fichier d'aide
• -fs fontsize donne la taille des caractères du paragraphe par défaut (10 points par défaut)
• -tfs fontsize donne la taille par défaut des caractères des paragraphes dans les tableaux (8 par défaut).
• -tcol1 mm donne la largeur en mm de la colonne 1 des tableaux
• -tcoln mm donne la largeur en mm des autres colonnes des tableaux
• -tcolor {0 | 1} indique si on souhaite que les tableaux soient colorés (trame de fond)
• -tvlines {0 | 1} indique s'il faut dessiner des séparations verticales entre les colonnes des tableaux.
• -thlines {0 | 1} indique s'il faut dessiner des séparations horizontales entre les lignes des tableaux
• -s n'imprime pas les messages en cours de traduction
• -h fournit la syntaxe à l'écran.

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() :

• rtf = fichier contenant le texte de l'aide
• cnt = fichier contenant la structure de l'aide (table des matières)
• hpj = fichier contenant les paramètres de génération

Pour construire le fichier d'aide, il faut disposer du compilateur d'aide de Microsot : hcw.exe. Le processus se déroule comme suit :

• créer le ou les fichiers a2m
• contruire l'aide :

    scr4_a2r -i myfile.a2m -o myhelp.rtf -hcw

• compiler :

    hcw /A/C myhelp

• tester :

    winhelp myhelp

Exemple

    $ scr4_a2r -i tmp.a2m -hcw