pydata / pydata-sphinx-theme

A clean, three-column Sphinx theme with Bootstrap for the PyData community
https://pydata-sphinx-theme.readthedocs.io
BSD 3-Clause "New" or "Revised" License
565 stars 304 forks source link

html_static_path doesn't look for css files relative to it #1679

Open rtedwards opened 6 months ago

rtedwards commented 6 months ago

Expected Behavior

The instructions from Custom CSS Stylesheets indicates that custom.css will be activated with the following setup

  1. Create a CSS stylesheet in _static/css/custom.css, and update the CSS rules as desired.
  2. Attach the stylesheet to your Sphinx build. Add the following to conf.py:
html_static_path = ['_static']

html_css_files = [
    'css/custom.css',
]

Actual Behavior

Custom style sheets are only activated when using the full path

html_static_path = ['_static']

html_css_files = [
    '_static/css/custom.css',
]