This repo contains a init.el file (configuration file) for using LaTeX in GNU Emacs version 29. You can adapt it to other configurations of Emacs (e.g., Spacemacs, Doom, etc). The SciMax configuration probably has similar support built-in. See latex-emacs28 and latex-emacs30 for configurations that works with Emacs version 28 and Emacs version 30 respectively.

Features include the following:

• heavily customized auto-complete for LaTeX
• AUCTeX
• atomic-chrome (GhostText)
• awesome-tabs (install from Github)
• dashboard and dashboard-hackernews (keep abreast with the lastest distractions)
• org-mode
• org-agenda
• org-roam (capture templates include timestamps)
• org-roam-ui (view your zettelkasten like a mind-maps in your browser, very cool, similar to the one in Obsidian)
• pdf-tools
• pdf-noter

I built the latex-emacs profile on top of a configuration by Alvaro Ortiz Troncoso. His configuration included the auto-complete-auctex.el package of Chris Monsanto from 2012. Although the autocompletion is out of style for Emacs fans at the cutting edge of package development, it works!

I designed this configuration to support the efficient editing of academic documents in LaTeX. See the Features section below. See the related repos section below for LaTeX templates for the first manuscript submission, a writing log to accompany every writing project, a poster, a slideshow, a diary for 2022, and a diary for 2023.

This configuration is compatible with org-mode. Org-mode is an enhanced form of markdown that can read LaTeX code intermingled with org markup. Org-mode is very popular with users of Emacs because the sections and subsections are easy to fold, and org documents are easy to export to many file formats. It evolved out of an outliner package. It greatly eases the creation of lists, so it is useful for planning and brainstorming. Org-mode also has a powerful org-agenda component for scheduling events. Many have tried to use org-mode to implement the Getting Things Done method of Jim Allen. Org-mode also powers the org-roam package, which implements electronicallyt the zettelkasten system or slip-box system of taking smart notes.

In addition to Emacs, you can edit org-mode markdown in several other leading text editors like Visual Studio Code, so you can still use org-mode if you fear Emacs. Org-mode is responsible for the recent resurgence in the popularity of Emacs. (The median age of an Emacs user is about 33 years). The recurring annual emacsconfs reflects this surge in popularity. The two-day conference is virtual and free.

Org-mode supports literate programming with almost any programming language, although the latex-emacs init.el file is not configured for literate programming. Instead, see my complete configuration for Emacs. Unlike the above configuration written in Emacs lisp (elisp), the complete configuration is wrapped in org-mode. It is a 6000-line literature programming document. I wrote the comments in org-mode; they flank blocks of elisp code.

You can read an org-mode document into Emacs with the latex-emacs configuration, even though the latex-emacs init.el file does not call org-mode because the base distribution of Emacs now contains org-mode. See the this repo for a manuscript template that can be edited in org-mode. See this repo for a writing log to be used in parallel to writing a manuscript in org-mode.

I am keeping the latex-emacs configuration isolated from my main configuration to ease the development of latex-emacs. The latex-emacs profile also serves as a backup configuration when I break my main configuration, which happens less often these days.

I use this following bash alias to start Emacs29 with the configuration stored in the folder ~/latex-emacs29. Note that I am not hiding this folder in my top directory. I find the hinderance of hiding of the Emacs configuration folder to be greater than the benefit of not accidentally deleting my Emacs folder once in a lifetime. With my init.el file on GitHub, I can easily restore my Emacs configuration if disaster strikes.

alias e29l='/Applications/Emacs29.0.5.app/Contents/MacOS/Emacs --init-directory ~/latex-emacs29'.

The --init-directory flag has been available as of January 2022 with Emacs version 29.0.5. This flag negates the need for the package chemacs2 and its slighly more complex setup.

I made a second variant of the above alias for debugging:

alias e29ld='/Applications/Emacs29.0.5.app/Contents/MacOS/Emacs --init-directory ~/latex-emacs29 --debug-init'.

You can have multiple versions of Emacs on your system; however, you will have to match the profiles to the Emacs version because the binaries in the elpa subfolder of the latex-emacs29 folder may not run with different versions of Emacs.

No warranty is implied. Use at your own risk.

I used this configuration to prepare the presentation given to the Berlin Emacs Meetup on 31 August 2022.

