emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
doomemacs/modules/lang/latex/README.org
M. Yas. Davoodeh 6b68dcceee Minor fixes in docs and check for :lang lsp.
2020-03-19 19:19:35 +03:30

3.6 KiB
Raw Blame History

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.
  • +cdlatex Enable cdlatex for fast math insertion.
  • +lsp Start LSP automatically in `tex-mode-hook`. This requires the :tools lsp module.

Plugins

TODO Prerequisites

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.

Using cdlatex's snippets despite having yasnippet

cdlatex has a snippet insertion capability which is disabled in favor of yasnippet when using :editor snippets. If you still wanna use it, simply rebind the TAB key for cdlatex, which takes care of snippet-related stuff:

(map! :map cdlatex-mode-map
    :i "TAB" #'cdlatex-tab)

This would favor yasnippet's expansion and cursor movement over cdlatex's expansion and movement, but that shouldn't matter if you're not using yasnippet in latex buffers.