ingo wrote:
> 
> The ideal would be if every patcher used docbook and has the tools
> needed for processing it. But simple HTML will do fine, maybe with an
> extra tag or two for indexing keywords.
> 
> [...]
> 
> HTML template (the povdoc could be the role model here), a guideline and
> some scripts or tools to process the files.
> 

That would be more than i suggested, it would involve processing all the
files to create the final documents.  Having a separate 'source version'
of the texts would also mean that if i want to 'recompile' it i have to
get the source first. I'm not sure if a keyword index would be really
necessary.

> Speaking of tools, here is an interesting one. It takes a set of HTML
> files as input and returns one HTML file as output with an index based
> on the H-tags (tried it with the povdoc and works fine). You can also
> generate PDF and PS with it. Available for several platforms.
> 
> http://www.easysw.com/htmldoc/

The toc.html file it generates is about what i considered, it just does
not work well when the different files do not all use the same level
structure, but this should not be a problem when the guidelines are
obeyed.  


Christoph

-- 
POV-Ray tutorials, IsoWood include,                 
TransSkin and more: http://www.tu-bs.de/~y0013390/  
Last updated 14 Apr. 2002 _____./\/^>_*_<^\/\.______

Post a reply to this message