Débute la section AUCTeX

Tutoriel.org

@@ -561,21 +561,20 @@ en choisissant le dictionnaire adéquate ou en définissant une variable
 locale dans le /buffer/ pour que ce changement intervienne à chaque
 fois que le fichier sera ouvert. Par exemple en LaTeX, on pourra
 mettre le bloc suivant en fin de fichier.
-#+header: :eval "no"
-#+BEGIN_SRC emacs-lisp
+#+BEGIN_SRC emacs-lisp :exports code
   % Local Variables:
   % ispell-local-dictionary: "francais"
   % End:
 #+END_SRC
 Pour désactiver le ~flyspell~ dans un fichier, on peut utiliser la
 configuration locale. Par exemple en ~Python~, on écrit
-#+BEGIN_SRC python
+#+BEGIN_SRC python :export code
   # Local Variables:
   # eval: (flyspell-mode -1)
   # End:
 #+END_SRC
 
-*** Flycheck
+*** FlyCheck
 Ce mode mineur permet de vérifier la validité du code à la volée. Il
 fonctionne pour les langages LaTeX, ~C++~, ~Python~, les scripts
 ~shell~,...
@@ -585,7 +584,7 @@ compilation est très légère. Il est cependant possible de le déactiver
 localement dans un /buffer/, soit en utilisant la commande
 ~M-x flycheck-mode~, soit en définissant une variable locale. En
 ~C++~, on peut par exemple utiliser
-#+BEGIN_SRC c++
+#+BEGIN_SRC c++ :exports code
   // Local Variables:
   // eval: (flycheck-mode -1)
   // End:
@@ -651,6 +650,102 @@ plus utiles. L'aide en ligne, accessible donnée par ~h~ est très
 complète. Il est par exemple très facile de choisir quelques lignes à
 ajouter (/stager/) en sélectionnant une zone.
 
+** Rédaction de documents LaTeX
+La rédaction d'un document LaTeX s'apparente plus à de la
+programmation qu'à de l'édition simple de fichiers. De nombreux outils
+existent maintenant pour éditer des documents LaTeX, mais il est
+également possible de bénéficier de la puissance d'Emacs et de
+nombreuses années d'expériences qui ont permis le développement de
+modes qui permettent une excellente intégration Emacs/LaTeX.
+
+Avant de décrire les principaux modes, rappelons que cette
+configuration utilise ~FlyCheck~ de sorte que les erreurs de syntaxe
+LaTeX sont indiquées à la saisie, ce qui facilite grandement
+l'écriture.
+
+*** AUCTeX
+[[https://www.gnu.org/software/auctex/?lang=fr][AUCTeX]] est un ensemble de macros Emacs qui permet d'éditer facilement
+(et efficacement) des fichiers LaTeX. C'est le mode qui offre la
+plupart des fonctionnalités utiles à l'édition LaTeX.
+
+Nous rappelons ici quelques raccourcis de base. Pour aller accéder à
+la documentation complète d'~AUCTeX~, on peut parcourir l'aide
+intégrée d'Emacs en tapant ~C-h i~ et en consultant la rubrique qui
+lui est associée.
+
+On ne va ici décrire que les raccourcis les plus utiles.
+**** Typographie
+Pour les changements de styles typographiques, tous les raccourcis
+débutent par la séquence ~C-c C-f~.  Le changement de fonte dépend du
+contexte de saisie~: texte ou mathématique. Noter que si on saisit
+~C-c C-f~ suivit de n'importe quel caractère Emacs affiche la liste
+des possibilités.
+| Raccourcis    | Style             | Comm. (texte) | Style             | Comm. (math)  |
+|---------------+-------------------+---------------+-------------------+---------------|
+| ~C-c C-f C-a~ | --                | --            | calligraphique    | =\mathcal=    |
+| ~C-c C-f C-b~ | gras              | =\textbf=     | gras              | =\mathbf=     |
+| ~C-c C-f C-c~ | petites capitales | =\textsc=     | --                | --            |
+| ~C-c C-f C-e~ | emphase           | =\emph=       | emphase           | =\emph=       |
+| ~C-c C-f C-f~ | sans serif        | =\textsf=     | sans serif        | =\mathsf=     |
+| ~C-c C-f TAB~ | italique          | =\textit=     | italique          | =\mathit=     |
+| ~C-c C-f C-n~ | normal            | =\textnormal= | normal            | =\mathnormal= |
+| ~C-c C-f C-r~ | roman             | =\textrm=     | roman             | =\mathrm=     |
+| ~C-c C-f C-s~ | penché            | =\textsl=     | symbole           | =\mathbb=     |
+| ~C-c C-f C-t~ | machine à écrire  | =\texttt=     | machine à écrire  | =\mathtt=     |
+| ~C-c C-f C-d~ | supprime le style | --            | supprime le style | --            |
+| ~C-c C-f C-k~ | --                | --            | eufrak            | =\mathfrak=   |
+Noter que si une région est sélectionnée, la commande est appliquée à
+la région, sinon, le curseur est positionné entre les accolades.
+
+Enfin, si on préfixe les raccourcis précédents par ~C-u~ alors, le
+style est remplacé par le style demandé. Par exemple, si on avait le
+texte suivant
+#+header: :exports code
+#+BEGIN_SRC latex
+  \emph{Un texte}
+#+END_SRC
+si on utilise la commande ~C-u C-c C-f C-b~, il sera transformé en
+#+header: :exports code
+#+BEGIN_SRC latex
+\textbf{Un texte}
+#+END_SRC
+
+**** Sections
+AUCTeX propose moyen de créer les éléments structurants du
+document.
+| Raccourci | Description      |
+|-----------+------------------|
+| ~C-c C-s~ | Crée une section |
+Une fois ce raccourci utilisé, une interaction dans le /minibuffer/
+permet d'entrer son titre et éventuellement le label à lui attribuer.
+Comme toujours en LaTeX, il est recommandé d'indiquer des noms
+explicites. On préférera utiliser le caractère ~-~ plutôt que ~_~ pour
+éventuellement séparer les termes qui composent le label.
+
+**** Environnements
+De la même manière, on écrit des environnements simplement en
+utilisant des raccourcis.
+| Raccourci | Description             |
+|-----------+-------------------------|
+| ~C-c C-e~ | Ajoute un environnement |
+Ici encore, quand le raccourci a été utilisé, les environnements
+possibles sont proposés dans le /minibuffer/ et éventuellement, on
+propose de saisir un label.
+
+Comme dans le cas des changements typographiques, si une région était
+sélectionnée, les balises ~begin~ et ~end~ entourent la zone. Sinon,
+le curseur est placé entre les balises.
+
+**** Compilation et visualisation
+| Raccourci | Description |
+|-----------+-------------|
+| ~C-c C-c~ |             |
+
+*** RefTeX
+*** BibTeX
+*** Pdf-tools
+*** Preview-LaTeX
+
 * Pour aller plus loin
 
 ** Pliage et dépliage avec ~narrow-or-widen-dwim~
@@ -672,8 +767,8 @@ avoir à se préoccuper de leur impact hors de la région. Un bon exemple
 est l'utilisation d'une macro clavier.
 
 Dans cette configuration, on utilise ~narrow-or-widen-dwim~ qui
-simplifie la sélection des régions à éditer, c'est l'effet /dwin/ :
-/Do What I Mean/.
+simplifie la sélection des régions à éditer, c'est l'effet /dwin/ (/Do
+What I Mean/).
 
 Un seul raccourci est nécessaire à l'activation du pliage ou du
 dépliage d'une zone.