Petit guide du plugin AUCTeX pour Emacs

AUCTeX est un module complémentaire pour Emacs. Il facilite l'écriture et le formatage des fichiers TeX (dont LaTeX). Il est écrit en Emacs Lisp.

Installation

GNU Emacs n'intègre pas AUCTeX. XEmacs l'intégre dans sa propre version.

Installation de LaTeX

Avec un gestionnaire de paquets

Les paquets utiles sont :

• texlive-latex-base : LaTeX
• latekmk : "compile" plus facilement des fichiers LaTeX que latex et pdflatex
• lacheck : vérifie en partie la syntaxe d'un fichier LaTeX
• texlive-latex-recommended : qui sous Debian a notamment une dépendance à beamer pour faire des diaporamas

Microsoft Windows

MiKTeX est une distribution libre de LaTeX facile à utiliser pour Microsoft Windows.

Installation de AUCTeX

Avec un gestionnaire de paquets

Celui intégré à GNU Emacs

Le gestionnaire de paquets de GNU Emacs est disponible depuis la version 24. Le paquet se nomme assez logiquement "auctex". La commande pour installer un paquet est M-x package-install (avec M correspondant à la touche Meta, généralement Alt).

Advanced Packaging Tool

APT est le gestionnaire de paquets par défaut de Debian et ses dérivés (dont Trisquel, Ubuntu et Mint).

• apt install auctex
• apt-get install auctex
• aptitude install auctex

pacman

pacman est le gestionnaire de paquets par défaut de ArchLinux et ses dérivés (dont Parabola).
pacman -S auctex

Yellowdog Updater Modified

yum est le gestionnaire de paquets de Fedora et ses dérivés (dont CentOS).
yum install emacs-auctex

Configuration

La configuration se fait dans le fichier ".emacs" en Emacs Lisp. Il se trouve normalement dans votre dossier personnel, qui sous un système UNIX-like (comme une distribution GNU/Linux ou un *BSD) est facilement accessible avec "~/.emacs" ou "$HOME/.emacs".

• (require 'tex) : pour être sur d'avoir le mode TeX
• (require 'latex) : pour être sur d'avoir le mode LaTeX
• (require 'auctex) ne marche pas
• (setq TeX-PDF-mode t) : pour produire un PDF par défaut

Pour utiliser la nouvelle configuration, chargez votre .emacs avec M-x load-file ou redémarrez Emacs.

Ouvrir un PDF

Dans Emacs

• Command > View
• M-x TeX-view
• C-c C-c (avec C majuscule correspondant à la touche Control)

Dans un shell texte UNIX

• xdg-open mon-document.pdf ouvre le PDF avec le lecteur PDF par défaut
• my-pdf-reader mon-document.pdf ouvre le PDF avec my-pdf-reader à remplacer par le lecteur PDF de votre choix (comme evince ou okular)

Quelques plugins utiles avec AUCTeX

L'auto-complétion

Un système d'auto-complétion vous propose un complément à ce que vous avez déjà écrit, si le système "devine" au moins un complément. Bien entendu, c'est un système très pratique pour les fainéant·e·s et pour trouver des possibiltés que le système d'auto-complétion peut deviner mais que vous ne connaissiez pas.

Pour avoir ce système dans Emacs, il faut installer auto-complete. Malheureusement, le TeX n'est pas par défaut géré, pour corriger ce manque il y a auto-complete-auctex.

Ce système peut être combiné avec ido (Interactively DO things) qui est disponible à partir de GNU Emacs 22.

Affichage plus convivial

magic-latex-buffer permet un afficahe plus convivial des buffers LaTeX. Il peut par exemple afficher les symboles désignés par les macros. Après installation, un buffer LaTeX peut être rendu "magique" avec M-x magic-latex-buffer. Il est également possible que les buffers LaTeX soient magiques par défaut en ajoutant (add-hook 'latex-mode-hook 'magic-latex-buffer) à son fichier de configuration.

LaTeX make

Pour que AUCTeX prenne en charge latekmk, il faut installer le plugin auctex-latexmk. Après le téléchargement, dans le fichier de configuration, il faut ajouter :
(require 'auctex-latexmk)
(auctex-latexmk-setup)

Ajout d'un sous-menu pour les unités au menu du mode math

Il est possible d'ajouter un menu "Math" au mode LaTeX avec M-x LaTeX-math-mode. Celui-ci peut être activé par défaut avec (add-hook 'LaTeX-mode-hook 'LaTeX-math-mode) dans le fichier de configuration.

latex-units permet de rajouter un sous-menu pour les unités au menu "Math".

Synchronisation avec Zotero

Zotelo exporte les fichiers de Zotero pour les utiliser dans différents formats (dont BibTeX et BibLaTeX).