AuCTeX is the best LaTeX editing suite of all time.

Load Packages

(use-package tex
  :ensure auctex
  (require 'texmathp)
  (require 'preview)

General settings

We generally want to autosave and output to PDF. Last line autosaves on compilation with C-c C-c.

(setq-default TeX-master nil)
(setq-default TeX-command-extra-options "--shell-escape")
(setq TeX-auto-save t)
(setq TeX-parse-self t)
(setq TeX-PDF-mode t)
(setq reftex-plug-into-AUCTeX t)
(setq TeX-save-query nil)
(setq TeX-error-overview-open-after-TeX-run t)
(setq TeX-electric-math '("$" . "$"))
(setq TeX-electric-sub-and-superscript t)

The section headers should be rendered using the Computer Modern font

(require 'font-latex)
(set-face-attribute 'font-latex-sectioning-5-face nil :family "Fira Sans")
(setq font-latex-fontify-sectioning 1.2)

When we insert $, want to insert LaTeX Math \(\LaTeX\) symbols instead.

(defun do.latex/insert-math ()
  (insert "\\(\\)")
  (backward-char 2))

Finally, fix some collisions with the company completion engine and add other keybindings

(:map TeX-mode-map (("<tab>" . do.completion/tab-indent-or-complete)
                    ("$" . do.latex/insert-math)))

Fix auto-fill with inline math

More info here.

(setq-default LaTeX-fill-break-at-separators (quote (\\\( \\\[ \\\])))


This is currently unused.

(require 'lsp-mode)

(defun do.latex.lsp/texlab-cmd ()
  (list (concat (file-name-as-directory initel-directory) "random/texlab")))

   (make-lsp-client :new-connection
                    :major-modes '(tex-mode yatex-mode latex-mode LaTeX-mode)
                    :server-id 'texlab

;;(add-hook 'LaTeX-mode-hook #'lsp)

SyncTeX and view programs

(setq TeX-source-correlate-method 'synctex)
(setq TeX-source-correlate-start-server t)
(add-hook 'LaTeX-mode-hook 'TeX-source-correlate-mode)
;; if we want to use okular, enable it as View program
(when (and (boundp 'do.minimal/pdf-reader)
           (string= "okular" do.minimal/pdf-reader))
  (setq TeX-view-program-selection
        '(((output-dvi has-no-display-manager)
          ((output-dvi style-pstricks)
          (output-dvi "Okular")
          (output-pdf "Okular")
          (output-html "xdg-open"))))


First line adds hook from previous section. The last hook we add sets the default face for prose to a serif font.

(add-hook 'LaTeX-mode-hook 'toggle-serif)
(add-hook 'LaTeX-mode-hook 'flyspell-mode)
(add-hook 'LaTeX-mode-hook 'LaTeX-math-mode)
(add-hook 'LaTeX-mode-hook 'turn-on-reftex)
(add-hook 'LaTeX-mode-hook 'visual-line-mode)

;; set up company completions (i.e., disable dabbrev)

(defun do.latex/setup-completion ()
  "Enable auctex-specific completion functions exclusively."
  (make-variable-buffer-local 'company-backends)
  (setq company-backends '(company-auctex-labels
                           (company-auctex-macros company-auctex-symbols company-auctex-environments)
                           (company-math-symbols-latex company-math-symbols-unicode)

(add-hook 'LaTeX-mode-hook #'do.latex/setup-completion)


(add-to-list 'TeX-command-list '("XeLaTeX" "%`xelatex %(extraopts)%(mode)%' %t" TeX-run-TeX nil t))


(use-package auctex-latexmk
  :ensure t

Spell checking

(use-package ispell
  (setq-default ispell-program-name "hunspell")
  (setq ispell-really-hunspell t)


(setq ispell-dictionary-base-alist
         "[a-zA-Z]" "[^a-zA-Z]" "[']" nil
         ("-d" "en_US" "-i" "iso-8859-1") nil iso-8859-1)
         "[a-zA-Z]" "[^a-zA-Z]" "[']" nil
         ("-d" "en_GB" "-i" "iso-8859-1") nil iso-8859-1)
         "[a-zäöüßA-ZÄÖÜ]" "[^a-zäöüßA-ZÄÖÜ]" "[']" nil
         ("-d" "de_DE" "-i" "iso-8859-1") nil iso-8859-1)))

Activate a specific Dictionary after loading

(eval-after-load "ispell"
    (setq ispell-dictionary "en_US")
    (setq ispell-silently-savep t)))

Emacs and IEEEeqnarray

We want emacs to play nice with the IEEEtran and IEEEtrantools packages. We also define some keyboard shortcuts. Stefan Moser's typeset_equations comes with a few keyboard bindings, but rather than using the recommended fset... commands to insert a new IEEEeqnarray, I want to insert them using snippets.


The two snippets I defined are ieq.yasnippet to insert a regular IEEEeqnarray with argument {rCl} and ieqs.yasnippet to insert the starred version. The recommended keybindings are also defined within the snippet: I'm binding C-c i to insert the regular array nad C-c o to insert the starred array.

The ieq snippet looks like this:

# -*- mode: snippet -*-
# contributor: Dennis Ogbe <[email protected]>
# key: ieq
# group: math
# name: \begin{IEEEeqnarray}{rCl} ... \end{IEEEeqnarray}
# binding: C-c i
# --
\label{${2:"waiting for reftex-label call..."$(unless yas/modified-p (reftex-label nil 'dont-insert))}}

LaTeX environments

Make AuCTeX aware of the IEEEeqnarray as a math environment.

(TeX-add-style-hook "latex"
                    (lambda ()
                       '("IEEEeqnarray" LaTex-env-label)
(add-hook 'LaTeX-mode-hook
          '(lambda ()
             (add-to-list 'font-latex-math-environments "IEEEeqnarray")
             (add-to-list 'font-latex-math-environments "IEEEeqnarray*")
             ;; need this  for electric subscripts
             (setq texmathp-tex-commands
                   '(("IEEEeqnarray" env-on)
                     ("IEEEeqnarray*" env-on)))

ispell and reftex

We also want to make ispell and reftex aware of IEEEeqnarray. The variable ispell-tex-skip-alists contains two lists with patterns for ispell to skip. Since Moser's proposed list is longer than the default emacs one, we'll just copy the whole list.

(setq ispell-tex-skip-alists
      '((("%\\[" . "%\\]")
         ;; All the standard LaTeX keywords from L. Lamport's guide:
         ;; \cite, \hspace, \hspace*, \hyphenation, \include, \includeonly, \input,
         ;; \label, \nocite, \rule (in ispell - rest included here)
         ("\\\\addcontentsline"              ispell-tex-arg-end 2)
         ("\\\\psfrag"                       ispell-tex-arg-end-psfrag 0)
         ("\\\\add\\(tocontents\\|vspace\\)" ispell-tex-arg-end)
         ("\\\\\\([aA]lph\\|arabic\\)"       ispell-tex-arg-end)
         ("\\\\author"                       ispell-tex-arg-end)
         ("\\\\bibliographystyle"            ispell-tex-arg-end)
         ("\\\\bibliography"                 ispell-tex-arg-end)
         ("\\\\bstctlcite"                   ispell-tex-arg-end)
         ("\\\\eqref"                        ispell-tex-arg-end)
         ("\\\\thref"                        ispell-tex-arg-end)
         ("\\\\label"                        ispell-tex-arg-end)
         ("\\\\makebox"                      ispell-tex-arg-end 0)
         ("\\\\document\\(class\\|style\\)" .
          "\\\\begin[ \t\n]*{[ \t\n]*document[ \t\n]*}"))
        (;; delimited with \begin.  In ispell: displaymath, eqnarray, eqnarray*,
         ;; equation, minipage, picture, tabular, tabular* (ispell)
         ("\\(figure\\|table\\)\\*?"  ispell-tex-arg-end 0)
         ("list"                      ispell-tex-arg-end 2)
         ("IEEEeqnarray\\*?". "\\\\end[ \t\n]*{[ \t\n]*IEEEeqnarray\\*?[ \t\n]*}")
         ("IEEEeqnarraybox[tm]?\\*?". "\\\\end[ \t\n]*{[ \t\n]*IEEEeqnarraybox[tm]?\\*?[ \t\n]*}")
         ("program"         . "\\\\end[ \t\n]*{[ \t\n]*program[ \t\n]*}")
         ("verbatim\\*?"    . "\\\\end[ \t\n]*{[ \t\n]*verbatim\\*?[ \t\n]*}")
         ("gather\\*?"      . "\\\\end[ \t\n]*{[ \t\n]*gather\\*?[ \t\n]*}"))))

The variable reftex-label-alist is also empty by default, so let's use the one from typeset_equations:

(setq reftex-label-alist
      '((nil              ?e "eq:"   "~\\eqref{%s}" nil nil)
        ("IEEEeqnarray"   ?e "eq:"   "~\\eqref{%s}" t   nil)
        ("IEEEeqnarray*"  ?e "eq:"   "~\\eqref{%s}" t   nil)
        ("lemma"          ?l "lem:"  "~\\ref{%s}"   t   ("lemma" "lem."))
        ("theorem"        ?h "thm:"  "~\\ref{%s}"   t   ("theorem" "th." "thm."))
        ("corollary"      ?c "cor:"  "~\\ref{%s}"   t   ("corollary" "cor."))
        ("conjecture"     ?j "conj:" "~\\ref{%s}"   t   ("conjecture" "conj."))
        ("proposition"    ?p "prop:" "~\\ref{%s}"   t   ("proposition" "prop."))
        ("claim"          ?m "clm:"  "~\\ref{%s}"   t   ("claim" "cl."))
        ("definition"     ?d "def:"  "~\\ref{%s}"   t   ("definition" "def."))
        ("remark"         ?r "rem:"  "~\\ref{%s}"   t   ("remark" "rem."))
        ("example"        ?x "ex:"   "~\\ref{%s}"   t   ("example" "ex."))
        ("exercise"       ?x "ex:"   "~\\ref{%s}"   t   ("exercise" "exer." "exerc." "ex."))
        ("enumerate"      ?i "item:" "~\\ref{%s}"   t   ("part"))))