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

SCR/AL1 - TOME III. Les librairies utilitaires

20. Le groupe s_html

20.18 HtmlToc (file s_htmltc.c:60)

Syntax

HtmlToc(htmlfile, resfile, maxlevel, target)
char    *htmlfile, *resfile, *target;
int     maxlevel;

Description

Cette fonction balaie un fichier HTML et les sous-fichiers référencés et génère une table des matières avec les références vers les sous-fichiers sur base des tags <Hn> (qui indiquent les niveaux de chapitres dans les fichiers HTML).

Le titre de chaque chapitre est repris avec le lien vers le sous-fichier et si un tag NAME est présent, vers la position dans ce sous-fichier.

• htmlfile = fichier input HTML
• resfile = fichier HTML contenant la Table des matières
• maxlevel = niveau de titre maximum pour la table des matières
• target = fenêtre target pour chaque topic
• Le fichier résultat n'est pas un fichier HTML complet dans la mesure où il est destiné à être par la suite intégré dans un fichier plus grand.

Le fichier débute par un tag spécial !STARTTOC et se termine par un autre: !ENDTOC. Ces deux tags pourront par la suite servir d'indication au programme scr4_sbs ou à la fonction HtmlReplace().

Le fichier résultat contient la table des matières dans le format suivant:

    <!STARTTOC>
    <UL><UL><LI><A HREF="exes1.htm">1. Introduction</A></LI>
    <UL><LI><A HREF="exes1.htm#TIT1">1.1. Les programmes</A></LI>
    <LI><A HREF="exes1.htm#TIT2">1.2. Outils de d&#233;veloppement</A></LI>
    </UL><LI><A HREF="exes2.htm">2. SCR4 : outils de prototypage</A></LI>
    ...
    </UL></UL></UL>
    <!ENDTOC>

Il est ensuite aisé de remplacer par le contenu de ce fichier une section préalablement créée dans un fichier html (par exemple à l'aide de la fonction HtmlReplace().

Cette fonction est exploitée par l'utilitaire scr4_toc.

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

HtmlSplit(), HtmlReplace(), HtmlMessage()

20.18.1 File s_htmltc.c

HtmlToc(htmlfile, resfile, maxlevel, target)