alabaster
alabaster copied to clipboard
Missing margin between items in newer Sphinx versions
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.
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.
(Maybe related: https://github.com/bitprophet/alabaster/issues/176)
Adding the following to _static/custom.css
seems to be short-term fix for now:
dl.py {
margin-bottom: 15px;
}
Thanks for the suggestion.