From 0f2cd32529cd73fb596b4216a7ac32004803b9bb Mon Sep 17 00:00:00 2001
From: Stephane Del Pino <stephane.delpino44@gmail.com>
Date: Sat, 4 Apr 2020 11:16:54 +0200
Subject: [PATCH] =?UTF-8?q?D=C3=A9bute=20la=20section=20AUCTeX?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
Tutoriel.org | 113 +++++++++++++++++++++++++++++++++++++++++++++++----
1 file changed, 104 insertions(+), 9 deletions(-)
diff --git a/Tutoriel.org b/Tutoriel.org
index 804f747..a1fa891 100644
--- a/Tutoriel.org
+++ b/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:
@@ -637,8 +636,8 @@ des nouveaux raccourcis très simples.
| Raccourci ~Magit~ | Description |
|-------------------+---------------------------------------------------------|
| ~h~ | Affiche l'aide en ligne |
-| ~TAB~ | (dé)plie la zone du curseur |
-| ~RET~ | Affiche la zone du curseur |
+| ~TAB~ | (dé)plie la zone du curseur |
+| ~RET~ | Affiche la zone du curseur |
| ~g~ | Rafraîchit le /buffer/ |
| ~s~ | /Stage/ des modifications (=git add=) |
| ~u~ | /Unstage/ des modifications |
@@ -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.
--
GitLab