RFC: modifying the doc CSS

Warren Block wblock at wonkity.com
Mon Jan 2 03:09:54 UTC 2012


Feedback welcome on some proposed modifications to the default DocBook 
CSS (/usr/doc/share/misc/docbook.css).

Samples for side-by-side comparison:

Existing: http://www.wonkity.com/~wblock/porters-handbook-orig/book.html
Proposed: http://www.wonkity.com/~wblock/porters-handbook/book.html

The proposed CSS:
http://www.wonkity.com/~wblock/porters-handbook/docbook.css


Changes:

Left-align table headers.

Add rounded border corners.

Fix uneven margin spacing on notes and other blockquotes.

Remove padding entries from various blockquotes.

Reduce "body blockquote" line-spacing: from 1.5 to 1.3 so lines 
don't look double-spaced.

Set line-height: 1.1 in programlistings so descenders have a 
little clearance.



More information about the freebsd-doc mailing list