127 lines
5.1 KiB
Org Mode
127 lines
5.1 KiB
Org Mode
#+TITLE: LaTeX Layer for Spacemacs
|
|
#+HTML_HEAD_EXTRA: <link rel="stylesheet" type="text/css" href="../../../css/readtheorg.css" />
|
|
|
|
[[file:img/latex.png]]
|
|
|
|
* Table of Contents :TOC_4_org:noexport:
|
|
- [[Description][Description]]
|
|
- [[Features][Features]]
|
|
- [[Install][Install]]
|
|
- [[Layer][Layer]]
|
|
- [[Auto-completion][Auto-completion]]
|
|
- [[Previewing][Previewing]]
|
|
- [[Build command][Build command]]
|
|
- [[Auto-fill][Auto-fill]]
|
|
- [[Keybindings][Keybindings]]
|
|
- [[RefTeX][RefTeX]]
|
|
|
|
* Description
|
|
This layer adds support for LaTeX files with [[https://savannah.gnu.org/projects/auctex/][AucTeX]].
|
|
|
|
** Features
|
|
- Auto-build with [[https://github.com/tom-tan/auctex-latexmk/][auctex-latexmk]]
|
|
- Auto-completion with [[https://github.com/alexeyr/company-auctex][company-auctex]]
|
|
- Tags navigation on ~%~ with [[https://github.com/redguardtoo/evil-matchit][evil-matchit]]
|
|
- Labels, references, citations and index entries management with [[http://www.gnu.org/software/emacs/manual/html_node/reftex/index.html][RefTeX]]
|
|
|
|
* Install
|
|
** Layer
|
|
To use this contribution add it to your =~/.spacemacs=
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq-default dotspacemacs-configuration-layers '(latex))
|
|
#+END_SRC
|
|
|
|
** Auto-completion
|
|
Add the layer =auto-completion= to the variable
|
|
=dotspacemacs-configuration-layers= of your dotfile =~/.spacemacs=.
|
|
|
|
** Previewing
|
|
To perform full-document previews (that is, aside from the inline previewing
|
|
under ~SPC m p~), add the following to your =.spacemacs=
|
|
under =dotspacemacs/user-config=:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(add-hook 'doc-view-mode-hook 'auto-revert-mode)
|
|
#+END_SRC
|
|
|
|
Then when you open up a compiled PDF, the preview will update automatically
|
|
when you recompile.
|
|
|
|
** Build command
|
|
A build command can be specified via the layer variable =latex-build-command=.
|
|
|
|
If =LatexMk= is specified, the appropriate =LatexMk= configuration
|
|
will be applied. (the default on systems with =latexmk= in the path)
|
|
This variable can be set to any of the entities in =TeX-command-list=,
|
|
including any custom entries you may have added there. To use the
|
|
regular =AucTeX= command set =latex-build-command= to =LaTeX= as shown
|
|
below.
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
dotspacemacs-configuration-layers '(
|
|
(latex :variables latex-build-command "LaTeX"))
|
|
#+END_SRC
|
|
|
|
** Auto-fill
|
|
To enable auto-fill set the variable =latex-enable-auto-fill= to =t=.
|
|
|
|
The variable =latex-nofill-env= provide the list of environment names where
|
|
=auto-fill-mode= will be inhibited.
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
dotspacemacs-configuration-layers '(
|
|
(latex :variables latex-enable-auto-fill t))
|
|
#+END_SRC
|
|
|
|
* Keybindings
|
|
|
|
| Key Binding | Description |
|
|
|---------------+-------------------------------------|
|
|
| ~SPC m -~ | open output buffer |
|
|
| ~SPC m b~ | build |
|
|
| ~SPC m c~ | close LaTeX environment |
|
|
| ~SPC m C~ | TeX command on master file |
|
|
| ~SPC m e~ | insert LaTeX environment |
|
|
| ~SPC m i~ | insert =\item= |
|
|
| ~SPC m h d~ | TeX documentation, can be very slow |
|
|
| ~SPC m p r~ | preview region |
|
|
| ~SPC m p b~ | preview buffer |
|
|
| ~SPC m p d~ | preview document |
|
|
| ~SPC m p e~ | preview environment |
|
|
| ~SPC m p s~ | preview section |
|
|
| ~SPC m p p~ | preview at point |
|
|
| ~SPC m p f~ | cache preamble for preview |
|
|
| ~SPC m p c~ | clear previews |
|
|
| ~SPC m v~ | view |
|
|
| ~SPC m x b~ | make font bold |
|
|
| ~SPC m x B~ | make font medium weight |
|
|
| ~SPC m x c~ | make font monospaced (for code) |
|
|
| ~SPC m x e~ | make font emphasised |
|
|
| ~SPC m x i~ | make font italic |
|
|
| ~SPC m x o~ | make font oblique |
|
|
| ~SPC m x r~ | remove font properties |
|
|
| ~SPC m x f a~ | use calligraphic font |
|
|
| ~SPC m x f c~ | use small-caps font |
|
|
| ~SPC m x f f~ | use sans serif font |
|
|
| ~SPC m x f n~ | use normal font |
|
|
| ~SPC m x f r~ | use serif font |
|
|
| ~SPC m x f u~ | use upright font |
|
|
|
|
** RefTeX
|
|
|
|
| Key Binding | Description |
|
|
|---------------+---------------------------------------|
|
|
| ~SPC m r c~ | reftex-citation |
|
|
| ~SPC m r g~ | reftex-grep-document |
|
|
| ~SPC m r i~ | reftex-index-selection-or-word |
|
|
| ~SPC m r I~ | reftex-display-index |
|
|
| ~SPC m r C-i~ | reftex-index |
|
|
| ~SPC m r l~ | reftex-label |
|
|
| ~SPC m r p~ | reftex-index-phrase-selection-or-word |
|
|
| ~SPC m r P~ | reftex-index-visit-phrases-buffer |
|
|
| ~SPC m r r~ | reftex-reference |
|
|
| ~SPC m r s~ | reftex-search-document |
|
|
| ~SPC m r t~ | reftex-toc |
|
|
| ~SPC m r T~ | reftex-toc-recenter |
|
|
| ~SPC m r v~ | reftex-view-crossref |
|