GenericMappingTools / gmt

The Generic Mapping Tools
https://www.generic-mapping-tools.org
Other
858 stars 359 forks source link

Broken formatting with docutils 0.17 #1176 #5097

Closed maxrjones closed 3 years ago

maxrjones commented 3 years ago

Description of the problem

Same issue as https://github.com/GenericMappingTools/pygmt/issues/1176, but more extensively affects the GMT documentation front page, in that the quicklinks section and toctree are both now formatted poorly:

image image
maxrjones commented 3 years ago

@seisman, do you know if there will be a new dropdown option for 6.2rc1 in the docs when the tag is made on GitHub? If so, I think we should pin docutils<0.17 soon rather than waiting for an upstream bug fix.

seisman commented 3 years ago

The dropdown option is manually added here https://github.com/GenericMappingTools/gmt/blob/888b1feb4c36becb5593d0091824916b59234b3c/doc/rst/_static/version_switch.js#L12, so it depends on if we want to have a 6.2rc1 dropdown or not.