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

Incompatible with sphinxcontrib-bibtex? #25

Closed
ianmkenney opened this issue Aug 22, 2023 · 7 comments
Closed

Incompatible with sphinxcontrib-bibtex? #25

ianmkenney opened this issue Aug 22, 2023 · 7 comments

Comments

@ianmkenney
Copy link
Member

When trying to use bibtex through the sphinxcontrib-bibtex extension, the previously rendered functions table failed to render.

Screenshot 2023-08-22 at 1 03 28 PM

For reference, here is a capture of a working version

image

It appears that the div containing the table (<div class="wy-table-responsive"><table class="autosummary longtable docutils align-default">...) is outside of the main content.

I see that in the example documentation for this repo that citations are included directly in the docstrings.

@ianmkenney
Copy link
Member Author

At the time of writing these defects can be found in the mdaencore docs

@lilyminium
Copy link
Member

Do you have an example of it working? I'm curious how the bibtex changes the formatting so much.

@ianmkenney
Copy link
Member Author

I haven't been able to get it to work, unfortunately.

@lilyminium
Copy link
Member

Sorry, I meant -- do you have an online example of the table getting rendered pre-bibtex?

@ianmkenney
Copy link
Member Author

Ah, I see. There isn't one 'online' right now, but you can look in the artifact from this run:

https://github.com/MDAnalysis/mdaencore/actions/runs/5941333766

@lilyminium
Copy link
Member

We should use the footbibliography directive to resolve this kind of thing: MDAnalysis/mdaencore#13

@lilyminium
Copy link
Member

Resolved by #26.

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

No branches or pull requests

2 participants