Skip to content

Intersphinx loading error for the Plotly docs domain #14363

@sr-murthy

Description

@sr-murthy

Describe the bug

I am experiencing the following Intersphinx error related to the Plotly documentation domain:

Extension error (sphinx.ext.intersphinx._load)!

Versions
========

* Platform:         darwin; (macOS-26.3.1-arm64-arm-64bit)
* Python version:   3.11.15 (CPython)
* Sphinx version:   9.0.4
* Docutils version: 0.21.2
* Jinja2 version:   3.1.6
* Pygments version: 2.19.2

Last Messages
=============

None.

Loaded Extensions
=================

None.

Traceback
=========

      File "/Users/smurthy/Documents/srm/dev/vertex-env/lib/python3.11/site-packages/sphinx/events.py", line 452, in emit
        raise ExtensionError(
    sphinx.errors.ExtensionError: Handler <function load_mappings at 0x11e9867a0> for event 'builder-inited' threw an exception (exception: unknown or unsupported inventory version: ValueError('invalid inventory header: <!DOCTYPE html><html><head>'))

The Plotly domain mapping is defined in conf.py in the following way:

intersphinx_mapping = {
    ...
    'plotly': ('https://plotly.com/python-api-reference/', None),
    ...
}

There are other domains I reference, but the only one causing the error is the Plotly domain.

How to Reproduce

  1. Define the Plotly domain in the Intersphinx mappings in conf.py:
    intersphinx_mapping = {
        ...
        'plotly': ('https://plotly.com/python-api-reference/', None),
        ...
    }
  1. Try to build Sphinx locally using make:
make -C docs html

Environment Information

* Platform:         darwin; (macOS-26.3.1-arm64-arm-64bit)
* Python version:   3.11.15 (CPython)
* Sphinx version:   9.0.4
* Docutils version: 0.21.2
* Jinja2 version:   3.1.6
* Pygments version: 2.19.2

Sphinx extensions

`sphinx.ext.intersphinx`

Additional context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions