From: Tom Lane <tgl@sss.pgh.pa.us>
To: Thom Brown <thom@linux.com>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Cc: pgsql-www@postgresql.org
Subject: Re: [DOCS] Example indenting
Date: Mon, 23 Aug 2010 10:33:13 -0400
Message-ID: <20502.1282573993@sss.pgh.pa.us> (raw)
In-Reply-To: <AANLkTin27ZKYu2tdqn5RZvTaCtuX11=sd_pj7tzoTJiY@mail.gmail.com>
References: <AANLkTinz1WZ28k_+7pinbVAs1N4UfLYrJ_Wj=f5k=rjH@mail.gmail.com>
<19595.1282570992@sss.pgh.pa.us>
<AANLkTin27ZKYu2tdqn5RZvTaCtuX11=sd_pj7tzoTJiY@mail.gmail.com>
Thom Brown <thom@linux.com> writes:
> On 23 August 2010 14:43, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> Hm, both pages render acceptably for me in Safari --- it's true that the
>> examples aren't inset relative to the text on the main-docs site, but
>> I don't see anything "messed up" beyond that. What browser are you
>> using? Could you post a screenshot of what you see?
> By "mess" I mean examples aren't sufficiently distinct from paragraph
> text. There's nothing actually malformed. It's more of a styling
> issue from my perspective.
Ah, I see. It looks like you are using a monospaced font that is
visually very similar to your regular text font, and so with neither
a font difference or insetting, there's indeed not a lot to distinguish
example from text. On my display the two fonts are a bit more visually
distinct so it's more readable. (Checks preferences ... I've got Safari
set to Times 16 for "standard font" and Courier 13 for "fixed-width
font", though I'm not sure whether the PG docs pages make use of those
selections.)
Anyway, that was a red herring, and the question remains why the
examples are rendered without insetting on the main docs pages.
Was that intentional? I can see that it might be because the text
is already inset from the window edge more than it is on the devel site,
and so insetting the examples even more might result in page width
problems. Maybe the problem is not so much that we want to indent the
examples more as that the text needs to be indented less.
regards, tom lane
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, thom@linux.com, pgsql-www@postgresql.org
Subject: Re: [DOCS] Example indenting
In-Reply-To: <20502.1282573993@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox