alabaster icon indicating copy to clipboard operation
alabaster copied to clipboard

Missing margin between items in newer Sphinx versions

Open petsuter opened this issue 3 years ago • 3 comments

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.

petsuter avatar Jul 20 '21 08:07 petsuter

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.

bitprophet avatar Jul 23 '21 18:07 bitprophet

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

petsuter avatar Feb 01 '22 15:02 petsuter

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

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

Thanks for the suggestion.

petsuter avatar Feb 01 '22 16:02 petsuter