LaTeX is the gold standard markup system for technical writing.

• Combine a passion for coding with writing (e.i., make writing fun by disguising it as coding).
• Code reuse: recycle old documents.
• Precise control over the appearance of the output.
• Equation typesetting par none.
• Automated scaling and placement of figures.
• Syntax highlighting of code fragments.
• Reduced use of the mouse: More ergonomic.
• Reduced context switching: Be more productive.
• Slideshows as PDFs are immune to embarrassing font issues when presenting slides on another operating system.
• Support for multi-part documents (books).
• Precise control over typesetting of the bibliography.
• Automated table of contents and list assembly.
• Automated index generation.
• Source files are compact and easy to share by e-mail.
• You can put the source files under version control.
• Overleaf supports collaborative writing.

Most markdown variants do not support the automated generation of indices for large documents. Most literate programming projects built on top of markdown have this serious limitation.

Many Emacs and package developers have developed a suite of packages over the past several decades to aid the writing of LaTeX documents. These features support efficient editing of LaTeX documents.

In addition, you can extend Emacs with the Emacs Lisp programming language. Elisp is a variant of LISP that was customized to ease the configuring of Emacs. Emacs is essentially a platform for building a customized text editor. You can customize your LaTeX environment and add functions to aid your workflow.

Of course, other text editors have these features too. However, Emacs seems to me to be the most extensible. In my opinion, it is the ultimate editor: Once you become competent at it, you will not make another editor your primary editor.

Emacs has been under development for 45 years. According to the Lindy effect, it should be available for another 45 years.

Overleaf is a web-based LaTeX editor. Overleaf is excellent for maintaining multiple writing projects and strongly supports collaborative editing. I find the Overleaf GUI to be intuitive. The compile times are several times faster on the Overleaf servers than on my computer. Overleaf also has an extensive collection of attractive documentation about LaTeX. Emacs

I have over 600s writing projects on Overleaf. These projects include grant applications, manuscripts, slideshows, and posters. It is trivial to use an old project as a template to make a new project. This saves a lot of time.

I have subscribed to the Pro license for several years and have used it for six years. I recommend the free account to anyone trying to master LaTeX. I recommend the Pro license for anyone doing collaborative writing. The Pro license also enables the use of git to make copies of your writing projects on your computer easily.

Overleaf does support Emacs keybindings. Even better, if you select the legacy mode on Overleaf, you can send the text area to Emacs for editing via the GhostText plugin for your browser and the atomic-chrome package for Emacs. You can use snippets on the Emacs side of the websocket, and they will appear immediately on the Overleaf side. My configuration for atomic-chrome is below:

