Man Scilab

xmltohtml - converts xml Scilab help files to html

Calling Sequence

xmltohtml(dirs [,titles [,xsl [,step]]])

Parameters

• dirs : vector of strings: a set of directory paths for which html manuals are to be generated or []
• titles : vector of strings: titles associated to directory paths or []
• xsl : string, name of xsl file used for translation
• step : string, should be "whatis", "index", "html","contents", or "all"

Description

converts xml Scilab help files contained in a set of directories into html files.

In a first step ("whatis") a whatis.htm file is generated in each directory using information given in the "SHORT_DESCRIPTION" tag of each xml file and the given title.

In a second step ("index") the tags LINK are analysed, and xmltohtml tries to resolve the references using the already known help files defined in the %helps variable.

The third step ("html") it translates the xml file to html using external program xsltproc and the given xsl file which should be located in SCIDIR/man/LANGUAGE/ The generated html files are located together with the corresponding xml ones.

the last step ("contents") produces a contents.xml file

if dirs is [] then already defined help directories (see %helps(:,1) ) are assumed and titles are searched in %helps(:,2) . So xmltohtml([]) updates currents html files

See Also

help ,   help_skeleton ,  

Back