Files
doomemacs/modules/lang/latex
Henrik Lissner 4daa9271a0 Introduce general.el & rewrite map!
+ Now uses an overriding keymap for leader keys, so that it is always
  available, even outside of normal/visual states. In insert/emacs
  states, or in sessions where evil is absent, an alternative prefix is
  used for leader/localleader keys. See these variables:
  + doom-leader-prefix
  + doom-leader-alt-prefix
  + doom-localleader-prefix
  + doom-localleader-alt-prefix
+ Keybinds now support alternative prefixes through the new :alt-prefix
  property. This is useful for non-evil users and non-normal evil
  states. By default, this is M-SPC (leader) and M-SPC m (localleader).
+ Removed +evil-commands flag from config/default (moved to
  feature/evil/+commands.el).
+ config/default/+bindings.el has been split into
  config/default/+{evil,emacs}-bindings.el, which one is loaded depends
  on whether evil is present or not. The latter is blank, but will soon
  be populated with a keybinding scheme for non-evil users (perhaps
  inspired by #641).
+ The define-key! macro has been replaced; it is now an alias for
  general-def.
+ Added unmap! as an alias for general-unbind.
+ The following modifier key conventions are now enforced for
  consistency, across all OSes:
    alt/option      = meta
    windows/command = super
  It used to be
    alt/option      = alt
    windows/command = meta
  Many of the default keybinds have been updated to reflect this switch,
  but it is likely to affect personal meta/super keybinds!

The map! macro has also been rewritten to use general-define-key. Here
is what has been changed:

+ map! no longer works with characters, e.g. (map! ?x #'do-something) is
  no longer supported. Keys must be kbd-able strings like "C-c x" or
  vectors like [?C-c ?x].
+ The :map and :map* properties are now the same thing. If specified
  keymaps aren't defined when binding keys, it is automatically
  deferred.
+ The way you bind local keybinds has changed:

    ;; Don't do this
    (map! :l "a" #'func-a
          :l "b" #'func-b)
    ;; Do this
    (map! :map 'local "a" #'func-a
                      "b" #'func-b)

+ map! now supports the following new blocks:
  + (:if COND THEN-FORM ELSE-FORM...)
  + (:alt-prefix PREFIX KEYS...) -- this prefix will be used for
    non-normal evil states. Equivalent to :non-normal-prefix in general.
+ The way you declare a which-key label for a prefix key has changed:

    ;; before
    (map! :desc "label" :prefix "a" ...)
    ;; now
    (map! :prefix ("a" . "label") ...)

+ It used to be that map! supported binding a key to a key sequence,
  like so:

    (map! "a" [?x])  ; pressing a is like pressing x

  This functionality was removed *temporarily* while I figure out the
  implementation.

Addresses: #448, #814, #860
Mentioned in: #940
2018-12-22 04:14:43 -05:00
..
2018-07-30 03:43:43 +02:00
2018-12-22 04:14:43 -05:00
2018-12-06 19:07:36 -05:00

:lang latex

Module Description

Provide a helping hand when working with LaTeX documents.

Feature:

  • Sane defaults
  • Fontification of many popular commands
  • Pretty indentation of wrapped lines using the adaptive-wrap package
  • Spell checking with flyschek
  • 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

Customization

Custom Variables

Two custom variables state where AUCTeX will search for bibliography files and their corresponding PDFs. Set these variables in your private configuration with:

(set! :latex-bibtex-file "./your/bib/file.bib")
(set! :latex-bibtex-pdfs-dir "./dir/with/bib/pdfs/")

If the variables are not set, they are ignored.

Choose View Program

You have four options to choose from for the viewer of your PDF rendered files.

Okular

Use Okular as default PDF viewer.

Activate with the flag '+okular' of the latex module in your private init.el.

(latex +okular)

Skim

For Mac users. Use Skim to preview your PDFs.

Activate with the flag '+skim' of the latex module in your private init.el.

(latex +skim)

PDF Tools

Use the PDF Tools package to preview your PDFs. Requires the tools module pdf enabled in your configuration.

(:tools pdf)

Activate with the flag '+pdf-tools' of the latex module in your private init.el.

(latex +pdf-tools=)

Preview Pane

You may wish to use the old school package latex-preview-pane instead of the other alternatives. latex-preview-pane uses a DocView instead.

Activate with the flag '+preview-pane' of the latex module in your private init.el.

(latex +preview-pane)

LatexMk

Use LatexMk instead of normal LaTeX to compile documents. LatexMk only needs to run once to get all references, bibliography and other things right.

Activate with the flag '+latexmk' of the latex module in init.el.

(latex +latexmk)

You can enable both a custom view program and LatexMk with a call such as:

(latex +latexmk +okular)