Skip to main content

Wrapper around latexdiff to make citations diff properly

Project description

Documentation Status PyPI Package latest release PyPI Package monthly downloads Supported versions
Travis-CI Build Status AppVeyor Build Status Coverage Status Code Quality Status Scrutinizer Status

What is latexdiffcite?

latexdiffcite is a wrapper around latexdiff to make citations diff properly:

latexdiffcite is a wrapper around latexdiff which, before calling latexdiff, replaces (in temporary files!) citation commands such as \cite{...} with written-out formatted references. It does this by looking up references in a corresponding .bib file or .bbl file and formatting them according to a user-specifiable configuration. latexdiff will then properly mark changes in the citations. The citation format can be heavily customized to match what you are already getting from LaTeX/BibTeX.

Quick start

latexdiff is required, but you of course already have that installed and working, right? :-)

Install with pip:

pip install latexdiffcite

To compare two .tex files on disk, use the file subcommand like this:

latexdiffcite file FILE_OLD FILE_NEW

To compare two revisions (commit hash, tag, branch, etc.) of a .tex file in a git repository, use the git subcommand like this:

latexdiffcite git FILE REV_OLD [REV_NEW] [FILE_NEW]
  • REV_OLD and REV_NEW can be commit hashes, tags, branches, etc.

  • REV_NEW is optional, and defaults to HEAD (the latest committed version).

  • FILE_NEW is optional, and is used when the new filename/path is different than the old


For customization and advanced usage, see


1.0.6 (2017-02-26)

  • Fix bug where temp files has not finished writing before calling latexdiff

1.0.5 (2017-02-21)

  • Fix crash when LaTeX commands were used in pre-notes and post-notes

1.0.4 (2015-06-08)

  • Minor readme/doc changes

1.0.0 (2015-06-08)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

latexdiffcite-1.0.6.tar.gz (103.5 kB view hashes)

Uploaded Source

Built Distribution

latexdiffcite-1.0.6-py2.py3-none-any.whl (14.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page