Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/HDembinski/autobib
Automatically generate and manage a BibTeX file
https://github.com/HDembinski/autobib
Last synced: 3 months ago
JSON representation
Automatically generate and manage a BibTeX file
- Host: GitHub
- URL: https://github.com/HDembinski/autobib
- Owner: HDembinski
- License: mit
- Created: 2021-05-04T19:29:45.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-29T22:05:33.000Z (6 months ago)
- Last Synced: 2024-04-29T23:26:10.581Z (6 months ago)
- Language: Python
- Size: 55.7 KB
- Stars: 5
- Watchers: 3
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# autobib
![PyPI](https://img.shields.io/pypi/v/autobib)
![PyPI - License](https://img.shields.io/pypi/l/autobib)
![PyPI - Status](https://img.shields.io/pypi/status/autobib)`autobib` automatically fetches BibTeX entries from online databases (currently Inspire and ADS) based on references that were added to the LaTeX document but not yet to the `.bib` file. The automatically fetched entries are appended to the first `.bib` file defined in your LaTeX source (first entry of `\bibliography{...}`). For this to work, the cite key has to be a key used by the online database.
In other words, you still need to look up a citation online and copy the cite key to your LaTeX file, but you don't have to also copy the whole BibTeX entry to your local `.bib` file (essentially adding it twice), since `autobib` does the latter for you.
`autobib` only appends new entries to your `.bib` file and otherwise leaves it as is. Using it is therefore safe.
## Installation and usage
`pip install autobib`
This installs a new script called `bibtex-autobib`, which is a drop-in replacement of the original `bibtex` command. The easiest way to make it work automatically with tooling like `latexmk` is to create a symlink
`ln -s /path/to/bibtex-autobib /some/path/bibtex`
where `/some/path/bibtex` comes before the path in which the original `bibtex` command is located in the PATH environment variable. Be careful that you do not override the original `bibtex` command.
After doing that, you can check whether the command `bibtex` is calling `autobib` by calling `bibtex --version` on the command-line. You should see something like this
```
autobib 0.6.0
BibTeX 0.99d (TeX Live 2020)
[...]
```
If this is not the case, then you may have to change the order of search paths in the `PATH` environment variable.### ADS token
No extra steps are needed to download from Inspire, but to download from ADS you need to [follow these instructions](https://github.com/adsabs/adsabs-dev-api#access) to get an API token. Export this token in your shell as ADS_TOKEN, e.g. `export ADS_TOKEN=`.