Newest docutils (v0.17) breaks rendering #9061
Comments
|
Oops, I missed #9059 .. Closing this for now! |
|
This should fix the issue: #9053. |
- This also seems to break <ul> list items somehow - sphinx-doc/sphinx#9061
|
list items |
- Docutils==0.17 have some changes that break Sphinx rendering. Sphinx is working on it, but in the meantime we can fix some dependencies here until everything gets resolved. This will also fix everyone that depends on us. - This will be removed later, once most Sphinx installations get updated to handle it. - sphinx-doc/sphinx#9061 - I propose a release soon after this - Review: - General check - comment on release - comments on the general way we manage the requirements here?
|
@rkdarst I cannot reproduce the problem. Can you please create a new issue for this, ideally with example reST code and a screenshot? Please also specify which HTML theme you are using. |
|
You are right, I could only reproduce it in sphinx_rtd_theme, not the default Sphinx theme. I filed the issue here: readthedocs/sphinx_rtd_theme#1115 . Reproducing my issue can be found in that issue. I haven't dug deeper to see if there could be anything else to do in Sphinx itself, but browsing sphinx_rtd_theme's docs I don't see anything obvious. I guess there is possibility that each theme needs to update some things, but I know nothing about that so far. |
This will address the issues that the latest docutils release caused. I think thi si a good practice in general to make sure we have a defined range of docutils versions, given that they might change in the future. Having this defined will mean that 3.x versions of Sphinx will always work, even when docutils has advanced with additional backwards incompatible features. Refs sphinx-doc#9065 sphinx-doc#9063 sphinx-doc#9061 sphinx-doc#9051
This will address the issues that the latest docutils release caused. I think thi si a good practice in general to make sure we have a defined range of docutils versions, given that they might change in the future. Having this defined will mean that 3.x versions of Sphinx will always work, even when docutils has advanced with additional backwards incompatible features. Refs sphinx-doc#9065 sphinx-doc#9063 sphinx-doc#9061 sphinx-doc#9051
It seems the newest docutils has broken html rendering in a few places. I'm attaching screenshots showing the output of
make htmlwith 0.16 and comparing it to 0.17.Screenshots
Your project
https://github.com/kevinzakka/torchkit
Environment info
The text was updated successfully, but these errors were encountered: