Re: Duplicating website's formatting in local doc builds - Mailing list pgsql-docs

From Tom Lane
Subject Re: Duplicating website's formatting in local doc builds
Date
Msg-id 17445.1581731499@sss.pgh.pa.us
Whole thread Raw
In response to Re: Duplicating website's formatting in local doc builds  ("Jonathan S. Katz" <jkatz@postgresql.org>)
Responses Re: Duplicating website's formatting in local doc builds  (Peter Geoghegan <pg@bowt.ie>)
List pgsql-docs
"Jonathan S. Katz" <jkatz@postgresql.org> writes:
> A potential solution is that we drop the use of "monospace" in relying
> on the OS default and just pick a font. I would say that this is outside
> the scope of the patch that's being proposed, but certainly something to
> look into on the pgweb side given we're creating an inconsistent
> cross-browser experience.

Agreed, not in-scope for this patch.

>> The point about network access seems to me to be sufficient reason not
>> to make it the default.  I'd actually say that we ought to annotate
>> section J.3.1 to point out that "make STYLE=website" will result in
>> that.  However, I'm not quite clear on whether that means external
>> access during viewing, or during build, or both?  The note should say.

> It would only be during viewing -- the build just puts the URL into the
> HTML file.

OK.

> But don't take my word for it, please see the attached patch ;)

Hm, I wouldn't go into that much detail; it'd likely soon be out of
date anyway.  I had in mind something more like "If the STYLE=website
option is used, the generated HTML files will include references to
stylesheets hosted at www.postgresql.org, so that viewing them will
require network access."

            regards, tom lane



pgsql-docs by date:

Previous
From: "Jonathan S. Katz"
Date:
Subject: Re: Duplicating website's formatting in local doc builds
Next
From: Peter Geoghegan
Date:
Subject: Re: Duplicating website's formatting in local doc builds