[Mono-docs-list] XHtml provider, mono handbook provider
Lee Mallabone
mono-docs@fonicmonkey.net
28 May 2003 09:48:30 +0100
On Wed, 2003-05-28 at 02:47, Joshua Tauberer wrote:
>
> > one is a generic XHtml provider that works by looking at a table of
> > contents in an XML file, (which I gather from Johannes is standard
> > Microsoft "HTML Help" TOC format).
>
> Since the TOC format is MS HH specific and not really related to XHTML,
> maybe the provider should be called mshh instead. Alternatively, use
> XSL (he he, I'm obsessed) to transform the TOC file into something very
> generic first, and then supply that to the assembler so the XHTML
> provider isn't tied to an MS format.
The HH format *is* xhtml, so surely that makes it very related to xhtml?
:)
Given that the format is pretty general, easy to parse, and presumably
well documented, it doesn't seem wise to create another format for the
same purpose when a good one already exists...
It's possible we'll need two providers - one that parses the HH TOC and
reads the docs from that, and another that builds a TOC simply from
spidering documents. At the moment though, I think it's best to
concentrate on the HH-oriented version that fits well for the mono
handbook...
Regards,
Lee.