LaTeX Code

This page contains the LaTeX packages I develop and maintain. When a package is also listed as being available on CTAN, CTAN should be viewed as the primary source (the versions linked below are usually identical to the CTAN versions, though they may sometimes be updated slightly earlier here).

Cleveref

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 The LaTeX Companion, 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.19.1 (released May 2014).

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.

Quantum

The Quantum package defines a number of commands and short-hands useful when writing about quantum mechanics, and quantum information theory in particular.

There is no separate documentation; read the package source to find out what commands it provides.