This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/contrib/!lang/latex/README.md

4.1 KiB

LaTeX Layer for Spacemacs

logo

Table of Contents

Description

This layer adds support for LaTeX files with AucTeX.

Features:

  • auto-completion with [company-auctex][]
  • tags navigation on % with evil-matchit
  • labels, references, citations and index entries management with RefTeX

Install

Layer

To use this contribution add it to your ~/.spacemacs

(setq-default dotspacemacs-configuration-layers '(auctex))

Auto-completion

Add the layer auto-completion to the variable dotspacemacs-configuration-layers of your dotfile ~/.spacemacs.

Previewing

To perform full-document previews (that is, aside from the inline previewing under SPC m p), add the following to your .spacemacs under dotspacemacs/config:

(add-hook 'doc-view-mode-hook 'auto-revert-mode)

Then when you open up a compiled PDF, the preview will update automatically when you recompile.

Build command

A build command can be specific via the layer variable latex-build-command.

The default value is "LaTeX". If "LatexMk" is specified, the appropriate LatexMk configuration will be applied.

dotspacemacs-configuration-layers '(
  (auctex :variables latex-build-command "LatexMk"))

Auto-fill

To enable auto-fill set the variable latex-enable-auto-fill to t.

The variable latex-nofill-env provide the list of environment names where auto-fille-mode will be inhibited.

dotspacemacs-configuration-layers '(
  (auctex :variables latex-enable-auto-fill t))

Keybindings

Key Binding Description
SPC m * TeX documentation, can be very slow
SPC m b build
SPC m c close LaTeX environment
SPC m C TeX command on master file
SPC m e insert LaTeX environment
SPC m f insert LaTeX font - full bindings here: AUCTeX documentation
SPC m i insert \item
SPC m p r preview region
SPC m p b preview buffer
SPC m p d preview document
SPC m p e preview environment
SPC m p s preview section
SPC m p p preview at point
SPC m p f cache preamble for preview
SPC m p c clear previews
SPC m v view

RefTeX

Key Binding Description
SPC m r c reftex-citation
SPC m r g reftex-grep-document
SPC m r i reftex-index-selection-or-word
SPC m r I reftex-display-index
SPC m r C-i reftex-index
SPC m r l reftex-label
SPC m r p reftex-index-phrase-selection-or-word
SPC m r P reftex-index-visit-phrases-buffer
SPC m r r reftex-reference
SPC m r s reftex-search-document
SPC m r t reftex-toc
SPC m r T reftex-toc-recenter
SPC m r v reftex-view-crossref

Maintainer

This layer was created by and is maintained by @trishume, ping me in the Gitter chat if you have questions. Feel free to submit PRs for this layer though if you have improvements.