HTML chunks

Francis J. Lacoste francis.lacoste at Contre.COM
Thu Jan 24 18:19:22 CET 2002


On Wed, Jan 23, 2002 at 01:46:39PM +0100, Joost van Baal wrote:
> On Tue, Jan 22, 2002 at 03:42:19PM -0500, Francis J. Lacoste wrote:
> > 
> > The user manual is getting larger and larger. I propose that we format
> > it using multiple HTML files (the chunk.xsl stylesheet). I also propose
> > that we use that stylesheet for all other HTML documentation (faq,
> > roadmap, dev-manual, etc.)
> 
> Sounds fine to me.

Done.

> 
> > There will be the problem of the .txt
> > documentation (it was created by running lynx -dump on the HTML file). I
> > propose we just drop the .txt documentation.
> 
> Hmm...  I like reading txt docs.  Is it a realy big pita to run lynx -dump
> on all chunks?

Ok, since actually at least one person is using those files, I made the
changes to still support text documentation (still in one file, which I'm 
sure is more convenient).

> 
> > Now that reports can be subdivided into section (using the =section
> > directive), I think that HTML output (for lr_xml2html) should always be
> > a tar file with multiple HTML files in it (instead of the single HTML
> > file). This way, there wouldn't be any difference between the HTML with
> > images and HTML without images output format.
> 
> Fine too.
> 
> > Any other ideas?
> 
> Perhaps use cvs-hibou/hibou/doc/foundation/print.dsl for .ps and .pdf,
> for better look?


I'll put that in doc/BUGS as a wishlist item.

-- 
Francis J. Lacoste
francis at Contre.COM
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 232 bytes
Desc: not available
Url : http://lists.logreport.org/pipermail/development/attachments/20020124/6abf002d/attachment.bin 


More information about the Development mailing list