Java News from Tuesday, February 20, 2007

I'm trying to figure out what it would take to generate modern markup from javadoc. Some parts are obvious, like removing table layouts and using XHTML instead of HTML. I can just TagSoup everything to fix malformed doc comments. That's all fairly easy, if tedious. The tricky part is getting rid of frames. I'd like to duplicate the typical framed layout including scroll bars by using CSS. So far, this is what I've got. It's almost there but not quite. For reasons I don't understand, the bottom left frame overflows the window rather than scrolling. If anyone can figure out how to fix this and let me know, I'd appreciate it.

I do know there's a lot of other ugly markup in this example left over from the original JavaDoc. The CSS also is pretty ugly because there's not enough white space on the margins and I've drawn borders everywhere to see what's going on. Don't worry about that. I know how to handle that. I'm just trying to straighten out the frames for the moment.

They're a few solutions I can't consider. JavaScript is out. So are server side templates of any kind. This has to all be static HTML that can be read from a local file system. It would also be very nice if the main content of the page could be the first div on the page rather than the last. That would improve accessibility for people using screen readers. However they'll probably choose the "no frames" version anyway so that's not a deal breaker. Any suggestions?