mirror of https://github.com/doomemacs/doomemacs synced 2025-09-06 15:13:33 -05:00

Files

yoavm448 883a326e87 Add cdlatex support in latex: +cdlatex

cdlatex has 4 main functionalities:
+ Math and environments snippets: I've disabled these in favor of
  yasnippet when using :editor snippets by just unbinding the TAB in
  cdlatex's keymap
+ Auto insertion of closing delimiters: disabled in favor of smartparens
+ Fast insertion for some macros: `a becomes \alpha. Kept as-is
+ Fast accent insertion: a'~ becomes \tilde{a}. Kept as-is

I also updated the docs, and added a section explaining how to re-enable
cdlatex's snippets despite having yasnippet.

2020-02-07 13:06:14 +02:00

3.5 KiB

Raw Blame History

lang/latex

Description
- Module Flags
- Plugins
Prerequisites
Features
Customization

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.

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.

3.5 KiB Raw Blame History