From: Jonathan S. Katz <jkatz@postgresql.org>
To: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-docs@lists.postgresql.org
Subject: Re: Duplicating website's formatting in local doc builds
Date: Tue, 11 Feb 2020 13:59:10 -0500
Message-ID: <55d19d7d-2286-0136-0e88-b44cd0d6be61@postgresql.org> (raw)
In-Reply-To: <1375.1581446233@sss.pgh.pa.us>
References: <1375.1581446233@sss.pgh.pa.us>
On 2/11/20 1:37 PM, Tom Lane wrote:
> I'm wondering how to do $SUBJECT. The fine manual suggests
>
> make STYLE=website html
>
> but what I'm getting here with that is not a very close approximation
> of what I see at postgresql.org. It's closer than the default,
> but it's not the same font, margins, etc.
>
> I also wonder why duplicating the website's style isn't the default.
> Doesn't seem like having authors optimize for some other style is
> what we really want.
It looks like it's pulling from the wrong source[1]. It should be:
https://www.postgresql.org/dyncss/base.css
There are a few more dependencies now as well to get the Bootstrap
structure and the font:
https://www.postgresql.org/media/css/fontawesome.csshttps://www.postgresql.org/media/css/bootstrap.min.css
(And one for another font...which I see we should import the dependency on).
This should likely be a small quick change. I was going to try to say
"after the release" comment, but given I'm in both codebases at the
moment, I'll do a quick test and see how it looks.
(FWIW, I test the appearance a bit differently. I actually import built
documentation into my local copy of pgweb and tinker from there, as I'll
have all the dependencies available. That likely is not a viable option
for most people working on the documentation [unless we make it easier
to get pgweb up and running]).
Jonathan
[1]
https://git.postgresql.org/gitweb/?p=postgresql.git;a=blob;f=doc/src/sgml/stylesheet.xsl;hb=HEAD#l26Attachments:
signature.asc (application/pgp-signature, 832B) download
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: jkatz@postgresql.org, tgl@sss.pgh.pa.us, pgsql-docs@lists.postgresql.org
Subject: Re: Duplicating website's formatting in local doc builds
In-Reply-To: <55d19d7d-2286-0136-0e88-b44cd0d6be61@postgresql.org>
* 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