/BibTeX-Check

A python script for checking BibTeX .bib files

Primary LanguagePythonMIT LicenseMIT

BibTeX-Check

A python2/3 script for checking BibTeX .bib files

BibTeX Check is a small Python script that goes through a list of references and checks if certain required fields are available, for instance, if each publication is assigned a year or if a journal article has a volume and issue number.

Additionally, it allows for consistency checks of names of conference proceedings and could easily be extended to other needs.

The results of the check are printed to an html file, which includes links to Google Scholar, DBLP, etc. for each flawed reference. These links help retrieving missing information and correcting the entries efficiently.

Please note that it is not a BibTeX validator. And in the current version, it might not yet be able to parse every valid bib file. The software targets the specific needs of Computer Scientist, but may be applicable in other fields as well.

For use in automated environments, BibTeX-Check returns errors on the console (can be disabled). Further, it returns an exit code depending on whether problems have been found.

The html output is tested with Firefox and Chrome, but the current version does not properly work with Internet Explorer.

Getting Started

Just copy the file into a directory with write permission, then run the script

./bibtex_check.py <-b input.bib> [-a input.aux] [-o output.html] [-c config.json5]

If you provide the additional aux file (created when compiling a tex document), then the check of the bib file is restricted to only those entries that are really cited in the tex document.

Options

Specify these when calling the script.

  • -b (--bib=file.bib) Set the input Bib File
  • -a (--aux=file.aux) Set the input Aux File
  • -o (--output=file.html) Write results to the HTML Output File
  • -c (--config=file.json5) Load config file
  • -v (--view) Open in Browser. Use together with -o.
  • -N (--no-console) Do not print problems to console. An exit code is always returned.

Help

See ./bibtex_check.py -h for basic help.

If your getting an environment error, try using python ./bibtex_check.py or python3 ./bibtex_check.py depending on your OS.

Alternatives

BibTeX-Check is copied from BibTex Check by Fabian Beck.

Further, I have used the improvements provided from BibLatex Check by Pez Cuckow, which can be used to validate BibLaTeX files.

See BibTex vs BibLaTex vs NatBib for a comparison of different referencing packages.

License

MIT license