Preview of XHTML, CSS style-able Haddock output

[Thomas Schilling]

So here's my preliminary stylesheet that matches the new haskell wiki
style.  It doesn't work with multi-paragraph docs, yet, but I thought
I'd give you a preview.

I'll try to build the latest haddock and test it on existing docs.

/Thomas

On 19 July 2010 09:34, Simon Marlow <marlowsd at gmail.com> wrote:
> On 19/07/2010 08:22, Mark Lentczner wrote:
>> Friends -
>>
>> Take a gander at:
>>
>> http://www.ozonehouse.com/mark/snap-xhtml/index.html  -single page
>> version- or   http://www.ozonehouse.com/mark/snap-xhtml/frames.html
>> -frame version-
>>
>> Notice the style switcher menu on the top right... :-) Now poke
>> around those pages...
>>
>> I've completely revamped the backend over the last few months and now
>> it produces 100% validating XHTML with "semantic markup". All styling
>> is done in the CSS. This makes the pages smaller, style-able, and
>> quite a bit more scrape-able.
>>
>> For the Tibbe and Snappy themes, I cribbed from Johan's example page
>> in Trac #108, and from the Snap web site. You should be able to
>> easily grab the css and see how they are put together and start
>> playing with them or a create a new theme if you want.
>>
>> Looking forward to finding out what you think.
>
> I think the semantic markup approach is wonderful.  Some thoughts about
> the styles themselves:
>
>  - like the smaller fonts in Tibbe, but I prefer to use
>    monospaced font for code
>
>  - like the contents from Tibbe
>
>  - Tibbe: underlining links in code is too busy, and where
>    they aren't underlined the blue is too bright
>
>  - Both: hide the synoposis by default
>
>  - Tibbe: I like the outlined code blocks, but would prefer
>    the type signatures etc. to have a different-coloured background,
>    I think it helps to visually grok the page more quickly.
>
>  - Snappy: section headings don't stand out quite as much as Tibbe
>
>  - Snappy: don't like the font used for text: too bold and too serify.
>
>  - Snappy: like the narrower page width.
>
>  - Snappy: text in the header is too big and bold
>
>  - Snappy: grey box around type signatures seems slightly too tall.
>
> Cheers,
>        Simon
>
> _______________________________________________
> Haddock mailing list
> Haddock at projects.haskell.org
> http://projects.haskell.org/cgi-bin/mailman/listinfo/haddock
>



-- 
If it looks like a duck, and quacks like a duck, we have at least to
consider the possibility that we have a small aquatic bird of the
family Anatidae on our hands.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: hslogo-16.png
Type: image/png
Size: 1684 bytes
Desc: not available
Url : http://projects.haskell.org/pipermail/haddock/attachments/20100719/f5ff7783/attachment.png 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: nhaddock.css
Type: text/css
Size: 5298 bytes
Desc: not available
Url : http://projects.haskell.org/pipermail/haddock/attachments/20100719/f5ff7783/attachment.css