DOC: Section heading font sizes should be smaller in pydata-sphinx-theme #15112

Activity

1. pllim

   added

   Feature Request

   Docs

   on Aug 1, 2023
2. pllim commented on Oct 29, 2024

   

   pllim

   on Oct 29, 2024

   MemberAuthor

   More actions

   I think the default font sizes are here:

   https://github.com/pydata/pydata-sphinx-theme/blob/main/src/pydata_sphinx_theme/assets/styles/variables/_fonts.scss

   Particularly:

     // base font size - applied at body/html level
     --pst-font-size-base: 1rem;
   
     // heading font sizes based on a medium contrast type scale
     // - see: https://github.com/Quansight-Labs/czi-scientific-python-mgmt/issues/97#issuecomment-2310531483
     --pst-font-size-h1: 2.625rem;
     --pst-font-size-h2: 2.125rem;
     --pst-font-size-h3: 1.75rem;
     --pst-font-size-h4: 1.5rem;
     --pst-font-size-h5: 1.25rem;
     --pst-font-size-h6: 1rem;

   But, I don't see NumPy changing these at https://github.com/numpy/numpy/blob/main/doc/source/_static/numpy.css . What I noticed is that they used double # (https://raw.githubusercontent.com/numpy/numpy/refs/heads/main/doc/source/user/index.rst) heading level when we use double * level (https://raw.githubusercontent.com/astropy/astropy/refs/heads/main/docs/index_user_docs.rst) . Surprisingly, according to https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#sections , # is actually supposed to be larger than *. So maybe this from NumPy setting would help? 🤷‍♀️

   body {
     font-family: 'Open Sans', sans-serif;
     font-size: medium;
   }