Re: Style issues for conventions page

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Greg Smith <greg(at)2ndQuadrant(dot)com>
Cc: pgsql-www(at)postgresql(dot)org
Subject: Re: Style issues for conventions page
Date: 2013-05-29 16:46:59
Message-ID: 51A63103.7090405@gmx.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www

On 5/21/13 9:18 AM, Greg Smith wrote:
> A documentation comment came in that highlights a weird situation with
> the web version of the documentation. Check out
> http://www.postgresql.org/docs/current/static/notation.html for a
> moment. In the PDF documentation, this example looks just like it reads.
>
> There are a few problems with the web version though:
>
> -The word italics in "emphasized in italics" is actually bold. The
> source code for that is <emphasis>italics</>.
>
> -"emphasized in bold face (example)" shows an example that is neither
> bold or italics. Source for that one is (<emphasis
> role="bold"><literal>example</></>)
>
> I don't know that anything in the source needs to change, but something
> in the HTML generation pipeline seems off here.

This comes out "correctly" if you use the non-website stylesheets, but
the website has adopted different format conventions. It would probably
be best if we removed the first paragraph in the Conventions section,
because the potential for confusion in a CSS-like world is too big.

In response to

Responses

Browse pgsql-www by date

  From Date Subject
Next Message Alvaro Herrera 2013-05-29 17:01:55 Re: missing attachment in mails
Previous Message Cédric Villemain 2013-05-29 16:02:17 missing attachment in mails