[Mono-list] Help needed with XSLT transformations(documentation browser)

Adam Treat manyoso@yahoo.com
Wed, 16 Oct 2002 03:27:47 -0400

On Wednesday 16 October 2002 02:23 am, Miguel de Icaza wrote:
> hello!
> > I'm curious, why are you going for a GtkHtml implementation? I would
> > have thought that a simple DHTML/CSS implementation would be much
> > simpler, more portable and have the added benefit that the docs
> > go-mono.com web page would be identical to those in the distribution. It
> > seems a little over the top to be implementing a documentation browser
> > when all you're doing is displaying web pages. Of course, search may be
> > a little tricky ;-)
> Oh, do not get me wrong.
> GtkHTML is just a lightweight HTML rendering engine that does not
> support CSS, so we need it to look decent for those of us that will be
> using the documentation in our day-to-day work on Linux.

Ouch. CSS is really necessary for good looking docs otherwise you get into 
complex html that will not be consistent across browsers.

> The Web-based interfaces lack the agility that you get from a native GUI
> tool to browse your documentation.

I think a html documentation is less cumbersome than a doc viewer and if you 
browse from the local drive it is just as fast.

IMHO, documentation in html format that can be used with a regular browser 
should be the first priority.

> I have no problems if we take later the scripts and generate a full
> documentation set that is web-browsable (in fact, it might just be part
> of the process), but we need a command-line and GUI tools that we can
> use natively on Linux when disconnected from the Web (and that has
> better interactions than a web page).
> Miguel