From: Thomas Hurst Date: 2002-02-11T01:05:20+09:00 Subject: Re: Ruby Embedded Documentation * Dave Thomas (Dave@PragmaticProgrammer.com) wrote: > Thomas Hurst writes: > > > The HTML's a bit messy, with things like using tables+CSS to provide > > coloured backgrounds and section headers when a simple > > tag would do. > > I agree it's a mess. I know next to nothing about HTML, and I've been > hoping that people would contribute new templates that would fix these > problems. Rich Kilmer's template seems to be pretty popular: it's been > used on a number of published projects. Looking at that, it's even more old-style HTML 4 Transitional. > The weird combinations I ended up using where chosen simply to get > something to work across NS4.7, IE5/6, Konqueror, Opera, and Mozilla > (the browsers I have to hand). It seemed to me that whenever I > simplified something down, the output would get screwed up in one > environment or another. However, I'd welcome someone who knows HTML > and browsers producing new templates I could distribute. Well, I write pretty much everything in XHTML 1.1/CSS these days, and test in Opera 5/6, NS 4.7, IE6, Mozilla, Lynx, Links, W3M, and I'll probably try to get a aural browser working sometime. I am rather ruthless when it comes to sticking with clean implimenations though; if NS or so breaks (as it always does, *sigh*), I just hide the CSS behind an @import and let it get the simple layout. > In terms of generating non-frame output, I think you can do that with > templates right now. Hm, non frame, with file/class/method lists in sideboxes on each page? > What you _can't_ do now is have a single large output file for > everything: that'll probably come when I add XML support. I imagine you can write an XML template that uses entities/XLink even without that. -- Thomas 'Freaky' Hurst - freaky@aagh.net - http://www.aagh.net/ - Excellent day for drinking heavily. Spike the office water cooler.