spacemacs/layers/+lang/latex/README.org

LaTeX Layer for Spacemacs

• Description
  • Features
• Install
  • Layer
  • Auto-completion
  • Previewing
  • Build command
  • Auto-fill
• Keybindings
  • RefTeX
• Maintainer

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 '(latex))

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/user-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 '(
    (latex :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-fill-mode will be inhibited.

  dotspacemacs-configuration-layers '(
    (latex :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 Font Doc
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.