Date: Wed, 25 Sep 2024 10:23:33 +0200
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
Message-ID: <a4cd9488-27cc-4829-ab90-9f3305c46f47@ewie.name>
References: 
 <CALDaNm0=+mGKTtpWxG2Z+FQnJzAVRNoJNM+8f9MKf6FMQnV4rg@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: 
 <CALDaNm0=+mGKTtpWxG2Z+FQnJzAVRNoJNM+8f9MKf6FMQnV4rg@mail.gmail.com>
Archived-At: 
 <https://www.postgresql.org/message-id/a4cd9488-27cc-4829-ab90-9f3305c46f47%40ewie.name>
Precedence: bulk

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=cbfea862ed79fc338ee571265c28626dc38765ca;hb=HEAD#l301

-- 
Erik