Re: [pgsql-www] Example indenting - Mailing list pgsql-docs

From Thom Brown
Subject Re: [pgsql-www] Example indenting
Date
Msg-id AANLkTi=sHkgUE3O72RSU7LVVnhYtwCMzDf8BJbzS=n2G@mail.gmail.com
Whole thread Raw
In response to Re: [pgsql-www] Example indenting  ("Erik Rijkers" <er@xs4all.nl>)
Responses Re: [pgsql-www] Example indenting  (Thom Brown <thom@linux.com>)
Re: [pgsql-www] Example indenting  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-docs
On 27 August 2010 20:23, Erik Rijkers <er@xs4all.nl> wrote:
>>>> http://www.flickr.com/photos/dark_ixion/4931878975/sizes/o/
>
> FWIW, I like the changes to the tables, but I do dislike both boxes *and* background-coloring of
> both <synopsis> and <screen> (=code examples).  To my eyes the changed font is enough for both
> <synopsis> and <screen>.
>
> OTOH, I mainly use the .pdf version of the documentation; and I suppose the changes so far are all
> CSS-only (i.e. no effect on the PDF)?
>
> sorry if I sound negative...
>

I don't think it will have any bearing on the PDF.

Okay, I've made some more changes, and hopefully they're a bit more logical now.

blue boxes - definitions
grey boxes - examples, output etc
red boxes - warnings, cautions
yellow boxes - notes

The yellow and red ones don't often occur, and the reason why I keep
providing screenshots of the same page is because it's the only page
in the documentation which contains one of each type of element.

So here's the updated one:
http://www.flickr.com/photos/dark_ixion/4935126375/sizes/o/

Unfortunately the tool I'm using to grab the whole page screenshot
uses jpeg compression, but saves as PNG, which I then reduce the
palette on to shrink the file size, so the colours are a bit off and
the text looks a bit fuzzy.

Are the boxes really that distracting?  How about if I remove the
border and just have a light background?  The problem with relying on
font difference is that it's not the same on every platform, hence why
this all started.

--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935

pgsql-docs by date:

Previous
From: Thom Brown
Date:
Subject: Re: Doc fixes and improvements
Next
From: Thom Brown
Date:
Subject: Re: [pgsql-www] Example indenting