BibTeX style extension for Rubin Observatory#
sphinxcontrib-bibtex is an excellent way to include academic citations in Sphinx documentation projects.
Documenteer provides support for LSST’s common BibTeX bibliography files (maintained in lsst-texmf) through its documenteer.sphinxext.bibtex
extension.
Specifically, this extension provides support for docushare
fields in those bib files.
Usage#
To use this Sphinx extension, add documenteer.sphinxext.bibtex
to your conf.py
file:
extensions = ["documenteer.sphinxext.bibtex"]
bibtex_default_style = "lsst_aa"
The bibtex_default_style
configuration variable configures Sphinx.
Further reading#
See sphinxcontrib-bibtex’s Usage documentation to learn how to make citations in reStructuredText documents.
For using BibTeX files from the lsst/lsst-texmf repository, see Sourcing BibTeX files from GitHub.