executablebooks / sphinx-book-theme

A clean book theme for scientific explanations and documentation with Sphinx
https://sphinx-book-theme.readthedocs.io
BSD 3-Clause "New" or "Revised" License
431 stars 197 forks source link

Little visual difference between H1 and H2 headers #688

Closed choldgraf closed 1 year ago

choldgraf commented 1 year ago

Currently there's very little difference between H1, H2, and H3 headers. This is most important for H2 and H3 since they often make up the major parts of the page. In addition, the headers are only distinguishable by a larger font size which can make them blend in with the text a bit.

Here's an example of similar headers in other themes:

Furo:

image

Docusaurus:

image

Material mkdocs:

image

choldgraf commented 1 year ago

Have a slight tweak to the header CSS to try and address this in: