SCR/AL1 - TOME III. Les librairies utilitaires
20. Le groupe s_html
20.20 HtmlSplit (file s_htmlsp.c:85)
Syntax
HtmlSplit(htmlfile, resfile, level, title, body, back, prevnext, verbose, style)
char *htmlfile, *resfile;
U_ch *title, *body, *back, *style;
int level, prevnext, verbose;
Description
Cette fonction balaie le fichier HTML htmlfile et le découpe sur base des tags <H*>. Les fichiers générés ont pour noms:
- resfile pour le fichier principal
- resfile1...n pour les fichiers secondaires
Par exemple si resfile vaut myres, on aura myres.htm, myres1.htm, etc.
Arguments
- htmlfile : nom du fichier à analyser
- resfile : racine des noms de fichiers extraits (sans extension)
- level : niveau Hn de découpe en sous-fichiers
- title : titre de chaque fichier HTML
- body : image background des fichiers extraits
- back : image de l'icône back précédant le titre
- prevnext : indique s'il faut une barre de navigation automatique
- verbose : affiche l'état d'avancement
- style : fichier contenant les styles à incorporer
A chaque <H*> rencontré de niveau inférieur ou égal à level, le fichier principal contient le texte du titre lié par un hyperlien au sous-fichier correspondant. Ce sous-fichier contient tout le texte entre les tags Hn de même niveau.
Les fichiers extraits sont des fichiers HTML avec:
- un titre si title est défini
- pour le tag Body, si body est défini, l'image correspondante en background, sinon le tag Body du fichier htmlfile
- les tags STARTHEADER et ENDHEADER
- si prevnext est non nul, des références vers le fichier précédent, le suivant et le fichier principal entre les tags STARTCMT et ENDCMT
- si title est défini, le titre précédé de l'image dont le nom se trouve dans back si back est défini, avec un hyperlien vers le fichier principal
- une ligne par titre de niveau inférieur avec hyperlien vers le fichier correspondant à chacun
- le titre du fichier courant (contenu du tag Hn qui a donné lieu à l'extraction
- le texte du fichier principal jusqu'au tag Hn suivant de même niveau
- les tags STARTFOOTER et ENDFOOTER
Dans les fichiers générés, chaque fois qu'un tag Hn est rencontré, il est automatiquement précédé d'un tag NAME, pour pourvoir être référencé avec plus de précision lors de l'extraction de la table des matières.
Les fichiers générés contiennent des tags spéciaux :
- !STARTHEADER ... !ENDHEADER en début de fichier
- !STARTCMT ... !ENDCMT en début de fichier
- !STARTFOOTER ... !ENDFOOTER en fin de fichier
Ces tags pourront par la suite servir d'indication au programme scr4_sbs ou à la fonction HtmlReplace().
Cette fonction est exploitée par l'utilitaire scr4_spl.
Valeur retournée
- 0 en cas de succès,
- -1 si le fichier resfile n'a pu être créé
- -2 si un des fichiers référencés n'a pû être ouvert
Voir également
HtmlToc(), HtmlReplace(), HtmlMessage()
20.20.1 File s_htmlsp.c
HtmlSplit(htmlfile, resfile, level, title, body, back, prevnext, verbose, style)