Re: [pgsql-www] Small issue in online devel documentation build

From: Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>
To: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
Cc: Magnus Hagander <magnus(at)hagander(dot)net>, Robert Haas <robertmhaas(at)gmail(dot)com>, PostgreSQL Developers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: [pgsql-www] Small issue in online devel documentation build
Date: 2017-03-04 07:00:56
Message-ID: alpine.DEB.2.20.1703040748470.30598@lancre
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers pgsql-www


Hello Peter,

> I think what you are looking at is the web site stylesheet.

Yep.

> The whole thing looks fine to me using the default stylesheet. On the
> web site, it looks wrong to me too. I don't know what the rationale for
> using 1.3em for <code> is, but apparently it's not working correctly.

Indeed. The idea of relative size is to be able to adjust the size for the
whole page and have everything scale accordingly... however this mostly
works well with text, but not with images. It seems that the trend is now
to specify absolute size, and to let the browser do whole page scaling as
required by the user.

> We could perhaps consider which markup style is better, but the problem
> is that it's hard to enforce either way going forward. So we need to
> find the root of the problem.

The root of the problem is the combination of relative size & nesting, so
one or the other has to be removed:

(1) don't nest in the input (patch I sent)
(2) don't use relative sizes (update the web site CSS)

Otherwise there are workarounds:

(3) CSS work around "code code { font-size: 100% !important; }"
(4) unnest code in the output by some postprocessing or some more
clever transformation.

--
Fabien.

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Robert Haas 2017-03-04 07:03:32 Re: multivariate statistics (v24)
Previous Message Robert Haas 2017-03-04 06:58:49 Re: PATCH: Make pg_stop_backup() archive wait optional

Browse pgsql-www by date

  From Date Subject
Next Message Peter van Hardenberg 2017-03-05 17:32:27 Edit privs on the wiki please
Previous Message Peter Eisentraut 2017-03-04 03:00:11 Re: [pgsql-www] Small issue in online devel documentation build