;; atomic-chrome, used to interact with GhostText extension for Google Chrome.
(use-package atomic-chrome)
(atomic-chrome-start-server)
(setq atomic-chrome-default-major-mode 'python-mode)
(setq atomic-chrome-extension-type-list '(ghost-text))
;;(atomic-chrome-start-httpd)
(setq atomic-chrome-server-ghost-text-port 4001)
(setq atomic-chrome-url-major-mode-alist
      '(("github\\.com" . gfm-mode)
        ("overleaf.com" . latex-mode)
        ("750words.com" . latex-mode)))
; Select the style of opening the editing buffer by atomic-chrome-buffer-open-style.
; full: Open in the selected window.
; split: Open in the new window by splitting the selected window (default).
; frame: Create a new frame and window in it. Must be using some windowing pacakge.
(setq atomic-chrome-buffer-open-style 'split)

• The availability of the yasnippets package. You can build document templates and save them as yasnippet snippets. You then insert the document template into a new file upon entering the snippet name and hitting tab.
• Powerful macros in AUCTeX support creating and editing new documents.
• Syntax checking before compiling is available. See the keybinding lists below.
• Terse and clear bug reporting during PDF compiling.
• Preview a rendered version of a select region in the buffer. You remove the preview with a key binding. The preview allows you to check an equation's typesetting without going through the longer step of compiling the file into a PDF.

Org-mode includes support for document preparation, time management, and literate programming. Many people in the past decade were drawn to Emacs by org-mode. Org documentats can recognize LaTeX markup. Exporting an org document through LaTeX to a PDF and having that PDF open in your default PDF-viewer is seamless. However, compiling pdfs in Overleaf is more automated and even faster.

The main drawbacks for me are as follows:

• Most publishers do not accept org files, while they do accept tex files. (You can export the org file to a LaTeX file that might need heavy editing to get it accepted by the publisher.)
• Overleaf does not support the use of org files.
• Org markup adds another layer of abstraction on top of LaTeX.

I am already a LaTeX native. I do not need the crutch of org to produce tex files.

• Install packages from MELPA with use-package.
• Uses Protesilaos Stavrou's (Prot's) ef-themes package. Set to the ef-cyprus theme. The ef-light theme is good too.
• latex-mode and auctex-mode with an old autocompletion package that works,
• Keybindings remapped for macOS so Meta is cmd, Super is cap locks, and Hyper is Fn.
• Numerous keybindings from outline-mode to fold and unfold sections in a LaTeX file.
• Configured to cope with the minted package under compiling. It gets around the compile with -shell-escape command.
• Configured to use snippets from the snippets subfolder.
• Has hippieexpand enabled.
• Uses the awesome-tabs package to enable navigation between buffers via tabs. (The keybindings s-0, s-1, ..., s9 enable switching tabs from the keyboard.)
• Has the word count mode (wc-mode) enabled.
• Has pomodoro-mode.
• Has minibuffer history.
• Has ivy enabled for enhanced auto-completion selections.
• atomic-chrome configured to interact with GhostText extension for Google Chrome so you can edit in Emacs LaTeX documents on Chrome.
• Use the texcount script with C-c w to get a more accurate word count when in latex-mode.
• Move N-selected lines up and down with the meta and the arrow keys.
• Scratch buffer retained.
• Add the itemize, enumerate, and description functions to convert selected markdown lists into LaTeX itemize, description, or enumerated lists.
• Includes configuration for changing the size of the font in the modeline. This is useful for preparing slides about using Emacs.

1. git clone https://MooersLab/github.com/latex-emacs latex-emacs in your home directory.
2. Create link to your snippets folder: ln -s snippets ~/.emacs.d/snippets. This link negates the need to maintain multiple copies of the snippet libraries.
3. Edit file paths in init.el as needed. Git clone the packages stored in manual-packages.
4. Add alias e29l='/Applications/Emacs29.0.5.app/Contents/MacOS/Emacs --init-directory ~/latex-emacs29 to your .bashrc or .zshrc file so you can open Emacs with alias e29l.
5. Add the GhostText extension to Chrome or Firefox or Safari or Edge.
6. Install LaTeX and include in your PATH.
7. Edit in init.el the file path to texcount. This Perl script comes with LaTeX. You might be able to invoke texcount without the file path if you have no previously defined aliases to do texcount.

This setup can be run in versions > 29.0.5 with emacs --init-directory ~/latex-emacs29 or the alias e29l. This command ignores your default Emacs configuration in ~/.emacs.d You can run it in isolation from your default emacs configuration. It makes a nice backup system when you break the main configuration.

Create an empty text file with touch start.tex. Start Emacs and load the file. Enter C-o C-e to create a new document using the corresponding AUCTeX macro.

These keybindings are active in the latex-mode or useful in this mode.

If you are rusty or just starting to use Emacs, you need only these 23 key bindings to function in Emacs.

Vim users can turn on evil-mode to emulate vim key-bindings.

CUA keybindings (C-c, C-v, and C-x for copy, paste, and cut) can be invoked by uncommenting the code in the init.el file. However, there are conflicts with the latex keybindings. I recommend either using evil-mode or learn the essential Emacs key bindings; they are much easier to master than they look :).

The recall of key bindings fades quickly after the first encounter but improves with spaced repetitions. I have provided two sets of quizzes to improve recall: One set each set of the above key bindings. The quizzes in a set have the same questions, but I randomized their order to break up your memory of the answers that was based on the context of the question in the quiz.

• LaTeX manuscript template
• Writing log template in LaTeX
• Slideshow template in LaTeX
• Annotated bibliography Template in LaTeX
• Diary for 2022 in LaTeX
• Diary for 2023 in LaTeX
• latex-emacs profile
• snippets for latex-mode in Emacs
• Quizzes about Emacs to improve recall of keybindings
• Slides from talk about GhostText, Data Science Workshop, July 2022
• Video link to talk about GhostText, Data Science Workshop, July 2022
• The writer's law