search

sphinx-doc / alabaster

Lightweight, configurable Sphinx theme
http://alabaster.readthedocs.io/
Other
723 stars 185 forks source link

Missing margin between items in newer Sphinx versions #181

Open petsuter opened 2 years ago

petsuter commented 2 years ago

Using the latest alabaster theme 0.7.12 and Sphinx 3.1.1 there seems to be no margin between items (classes, functions, etc.) at all, which looks quite confusing. Adding a margin would help a lot. Can I configure alabaster's margins somehow?

I noticed the demo websites all do have some margin between items, so I assume the lack of margin was unintended. It seems the demo websites all use the same version of alabaster theme (0.7.12) but a very old Sphinx version (1.6.7). So maybe the cause of the missing margins is a change in Sphinx? Is Sphinx 1.6.7 the only version of Sphinx tested with / supported by alabaster theme? Unfortunately Sphinx 1.6.7 is not working anymore. (Extensions are incompatible I guess.)

(I also tested Sphinx 3.5.4 and 4.1.1 but the margins between items are still missing with alabaster theme.)

Thanks.

bitprophet commented 2 years ago

I tend to use that sort of pretty old Sphinx myself which is why this hasn't popped up for me and my crop of sites. There's other tickets open for "omg get on newer Sphinx" so it's a known thing :(

FWIW every sphinx site can host custom CSS (it's in their docs somewhere, you'd be adding some new css file to _static/ IIRC) so this is technically fixable on a per deployment basis, even though I certainly don't want that to be the long term fix.

petsuter commented 2 years ago

(Maybe related: https://github.com/bitprophet/alabaster/issues/176)

petsuter commented 2 years ago

Adding the following to _static/custom.css seems to be short-term fix for now:

dl.py {
    margin-bottom: 15px;
}

Thanks for the suggestion.