{"id":1722,"library":"sphinxcontrib-jquery","title":"sphinxcontrib-jquery","description":"sphinxcontrib-jquery is a Sphinx extension that provides jQuery for Sphinx projects running on versions 1.6 through 4.0. It was created to bridge a period where Sphinx core temporarily removed jQuery, ensuring compatibility for projects relying on it. The current version is 4.1.","status":"active","version":"4.1","language":"en","source_language":"en","source_url":"https://github.com/sphinx-contrib/jquery/","tags":["Sphinx","documentation","jQuery","extension","conf.py"],"install":[{"cmd":"pip install sphinxcontrib-jquery","lang":"bash","label":"Install library"}],"dependencies":[],"imports":[],"quickstart":{"code":"# conf.py\n\n# To enable the extension, add 'sphinxcontrib.jquery' to the extensions list\n# in your Sphinx project's conf.py file.\n\nextensions = [\n    'sphinx.ext.autodoc',\n    'sphinx.ext.napoleon',\n    'sphinxcontrib.jquery', # <--- Add this line\n    # ... other extensions\n]","lang":"python","description":"To enable the `sphinxcontrib-jquery` extension, add 'sphinxcontrib.jquery' to the `extensions` list within your Sphinx project's `conf.py` configuration file."},"warnings":[{"fix":"Remove 'sphinxcontrib.jquery' from your `extensions` list in `conf.py` if your project uses Sphinx 5.0 or a newer version.","message":"Using `sphinxcontrib-jquery` with Sphinx versions 5.0 and newer will cause conflicts or be redundant. From Sphinx 5.0 onwards, jQuery is re-bundled into Sphinx core, making this extension unnecessary and potentially problematic.","severity":"breaking","affected_versions":"Sphinx >= 5.0"},{"fix":"Ensure your Sphinx version is within the recommended range (1.6 to 4.0) if your project relies on this extension. For Sphinx versions outside this range, the extension might not provide its intended benefits or could cause issues.","message":"This extension is specifically designed for Sphinx versions between 1.6 and 4.0 (inclusive). Using it outside this range (e.g., with very old Sphinx versions < 1.6) may lead to unexpected behavior, errors, or a lack of desired functionality.","severity":"gotcha","affected_versions":"Sphinx < 1.6"}],"env_vars":null,"last_verified":"2026-04-09T00:00:00.000Z","next_check":"2026-07-08T00:00:00.000Z"}