Maintaining common BibTeX files with refresh-lsst-bib¶
Sphinx technotes vendor LSST’s common BibTeX bibliography files (maintained in lsst-texmf) into an
lsstbib directory, contained within the technote’s repository.
These bib files are checked into a technote’s Git repository so that the technote is repeatably buildable independently of lsst-texmf, and without resorting to complicated techniques like Git submodules.
Periodically you may need to update these bib files with the latest versions available from the lsst-texmf repository.
Documenteer includes the refresh-lsst-bib, also available through technote’s
make refresh-bib target, to make this process straightforward.
Steps for updating LSST BibTeX files¶
From the root directory of the technote, run:
This command runs refresh-lsst-bib and downloads the latest bib files from lsst-texmf’s
masterbranch on GitHub.
Commit the modified bib files:
git add lsstbib/*.bib git commit
Download LSST .bib bibliography files from the lsst-texmf GitHub repository.
usage: refresh-lsst-bib [-h] [-d DIR] [-v]
show this help message and exit
Directory to download bib files into. Default is the current working directory.
Enable Verbose output (debug level logging)