Re: [DOCS] Example indenting

On 23 August 2010 15:37, Magnus Hagander <magnus@hagander.net> wrote:
> On Mon, Aug 23, 2010 at 16:33, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> 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.
>
> Not having dug into any details, but it seems that example is tagged
> with CSS class PROGRAMLISTING - which isn't included anywhere in the
> main site CSS. Whereas on the developer site, tehre is a rule for it
> that gives margin-left: 4ex. Probably worth experimenting with that
> one.
>

Yes the following style is present in the dev docs, but not the www docs:

pre.LITERALLAYOUT,
.SCREEN,
.SYNOPSIS,
.PROGRAMLISTING
{
    margin-left:4ex;
}

So as Peter said, the stylesheet in use isn't the same as the dev
version.  Importing that one style into the www docs, it looks fine.

--
Thom Brown
Registered Linux user: #516935