https://github.com/tinloaf/bibchex

BibCheX is a tool to automatically sanity- and consistency-check your BibTeX files
https://github.com/tinloaf/bibchex

bibliography bibtex latex

Last synced: 12 days ago
JSON representation

BibCheX is a tool to automatically sanity- and consistency-check your BibTeX files

• Host: GitHub
• URL: https://github.com/tinloaf/bibchex
• Owner: tinloaf
• License: mit
• Created: 2020-06-07T14:19:54.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-07-22T11:49:46.000Z (over 4 years ago)
• Last Synced: 2024-12-08T20:16:54.201Z (19 days ago)
• Topics: bibliography, bibtex, latex
• Language: Python
• Size: 373 KB
• Stars: 8
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.rst
  • License: License.txt

Awesome Lists containing this project

README

        
Welcome to BibCheX's documentation!

===================================

BibCheX is a tool to sanity- and consistency-check your BibTeX reference files. Aside from checks ensuring your preferred style guidelines are met, Bibchex pulls in bibliographic data from sources such as CrossRef and cross-checks your BibTeX files against this data. The `documentation `_ contains a list of all available checkers and data sources.

	 

Getting started

---------------

This walks you quickly through running BibCheX on your .bib file. 

Installation

^^^^^^^^^^^^ 

Installing BibCheX from source should be as easy as running

.. code-block:: bash

	 python setup.py install

in the source folder. Alternatively, you can install BibCheX from PyPI using ``pip``:

.. code-block:: bash

	 

	 pip install bibchex

Configuration

^^^^^^^^^^^^^

Configuration determines which style rules should be checked for. BibCheX comes with a default configuration which matches my personal taste, but probably not yours. So you can run BibCheX without customizing the config, but you might not be happy with the result.

You can find the default configuration at ``bibchex/data/default_config.json`` in the source. Copy that file to ``~/.config/bibchex.json`` or anywhere else. If you did copy it to some arbitrary location, you must pass the path to that file via the ``--config`` command line switch.

Have a look at the `configuration documentation `_ to see what can be configured.

Running

^^^^^^^

BibCheX can be run in three modes. In GUI mode, text mode or silent mode. Okay, "GUI" is kind of a lie, it's more of a TUI. But anyways, it provides progress bars, so yay for GUI mode!

BibCheX expects as first positional argument the path to your ``.bib`` file, and as second a path to a (non-existent) HTML file, to which it will write its output. Running BibCheX (in GUI mode) can be as easy as:

.. code-block:: bash

								

	 bibchex /path/to/my/references.bib /path/to/the/desired/output.html

This should open a text UI with some scrolling log messages and progress bars on the top. Once everything is finished, press any key to close the UI and open ``/path/to/the/desired/output.html`` in any browser to have a look at the result.

Running BibCheX without the GUI can be done like this:

.. code-block:: bash

	 bibchex --cli /path/to/my/references.bib /path/to/the/desired/output.html

Remember that you may have to pass your custom configuration JSON file if you have placed in a nonstandard location:

.. code-block:: bash

								

	 bibchex --cli --config /path/to/your/config.json /path/to/my/references.bib /path/to/the/desired/output.html

**Please Note**: The (free) crossref API required a valid email address to be set for usage. By default, a dummy address is configured. Please change this to a valid address before actually using BibCheX!