SCR/AL1 - TOME III. Les librairies utilitaires
19. Le groupe s_a2m
19.6 A2mToHtml (file s_a2mhtm.c:146)
Syntax
A2mToHtml(a2mfile, outfile, wh)
char *a2mfile, *outfile;
int wh;
Description
Interprète le contenu d'un fichier a2m et génère un fichier .htm.
- a2mfile = nom du fichier a2m à interpréter
- outfile = nom du fichier htm à générer
- wh = 0 pour un fichier HTML simple, 1 pour un fichier pour Html Help
Valeur retournée
La fonction retourne 0 si le processus s'est bien déroulé, -1 sinon.
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. Pour que ces paramètres soient pris en compte par le programme A2mToHtml(), il faut appeler la fonction A2mHtmlReadIni(filename) avant de lancer la fonction d'interprétation et d'impression.
#include <s_a2m.h>
A2mHtmlReadIni("myfile.ini");
A2mToHtml("myfile", "test.htm", 0);
Variables globales
Les variables globales décrites dans le fichier .ini peuvent également être modifiées dans le programme.
Variables influençant la lecture du fichier
Ces variables sont définies dans la secion [A2M] du fichier ini.
- int A2M_ESCCH = caractère d'escape (enrichissements et caractères spéciaux) : '\'par défaut
- int A2M_CMDCH = caractère de commande ('.' par défaut) spéciaux)
- int A2M_DEFCH = caractère préfixant les macros ('&' par défaut)
- int A2M_SEPCH = caractère de séparation des cellules ('&' par défaut)
- int A2M_LFON = conserve les linefeed (1) ou non (0)
- int A2M_BLON = conserve les blancs (1) ou non (0)
- char A2M_CURTAG[41] = paragraphe par défaut ("par_0")
Variables influençant le fichier généré
Ces variables sont définies dans la section [HTML] du fichier .ini.
- int A2M_FONTSIZE = taille par défaut des caractères dans les paragraphes (10 pts par défaut)
- int A2M_FONTINCR = incrément de taille de caractères (2 par défaut)
- int A2M_TFONTSIZE = taille par défaut des caractères dans les tableaux (8 pts par défaut)
- int A2M_FONTFAMILY = police de caractère par défaut ('H', 'T' ou 'C')
- int A2M_TSHADING_COL[2] = couleurs de la brosse de hachurage des titres([0]) et corps([1]) des tableaux
- 0 = noir
- 1 = blanc
- 2 = rouge
- 3 = vert
- 4 = bleu
- 5 = cyan
- 6 = magenta
- 7 = jaune
- int A2M_TSHADING_BRUSH[2] = brosse de hachurage des titres([0]) et corps([1]) des tableaux
- 7 = 50%
- 6 = 25%
- 5 = 12%
- 4 = 6%
- 3 = 3%
- 0-2 = 0%
- int A2M_HTML_TCOLOR = 1 (dft) pour impression en couleur des tableaux, 0 en B/W
- int A2M_HTML_TBORDER = épaisseur des cadres des tableaux (1 par dft)
- U_ch *A2M_HTML_TITLE = titre du fichier html
- U_ch *A2M_HTML_BODY = contenu du tag <BODY> du fichier HTML
- int A2M_HTML_LTGT = 0 si les caractères < et > doivent apparaître comme tel en HTML (<) et non interprétés comme tag (on mettra 0 dans ce cas).
- int A2M_HTML_TTITLE = 1 pour inclure le titre des tableaux dans le tableau
- int A2M_HTML_AUTOLINK = 0 pour supprimer la création automatique de liens par l'analyse des sujets d'aide (accélère le traitement)
Valeur retournée
- 0 en cas de succès
- -1 si le fichier ne peut être ouvert
- -2 si les fichiers output n'ont pu être créés
Voir également
A2mHtmlReadIni(), A2mToRtf(), A2mToMif(), A2mToMif(), A2mPrintError()
19.6.1 File s_a2mhtm.c
A2mGetModulePath(char *buf)
A2mHtmlReadIni(filename)
char *A2mOemToAnsi(fd, title)
A2mToHtml(a2mfile, outfile, wh)
A2mToHtmlStrip(a2mfile, outfile, strp, wh)
A2mGetModulePath (file s_a2mhtm.c:1630)
Syntax
A2mGetModulePath(char *buf)
A2mOemToAnsi (file s_a2mhtm.c:1604)
Syntax
char *A2mOemToAnsi(fd, title)
FILE *fd;
unsigned char *title;