Skip to content

Abbreviate long author lists with et al. in BibTeX bibliographies for Sphinx

License

Notifications You must be signed in to change notification settings

ComPWA/sphinx-pybtex-etal-style

Repository files navigation

sphinx-pybtex-etal-style

PyPI package Supported Python versions BSD 3-Clause license Open in Visual Studio Code CI status Checked with mypy pre-commit.ci status Spelling checked code style: prettier Ruff uv

This Sphinx extension defines a new bibliography style for the sphinxcontrib-bibtex extension. Install through PyPI with pip:

pip install sphinx-pybtex-etal-style

Next, in your Sphinx configuration file (conf.py), add "sphinx_pybtex_etal_style" to your extensions:

extensions = [
    "sphinx_pybtex_etal_style",
]

and set your default bibliography style to "unsrt_et_al":

bibtex_default_style = "unsrt_et_al"

Alternatively, you can use the style for one bibliography only by specifying it in the .. bibliography:: directive:

.. bibliography:: /references.bib
  :style: unsrt_et_al

Book entries that have an ISBN get a link to the book entry on bookfinder.com. If you want to use isbnsearch.org instead, add the following to your conf.py:

unsrt_etal_isbn_resolver = "isbnsearch"