LaTeX: Cleveref package

The Cleveref package (also available from CTAN) does clever things with cross-references:

  • automatic formatting of cross-references based on the type of object referred to (chapter, section, equation, theorem, etc.);
  • full control and customisation of the reference format;
  • cross-references and page references to multiple items;
  • automatic (optional) sorting and compression of multiple cross-references or page references;
  • optional output of a sed script that can strip out Cleveref commands and replace them with standard LaTeX, allowing Cleveref to be used e.g. in articles sent to journals or collaborators that don't (yet!) support Cleveref.

A number of other LaTeX packages provide similar features. Some are venerable enough to be documented in <em>The LaTeX Companion</em>, or even included in the standard LaTeX distribution itself. But all those that I've come across provide only a subset of the Cleveref features. (See the Introduction to the package documentation for some comparisons.)

Documentation

Full documentation is available in a variety of formats, for download and viewing online. (Since the package is in DocTeX format, the source for the documentation is the same as the package itself.)

Download and Installation

The latest release of the Cleveref package is version 0.20 (released August 2016).

Note that this is a pre-release version, which is a not currently available on CTAN, and should not (yet) be considered fully stable. Please report any issues or bugs that you encounter, and check back here periodically for updates. Note that the version number is only finally fixed once the version is uploaded to CTAN. Pre-release versions may be updated without any change to the version number. Compare package dates to see if you have the latest pre-release.

For convenience, the most recent "stable" CTAN release is also available below, along with some older versions.

To install the package, follow the usual DocTeX installation procedure: extract the files, run the cleveref.ins file through LaTeX, copy the resulting cleveref.sty file to a directory in your TeX path, and run texhash (or equivalent) to update your TeX database.

To build the documentation, run the cleveref.dtx file through LaTeX, run makeindex -s gind.ist cleveref.idx to build the index, then makeindex -s gglo.ist -t cleveref.glg -o cleveref.gls cleveref.glo to build the change history, and finally run cleveref.dtx through LaTeX one last time.

Bugs and Feature Requests

Bugs, feature requests, and any other feedback should be addressed to toby-cleveref@dr-qubit.org. (Note that this address is protected by TMDA spam-reduction software. The first time you send an email, you will have to verify your address by replying to a confirmation message.)

A list of known bugs, work-arounds, and possible future improvements is included at the end of the package documentation.

Leave a comment

All comments are moderated. By submitting your comment you agree to license the content under a Creative Commons Attribution-ShareAlike 4.0 International License.




Creative Commons License