RefTeX is a reference management and citation helper package for the Emacs text editor, primarily used in conjunction with AUCTeX for editing La TeX documents. Developed by Carsten Dominik, RefTeX provides facilities for navigating, inserting, and formatting labels, citations, and bibliography entries within La TeX source files.
Functionality
- Label Management: Detects La TeX label definitions (e.g.,
\label{...}) and offers completion for referencing commands such as\ref,\eqref, and\pageref. - Citation Support: Integrates with BibTeX and related bibliography tools, offering completion for citation keys defined in
.bibfiles, and can insert appropriate citation commands (\cite,\citet, etc.) based on user configuration. - Cross‑Reference Navigation: Allows users to jump from a reference to its definition and vice versa, facilitating rapid editing of large documents.
- Table of Contents and Index Generation: Provides commands to generate and update tables of contents, lists of figures, and index entries.
- Customization: Offers extensive variable and hook options to tailor its behavior, including formatting of the inserted reference text and integration with other Emacs packages.
Historical Context
RefTeX was first released in 1999 as part of the AUCTeX suite, a comprehensive Emacs environment for TeX/La TeX editing. Its development aimed to address the repetitive and error‑prone nature of manually handling references and citations in La TeX documents. Over time, RefTeX has been maintained and updated alongside AUCTeX, with contributions from the Emacs community.
Installation and Usage
RefTeX is typically bundled with AUCTeX distributions and can be activated by adding the following to an Emacs initialization file:
(require 'reftex)
(add-hook 'LaTeX-mode-hook 'reftex-mode)
Once enabled, common commands include:
C-c (=)– Insert a label.C-c )– Insert a reference to an existing label.C-c [– Insert a citation.C-c =– Access the RefTeX reference menu.
Compatibility
RefTeX works on all platforms that support Emacs (Linux, macOS, Windows). It is compatible with major La TeX compilation workflows, including PDFLaTeX, XeLaTeX, and LuaLaTeX, and works alongside bibliography processors such as BibTeX, Biber, and biblatex.
Reception
The package is widely regarded in the Emacs and La TeX communities as a mature, reliable tool for managing references, often cited in tutorials, scholarly workflow guides, and user manuals for La TeX authoring.
References
- Dominik, Carsten. RefTeX Manual. AUCTeX Project, 2023.
- GNU Emacs Manual, Section “RefTeX”. GNU Project, 2024.
Note: The information presented reflects documented features and historical data available from the official RefTeX documentation and reputable Emacs/La TeX user resources.