From: Erik Wienhold <ewie@ewie.name>
To: vignesh C <vignesh21@gmail.com>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: Title updation while documentation is generated using STYLE=website
Date: Wed, 25 Sep 2024 10:23:33 +0200
Message-ID: <a4cd9488-27cc-4829-ab90-9f3305c46f47@ewie.name> (raw)
In-Reply-To: <CALDaNm0=+mGKTtpWxG2Z+FQnJzAVRNoJNM+8f9MKf6FMQnV4rg@mail.gmail.com>
References: <CALDaNm0=+mGKTtpWxG2Z+FQnJzAVRNoJNM+8f9MKf6FMQnV4rg@mail.gmail.com>
On 2024-09-25 07:23 +0200, vignesh C wrote:
> While building the documentation with make STYLE=website html, I
> noticed inconsistencies in the formatting of the starting letter of
> each word in the titles. For instance:
> "Obtaining Information about an Error" becomes "Obtaining Information
> About An Error" in html/plpgsql-control-structures.html.
> "Multiple Statements in a Simple Query" changes to "Multiple
> Statements In A Simple Query" in html/protocol-flow.html.
> "Returning from a Function" remains unchanged in
> html/plpgsql-control-structures.html.
> "Obtaining Information about an Error" is also unchanged in
> html/plpgsql-control-structures.html.
> "RETURN NEXT and RETURN QUERY" changes to "RETURN NEXT And RETURN
> QUERY" in html/plpgsql-control-structures.html.
>
> There are many similar cases throughout the code.
>
> I believe this might be related to the stylesheet, as the original
> text appears intact when I copy the generated HTML and paste it into
> Notepad. I could not get details about this from [1].
> How is the styling being applied for the titles? Please share the link
> to this if it is available.
>
> [1] - https://www.postgresql.org/docs/current/docguide-build.html
I agree, it looks inconsistent.
The page loads stylesheet [1] which then loads [2]. See [3] for the
relevant rule. As I understand it, this is the stylesheet for the
entire postgresql.org website, not just the docs. I checked a couple of
non-docs pages but couldn't find any <h4> elements. So, not sure if the
text-transform property is even relevant to other pages.
[1] https://www.postgresql.org/media/css/docs-complete.css
[2] https://www.postgresql.org/media/css/main.css
[3] https://git.postgresql.org/gitweb/?p=pgweb.git;a=blob;f=media/css/main.css;h=cbfea862ed79fc338ee5712...
--
Erik
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: ewie@ewie.name, vignesh21@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Title updation while documentation is generated using STYLE=website
In-Reply-To: <a4cd9488-27cc-4829-ab90-9f3305c46f47@ewie.name>
* 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