sphinxcontrib-bibtex-urn¶

A Sphinx plugin that extends sphinxcontrib-bibtex with support for URN identifiers (specifically National Bibliography Numbers).

BibTeX entries containing a urn field are rendered with a hyperlinked identifier, similar to how doi fields work:

[Sav23] Niko Savola. Design and modelling of long-coherence qubits using energy participation ratios. Master’s thesis, Aalto University, May 2023. URN:NBN:fi:aalto-202305213270.

where URN:NBN:fi:aalto-202305213270 is a clickable link pointing to https://urn.fi/URN:NBN:fi:aalto-202305213270.

Features¶

Country-specific NBNs: Resolution for National Bibliography Numbers for:
- 🇦🇹 Austria (resolver.obvsg.at)
- 🇭🇷 Croatia (urn.nsk.hr)
- 🇨🇿 Czech Republic (resolver.nkp.cz)
- 🇫🇮 Finland (urn.fi)
- 🇭🇺 Hungary (nbn.urn.hu)
- 🇮🇹 Italy (nbn.depositolegale.it)
- 🇳🇱 Netherlands (persistent-identifier.nl)
- 🇳🇴 Norway (nb.no)
- 🇸🇮 Slovenia (nbn.si)
- 🇸🇪 Sweden (urn.kb.se)
Global NBNs: Other URN:NBN:... identifiers resolved via nbn-resolving.org.
Auto-deduplication: Automatically suppresses redundant url fields that point to the same URN resolver.
Any pybtex style: Works with all built-in and third-party pybtex formatting styles.

Quick start¶

Installation¶

uv add sphinxcontrib-bibtex-urn          # or: pip install sphinxcontrib-bibtex-urn

Usage¶

Add the extension to your Sphinx conf.py:

extensions = [
    "sphinxcontrib.bibtex",
    "sphinxcontrib_bibtex_urn",
]

bibtex_default_style = "alpha"   # any pybtex style works
bibtex_bibfiles = ["refs.bib"]

See the Usage guide for full details and the Citation style examples page for rendered citation style demos.

Documentation

Project