[darcs-users] darcs patch: Make index.html XHTML 1.0 Strict

[Max Battcher]

On 5/16/2009 7:30, Trent W. Buck wrote:
> I dropped a copy at http://code.haskell.org/~twb/tmp/{before,after}.html
> if people with other engines want to compare them.

For the most part it looks good. I don't really care strongly for the 
max-width and would be fine with letting the document flow to the 
browser window, perhaps with a nice margin/padding, but that's something 
we can debate later and isn't a big deal.

I would add a little bit of styling to the DL's DT, DD, because, 
frankly, the defaults are generally terribly unreadable in most 
graphical browsers (not enough white space, not enough emphasis to the 
terms).  At the very least I would add to the style sheet:

dt { color: #494a82; font-weight: bold; }

I think it is also a good idea to add a larger margin around the 
elements, as well, preferably by wrapping the DD contents in Paragraph 
tags or possibly just adding to the style sheet:

dd { margin-top: 0.5em; margin-bottom: 0.5em; }

The only other issue that I see, is that for some reason both browsers 
I'm looking at (Firefox 3.0 and IE8) seem unhappy with the "spontaneous 
branches" link, and I'm not sure why (it certainly is acceptable XHTML). 
In IE8 the link and following text appear to wind up in their own 
separate DD. In Firefox it is worse and the link and following text 
appear to be in a separate paragraph altogether (losing the indentation 
of the previous DD).

I've tried playing with it, but can't get it to work. Perhaps it's a 
known quirk of XHTML strict (I've only ever claimed Transitional on my 
own documents) and maybe there is a reason that both browsers are 
showing such unusual behavior.

Rewriting it to something like:

<dd><p>Originally developed by physicist David Roundy, darcs is
       based on a unique algebra of patches.  This smartness lets you
       respond to changing demands in ways that would otherwise not be
       possible.</p>
       <p><a
 
href="http://wiki.darcs.net/DarcsWiki/SpontaneousBranches">Spontaneous
       branches</a> are a good example of using the pattern matching
       and cherry picking abilities of darcs.</p></dd>

That at least looks well in IE8, but is still odd in Firefox because the 
second paragraph is still losing its indentation from the DD. I'm going 
to give up for now; hooray for 'standards'. It's odd, though, that both 
Firefox and IE seem to agree that links imply line breaks in a DD in 
XHTML strict.

--
--Max Battcher--
http://worldmaker.net