doomemacs/modules/lang/latex/README.org
Alexander Graul db2901af71 Update documentation of recognized latex viewers
The user documentation of +latex-viewers did not keep up with changes to
the variable. This commit realigns its documentation.
2019-10-03 12:56:56 +02:00

2.7 KiB

lang/latex

Description

Provide a helping hand when working with LaTeX documents.

  • Sane defaults
  • Fontification of many popular commands
  • Pretty indentation of wrapped lines using the adaptive-wrap package
  • Spell checking with flycheck
  • Change PDF viewer to Okular or latex-preview-pane
  • Bibtex editor
  • Autocompletion using company-mode
  • Ivy or Helm for selecting bibliography
  • Compile your .tex code only once using LatexMk

Module Flags

  • +latexmk Use LatexMk instead of LaTeX to compile documents.

TODO Features

Customization

Specifying the location of a bibtex file & corresponding PDFs

The reftex and bibtex-completion packages have two variables that allow you to specify where it should find your bibliography file(s) and their corresponding PDFs:

(setq reftex-default-bibliography "/your/bib/file.bib")
;; Optionally specifying a location for the corresponding PDFs
(setq bibtex-completion-library-path (list "/your/bib/pdfs"))

Changing the PDFs viewer

This module provides integration for four supported pdf viewers. They are

  • Skim.app (MacOS only)
  • Evince
  • Sumatra PDF
  • Zathura
  • Okular
  • pdf-tools (requires :tools pdf module)

They are searched for in this order. See +latex-viewers to change the order, or remove tools from the search altogether. If you want to exclusively use one tool, for instance:

(setq +latex-viewers '(zathura))

If none of these tools are found, latex-preview-pane (uses DocView in Emacs) is used as a fallback. You can use this exclusively by setting +latex-viewers to nil.