<#GAPDoc Label="GAPDoc2HTML"> record containing HTML files as strings and other information The argument tree for this function is a tree describing a &GAPDoc; XML document as returned by (probably also checked with ). This function produces an HTML version of the document which can be read with any Web-browser and also used with &GAP;'s online help (see ). It includes title page, bibliography, and index. The bibliography is made from &BibTeX; databases. Their location must be given with the argument bibpath (as string or directory object). If the third argument gaproot is given and is a string then this string is interpreted as relative path to &GAP;'s root directory. Reference-URLs to external HTML-books which begin with the &GAP; root path are then rewritten to start with the given relative path. This makes the HTML-documentation portable provided a package is installed in some standard location below the &GAP; root.

The output is a record with one component for each chapter (with names "0", "1", ..., "Bib", and "Ind"). Each such component is also a record with components The HTML code produced with this converter conforms to the W3C specification HTML 4.01 strict, see http://www.w3.org/TR/html401. This means in particular that the code doesn't contain any explicit font or color information. The layout information for a browser should be specified in a cascading style sheet (CSS) file. The &GAPDoc; package contains an example of such a style sheet, see the file gapdoc.css in the root directory of the package. This file conforms to the W3C specification CSS 2.0, see http://www.w3.org/TR/REC-CSS2. You may just copy that file as manual.css into the directory which contains the HTML version of your documentation. But, of course, you are free to adjust it for your package, e.g., change colors or other layout details, add a background image, ... Each of the HTML files produced by the converters contains a link to this local style sheet file called manual.css. text the text of an HTML file containing the whole chapter (as a string) ssnr list of subsection numbers in this chapter (like [3, 2, 1] for chapter 3, section 2, subsection 1) The result can be written into files with the command .

Mathematical formulae are handled as in the text converter . We don't want to assume that the browser can use symbol fonts. Some &GAP; users like to browse the online help with lynx, see , which runs inside the same terminal windows as &GAP;. <#/GAPDoc>