Thread: Title updation while documentation is generated using STYLE=website

Hi,

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

Regards,
Vignesh

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