Wilfred/helpful@5ad8a9ce57 -> Wilfred/helpful@6a4d5e0760 agda/agda@10a0ca0516 -> agda/agda@49a12eab7f clojure-emacs/cider@a0d6169026 -> clojure-emacs/cider@fdfa7c2200 dominikh/go-mode.el@602d73e226 -> dominikh/go-mode.el@0ed3c5227e emacs-geiser/gauche@8ff743f641 -> emacs-geiser/gauche@9eb8b35f0c emacs-lsp/lsp-dart@7e3d342941 -> emacs-lsp/lsp-dart@2170823139 emacs-lsp/lsp-java@868600bf7f -> emacs-lsp/lsp-java@6cfff8761e emacs-lsp/lsp-metals@567089f7f4 -> emacs-lsp/lsp-metals@345b4fa80e emacs-lsp/lsp-sourcekit@63ff1ab638 -> emacs-lsp/lsp-sourcekit@3bd9750e7e emacs-lsp/lsp-treemacs@fb1a07ae0a -> emacs-lsp/lsp-treemacs@312dee2b3a emacs-rustic/rustic@fbbf0a7192 -> emacs-rustic/rustic@22a5ef8bfd emacs-straight/auctex@53f80ba36c -> emacs-straight/auctex@6fb366064c emacs-straight/csv-mode@6979fc18eb -> emacs-straight/csv-mode@1695ee1752 emacsorphanage/dart-mode@88b6683f43 -> emacsorphanage/dart-mode@6229941ec5 erlang/otp@64185e73b0 -> erlang/otp@740af6bae5 fsharp/emacs-fsharp-mode@677d78c4d6 -> fsharp/emacs-fsharp-mode@bf7a11e1ba gcv/julia-snail@24f79a067b -> gcv/julia-snail@cacf52e4c8 godotengine/emacs-gdscript-mode@c3d9988984 -> godotengine/emacs-gdscript-mode@3f3739dd88 greghendershott/racket-mode@eef5e9ab2c -> greghendershott/racket-mode@88d82e249e jrblevin/markdown-mode@ee9d6de1d2 -> jrblevin/markdown-mode@d2d960bec1 json-emacs/json-mode@77125b01c0 -> json-emacs/json-mode@466d5b5637 ledger/ledger-mode@356d8049ed -> ledger/ledger-mode@d9b6648201 rust-lang/rust-mode@542f1755d8 -> rust-lang/rust-mode@efd830806c seagle0128/grip-mode@ffce7f78eb -> seagle0128/grip-mode@e90e3b47d8 ziglang/zig-mode@f0b4a48753 -> ziglang/zig-mode@4ad4edf759
:lang latex
Description unfold
Provide a helping hand when working with LaTeX documents.
- Sane defaults
- Fontification of many popular commands
- Pretty indentation of wrapped lines using the doom-package:adaptive-wrap package
- Spell checking with doom-package:flycheck
- Change PDF viewer to Okular or doom-package:latex-preview-pane
- Bibtex editor
- Autocompletion using doom-package:company-mode
- Compile your
.tex
code only once using LatexMk
Maintainers
Module flags
- +cdlatex
- Enable doom-package:cdlatex for fast math insertion.
- +fold
- Use TeX-fold (from doom-package:auctex) to fold LaTeX macros to unicode, and make folding hook-based and less manual.
- +lsp
- Enable LSP support in latex buffers. Requires doom-module::tools lsp and a langserver (supports digestif and TexLab).
Packages
- doom-package:adaptive-wrap
- doom-package:auctex
- doom-package:cdlatex if doom-module:+cdlatex
- doom-package:evil-tex if doom-module::editor evil +everywhere
- doom-package:latex-preview-pane
-
if doom-module::completion company
TODO Hacks
This module's hacks haven't been documented yet. Document them?
TODO Changelog
This module does not have a changelog yet.
Installation
Enable this module in your doom!
block.
This module requires ghostscript and a latex compiler. These are provided by the
texlive
bundle, available through many OS package managers.
Ghostscript <= 9.27 is reportedly buggy and doesn't work with auctex's math previews. (You can check you ghostscript version with
$ gs --version
.) Most package managers already have newer versions, but if not you might have to build gs from source.
Ubuntu
apt-get install texlive
Arch Linux
pacman -S texlive-basic texlive-latexrecommended texlive-plaingeneric
TODO macOS
brew install --cask basictex
# If the above doesn't work, then
brew install --cask mactex # WARNING: large 4gb download!
This has not been verified.
NixOS
environment.systemPackages = [ pkgs.texlive.combined.scheme-medium ];
Formatter
Formatting is handled using the doom-module::editor format module via latexindent.
TODO Usage
This module has no usage documentation yet. Write some?
Configuration
Specifying the location of a bibtex file & corresponding PDFs
Reftex has a variable that allow you to specify where it should find your bibliography file(s):
;; in $DOOMDIR/config.el
(setq reftex-default-bibliography "/your/bib/file.bib")
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 doom-module::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:
;; in $DOOMDIR/config.el
(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
doom-package:cdlatex has a snippet insertion capability which is disabled in favor of doom-package:yasnippet when using doom-module::editor snippets. If you still wanna use it, simply rebind the TAB key for cdlatex, which takes care of snippet-related stuff:
;; in $DOOMDIR/config.el
(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.
Troubleshooting
There are no known problems with this module. Report one?
Frequently asked questions
This module has no FAQs yet. Ask one?
TODO Appendix
This module has no appendix yet. Write one?