Skip to content

Upgrade Sphinx, myst-parser and docutils #104

@jpmckinney

Description

@jpmckinney

ocds-extensions-translations seems able to use the latest versions; it was last updated to Sphinx 8.0.2 (8.2.3 is latest), docutils 0.21.2 (latest) and myst-parser 4.0.0 (4.0.1 is latest).

Based on last time #71, we might need to:

  • Add jQuery to standard_theme https://www.sphinx-doc.org/en/master/changes.html#id197
  • Test if can remove comment suppress_warnings in standard/docs/conf.py
  • Check that Sphinx extensions still work, especially if ours or ODS' (run pytest tests with latest versions)
  • Test JavaScript behaviors:
    • standard script.js
    • infrastructure json-example-format.js (same as last part of standard script.js)
    • standard_theme theme.js search.js
    • public-private-partnerships show-shower.js
  • Test ocds-index with latest versions

Last time we had to update some non-documentation projects (e.g. removing :widths: auto last time), but docutils has very limited HTML changes, this time.

Noting that this bug still exists:

Would need to update translation logic in standard_theme, but Sphinx has a bug anyway sphinx-doc/sphinx#11008

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions