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

citation lists are misaligned #1411

Open
cissou8 opened this issue Jan 13, 2023 · 3 comments
Open

citation lists are misaligned #1411

cissou8 opened this issue Jan 13, 2023 · 3 comments
Labels
Accepted Accepted issue on our roadmap Bug A bug

Comments

@cissou8
Copy link

cissou8 commented Jan 13, 2023

Problem

Citation lists are not aligned.

Reproducible Project

See for instance: https://siril.readthedocs.io/en/latest/processing/deconvolution.html#references
Citations are inserted in the body of the document as [paperref]_ and a list to gather them all at the end of the page as:

.. [paperref] Authors, paper title, etc...

.. [paperref2] Authors, paper title, etc...

Error Logs/Results

As rendered now:
sphinx 6.0.0, rtd-theme 1.2.0rc2
image

Expected Results

As rendered with sphinx 5.3.0, rtd-theme 1.1.0
image

Do not hesitate if you want me to test further,

Thx,

C.

@cissou8 cissou8 added Bug A bug Needed: replication Bug replication is required labels Jan 13, 2023
@benjaoming
Copy link
Contributor

Thanks for posting this issue. It's definitely valid, so let's keep it around to track it and identify a solution.

The problem was introduced because of docutils 0.18 which is the lowest supported version in Sphinx 6. Basically, the new DOM structure that is created by docutils 0.18 is very challenging to support with a nice table as the former.

You can see how many hard efforts unfolded here: #1381

@benjaoming benjaoming added Accepted Accepted issue on our roadmap and removed Needed: replication Bug replication is required labels Jan 13, 2023
@cissou8
Copy link
Author

cissou8 commented Jan 13, 2023

Indeed, didn't search thoroughly enough throughout the tickets! Think I searched only the opened ones.
Sorry I can't help much with CSS/html as most of it feels like pure magic to me, but happy to test whenever needed!

@benjaoming
Copy link
Contributor

@cissou8 I have to say that the CSS required for displaying changes in docutils 0.18 are quite advanced and the work done by @agjohnson is already quite substantial. I'm not sure if there is a quick way to fix this.

thibgc added a commit to lockss/lockss-rtd-manual that referenced this issue Feb 9, 2023
…tc.) and renders our footnotes with code-block wrong (and maybe other problems). Force sphinx<6, docutils<0.18 for now. See readthedocs/sphinx_rtd_theme#1411.
thibgc added a commit to lockss/lockss-rtd-manual that referenced this issue Feb 9, 2023
… grid, etc.) and renders our footnotes with code-block wrong (and maybe other problems). Force sphinx<6, docutils<0.18 for now. See readthedocs/sphinx_rtd_theme#1411."

This reverts commit 4c7a06a.
thibgc added a commit to lockss/lockss-rtd-manual that referenced this issue Feb 9, 2023
…tc.) and renders our footnotes with code-block wrong (and maybe other problems). Force sphinx<6, docutils<0.18 for now. See readthedocs/sphinx_rtd_theme#1411.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Accepted Accepted issue on our roadmap Bug A bug
Projects
None yet
Development

No branches or pull requests

2 participants