Sphinxcontrib-bibtex

----------------------

-------------------------

* Add setuptools as a runtime dependency on Python 3.12. This works around
an issue with the latest release of pybtex not working on Python 3.12
otherwise. See issue 345.

* Migrate setup.py to pyproject.toml. This fixes a ``namespace_packages``
warning on setuptools. See issue 350.

-----------------------

* Fix bibliography header repetition when recompiling documents
(reported by ragonneau, see issue 342 and pull request 343).

----------------------

* The ``:cite:alp:`` role in the super style now also suppresses the sup tag
in addition to the brackets, to make it easier to apply the necessary formatting
around the citation.

----------------------

* Pre- and post-text in citations are now supported for the
author_year, label, and super referencing styles. The syntax is
``:cite:p:`{pre-text}key{post-text} (requested by RobertoBagnara,
see issue 288 and pull request 316).
Refer to the documentation for more details.

* New alternative style citations are now supported for the
author_year, label, and super parenthetical referencing styles,
which are identical to parenthetical citations but without the brackets.
The syntax is
``:cite:alp:`key (requested by davidorme, see pull request 316).
Refer to the documentation for more details.

* Exclude docutils 0.18 and 0.19 to fix generation of a spurious div tag in the
html builder (see issues 330, 329, 323, 322, 309).

* Add test for running the extension on Cython modules (see issue 308).

* Add test for running the extension with autoapi (see issue 319).

* Sphinx versions 2.x (and lower) are no longer supported.
New minimum required version of Sphinx is 3.5.

* Running pytest without arguments will now by default skip all marked tests
that require additional dependencies (currently numpydoc, rinohtype, and
cython).

* Fix encoding issues when running tests on Windows.

* Python 3.6 is EOL and is therefore no longer officially supported.

----------------------

* Add support for the rinohtype builder (reported by brechtm, see issue 275).

* Migrate from ``pkg_resources`` to ``importlib.metadata``. A side effect of
this migration is that
**plugins registered at runtime are longer exposed as entry points**.
This is because ``importlib`` does not allow runtime modification of
entry points.

* Remove sphinxcontrib namespace ``__init__.py`` file (no longer needed for
Python 3.3+ by PEP420).

* Add support for docutils 0.18.

* Suppress LaTeX url commands in tooltips (see issue 305, reported by
1kastner).

* Document Markdown syntax for MyST (suggested by jacopok, see issue 310).