Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing margin between items in newer Sphinx versions #181

Open
petsuter opened this issue Jul 20, 2021 · 3 comments
Open

Missing margin between items in newer Sphinx versions #181

petsuter opened this issue Jul 20, 2021 · 3 comments
Labels

Comments

@petsuter
Copy link

petsuter commented Jul 20, 2021

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
Copy link
Collaborator

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 bitprophet added the bug label Jul 23, 2021
@petsuter
Copy link
Author

petsuter commented Feb 1, 2022

(Maybe related: #176)

@petsuter
Copy link
Author

petsuter commented Feb 1, 2022

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

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

Thanks for the suggestion.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants