cvs commit: doc/share/misc docbook.css

[Giorgos Keramidas]

On Mon, 10 Nov 2008 10:02:06 +0000, Gavin Atkinson <gavin at FreeBSD.org> wrote:
>On Sun, 2008-11-09 at 22:37 +0200, Giorgos Keramidas wrote:
>>On Sun, 9 Nov 2008 20:25:07 +0100, Marc Fonvieille <blackend at freebsd.org> wrote:
>>> The new x-config.html is fine for me.
>>> For the new install-pre.html, the way <important></important> is
>>> rendered looks oldish, maybe using the same scheme as for
>>> <warning></warning> might do the trick.
>>
>> The bold red text is kind of `old school' for me too.  I'll wait to see
>> if there are flames^W^H err, objections about the rest and update the
>> <important> style too :)
>
> FWIW, I like the look of the new style sheet nore than the old one, but
> do agree with Marc about the new font used on <important> - I assume
> this is due to the removal of "font-family: arial;" from
> BLOCKQUOTE.IMPORTANT.

It's the line-height that makes things look funny.  How about something
that makes Important notes stand out a bit like this version?

  http://people.freebsd.org/~keramida/bsd-css/2008.11.10/install-pre.html

The changes to the `blockquote.IMPORTANT' class are:

  * Remove `color: red', `font-family: arial', `font-weight: bold' and
    the custom `line-height'.

  * Add a bit of padding to avoid bumping into any <blockquote> borders.

  * Add a red border with a thick left side that highlights the block.

This way the font family is the same as the rest of the text and it
doesn't look weird if your default sans-serif font is, say, DejaVu
instead of Arial :)

[ I'm undecided between making .IMPORTANT stand out with a red
background and this.  A red background seems like something that can
hurt my eyes if I stare at it for a long time.  This is _different_ that
the rest of the .NOTE, .EXAMPLE and so on. ]