Re: [pgsql-www] Example indenting

From: Thom Brown <thom(at)linux(dot)com>
To: Erik Rijkers <er(at)xs4all(dot)nl>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: [pgsql-www] Example indenting
Date: 2010-08-28 19:53:24
Message-ID: AANLkTi=sHkgUE3O72RSU7LVVnhYtwCMzDf8BJbzS=n2G@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-www

On 27 August 2010 20:23, Erik Rijkers <er(at)xs4all(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Thom Brown 2010-08-28 20:08:59 Re: [pgsql-www] Example indenting
Previous Message Thom Brown 2010-08-28 19:09:53 Re: Doc fixes and improvements

Browse pgsql-www by date

  From Date Subject
Next Message Thom Brown 2010-08-28 20:08:59 Re: [pgsql-www] Example indenting
Previous Message Thom Brown 2010-08-28 19:09:53 Re: Doc fixes and improvements