SCR/AL1 - TOME I. Les programmes
30. SCR4_A2H : traduction A2M vers HTML
Ce programme traduit un fichier rédigé en langage a2m vers un fichier HTML (.htm). Il peut s'intégrer dans un programme batch et permet ainsi d'automatiser des procédures de transfert ou de traduction.
Il fait partie de la suite des outils de création de manuels:
- scr4_e pour créer une source .m
- scr4_h pour compiler les fichiers.m
- scr4_hm pour générer un fichier a2m
- scr4_a2f pour créer un fichier Frame ou
- scr4_a2h pour créer un fichier HTML ou
- scr4_a2r pour créer un fichier RTF (aide Windows) ou
- scr4_a2g pour imprimer le fichier
Syntaxe
Syntax : scr4_a2h -option args ... @responsefile
OPTION ARGUMENTS REQ DEFAULT DESCRIPTION
------ --------- --- ------- -----------
-i filename Y a2m input file
-o filename N html output file
-hcw N generate html help format
-ini filename N Ini file
-fs nn N Default Font Size
-tfs nn N Table Font Size
-tcolor nn N Table Colors (0|1)
-tborder nn N Table Border
-paranum nn N Para numbering (0|1)
-title text N Document Title
-s N Silent
-lt 0|1 N Replace < by < if 0
-strip 0|1 N Suppress HEAD and BODY sections
-gif2bmp N Replace .gif refs by .bmp
-style file.css N Import STYLE file.css
-font Helv|Times N Default font family
-h N display this message
- -i indique le nom du fichier input (.a2m n'est pas requis)
- -o indique le nom du fichier output (.htm). Si ce nom n'est pas fourni, le nom du fichier input avec le suffixe .htm est utilisé
- -hcw génère les fichiers nécessaires pour créer un fichier .chm (HtmlHelp)
- -ini donne le nom du fichier .ini qui sert à initialiser les paramètres. Par défaut, ce fichier est a2m.ini.
- -fs fontsize donne la taille des caractères du paragraphe par défaut (10 points par défaut). Toutes les tailles ne sont pas disponibles en HTML. Le programme tente de s'approcher au mieux des paramètres fournis.
- -tfs fontsize donne la taille par défaut des caractères des paragraphes dans les tableaux (8 par défaut).
- -tcolor {0 | 1} indique si on souhaite que les tableaux soient colorés (trame de fond)
- -tborder {0 | 1} indique s'il faut dessiner un cadre autour des tableaux
- -paranum {0 | 1} indique s'il faut numéroter les paragraphes (dont la définition contient number=n)
- -title "texte" indique le titre du document qui s'affichera comme titre de la fenêtre dans le brwoser HTML.
- -s limite les affichages en cours de compilation
- -lt {0|1} remplace les "<" par des < if 0, ne remplace pas si 1
- -strip {0|1} supprime les sections HEAD et BODY
- -gif2bmp remplace les extensions .gif par .bmp
- -style filename.css inclut dans le code HTML le fichier de styles
- -font {Helv|Times|Courier|Palatino|Bookman} fixe la police par défaut
- -h fournit la syntaxe à l'écran.
La syntaxe complète des fichiers a2m se trouve dans un chapitre spécifique.
Exemple
$ scr4_h -c s_exes.m -o tmp.hlp
$ scr4_hm -c -i tmp
$ scr4_a2h -i tmp
Dans cet exemple, on trouve les opérations suivantes:
- compiler le fichier s_exes.m et stocker le résultat dans tmp.hlp
- générer un fichier tmp.a2m à partir de tmp.hlp
- traduire le fichier tmp.a2m en tmp.htm