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

Support sphinx 8 #124

Open
jtpio opened this issue Aug 14, 2024 · 0 comments
Open

Support sphinx 8 #124

jtpio opened this issue Aug 14, 2024 · 0 comments
Labels
documentation Improvements or additions to documentation

Comments

@jtpio
Copy link
Member

jtpio commented Aug 14, 2024

The latest Sphinx 8 seems to be causing issues for the docs build, as seen in #123.

https://readthedocs.org/projects/voici/builds/25309076/

Running Sphinx v8.0.2
loading translations [en]... done
making output directory... done
Converting `source_suffix = '.md'` to `source_suffix = {'.md': 'restructuredtext'}`.
ERROR: Invalid value `None` in intersphinx_mapping['https://docs.python.org/']. Expected a two-element tuple or list.

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/voici/conda/123/lib/python3.12/site-packages/sphinx/cmd/build.py", line 332, in build_main
    app = Sphinx(args.sourcedir, args.confdir, args.outputdir,
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/docs/checkouts/readthedocs.org/user_builds/voici/conda/123/lib/python3.12/site-packages/sphinx/application.py", line 277, in __init__
    self.events.emit('config-inited', self.config)
  File "/home/docs/checkouts/readthedocs.org/user_builds/voici/conda/123/lib/python3.12/site-packages/sphinx/events.py", line 100, in emit
    results.append(listener.handler(self.app, *args))
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/docs/checkouts/readthedocs.org/user_builds/voici/conda/123/lib/python3.12/site-packages/sphinx/ext/intersphinx/_load.py", line 127, in validate_intersphinx_mapping
    raise ConfigError(msg)
sphinx.errors.ConfigError: Invalid `intersphinx_mapping` configuration (1 error).

Configuration error:
Invalid `intersphinx_mapping` configuration (1 error).

#123 pinned to sphinx<8 for now, but we should look into supporting the latest version.

@jtpio jtpio added the documentation Improvements or additions to documentation label Aug 14, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant