Extension to include jQuery on newer Sphinx releases
.. image:: https://img.shields.io/pypi/v/sphinxcontrib-jquery.svg :target: https://pypi.org/project/sphinxcontrib-jquery/ :alt: Package on PyPI
sphinxcontrib-jquery
ensures that jQuery is always installed for use in
Sphinx themes or extensions.
To use it, add sphinxcontrib.jquery
as a Sphinx extension:
.. code:: python
extensions = [ "sphinxcontrib.jquery", ] ...
.. As this is a README, we restrict the directives we use to those which GitHub
renders correctly. This means that we cannot use versionadded
,
confval
, warning
, or other similar directives.
We use a reStructuredText definition list to emulate the confval
rendering.
We use inline bold syntax as a poor-man's .. warning::
directive.
jquery_use_sri
A boolean value controlling whether to enable subresource integrity
_ (SRI)
checks for JavaScript files that this extension loads.
The default is False
.
Warning: Enabling SRI checks may break documentation when loaded from
local filesystem (file:///
URIs).
New in version 4.0.
.. _subresource integrity: https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity