Ce document présuppose que vous avez déjà installé Emacs et suivi les instructions données ici. Toutes les captures d'écran utilisées dans ce document ont été faites sous Windows mais vous devriez obtenir le même genre de choses avec n'importe quel système d'exploitation.
Lancez Emacs
Créez un nouveau fichier à l'aide de la petite icône en forme de "feuille de papier" en haut à gauche, juste en dessous du menu File
. Placez le dans le répertoire de votre choix et nommez le toto.org
.
Vous disposez maintenant d'un document org-mode vide
Tapez <b
et appuyez sur tab
pour obtenir un bloc de code shell. Vous pouvez alors écrire la commande shell de votre choix (par exemple dir
sous Windows ou ls
sous Linux et Mac). Maintenant, faites C-c C-c
(cette notation signifie appuyer deux fois de suite rapidement sur les touches Ctrl
et c
). Votre commande shell devrait avoir été exécutée et la sortie devrait avoir été mise juste en dessous.
Si jamais vous avez l'impression qu'Emacs est entré dans un mode un peu étrange suite à un raccourci clavier malencontreux, faites plusieurs fois de suite C-g
(à nouveau, cela signifie appuyer sur les touches Ctrl
et g
).
De la même façon que le raccourci <b
que nous venons de présenter permet d'insérer des blocs de commandes shell, le raccourci <r
+ tab
vous permettra d'insérer des blocs de commandes R (par exemple summary(cars)
). Toujours pareil, le code est exécuté à l'aide de la séquence de touches C-c C-c
(appuyer deux fois de suite sur les touches Ctrl
et c
).
Normalement, Emacs vous demandera alors où il doit lancer R. Conservez alors la proposition d'utiliser le répertoire courant en appuyant sur la touche Entrée
. À nouveau, la sortie devrait être capturée et insérée juste en dessous.
Le raccourci clavier <R
+ tab
vous permettra d'insérer des blocs de code R adaptés au cas où vos commandes R génèrent des images. Le (org-babel-temp-file \"figure\" \".png\")
génère un nom de fichier temporaire à chaque exécution. Ce fichier sera donc effacé lorsque vous fermerez Emacs. Si vous souhaitez que vos images soient conservées d'une fois sur l'autre, indiquez un vrai nom de fichier à la place.
Si ce comportement de noms de fichiers temporaires ne vous convient pas, il vous suffit d'éditer votre fichier de configuration init.el
et de remplacer les occurrences (pour <R
et <PP
) de (org-babel-temp-file \"figure\" \".png\")
par \"D:/temp/figure.png\"
ou tout autre endroit/nom de fichier que vous préféreriez.
Vous trouverez quelques exemples sur la page Python Source Code Blocks in Org Mode.
Le raccourci <p
+ tab
permet d'insérer un bloc de code Python en mode non-session. Cela signifie qu'un nouvel interpréteur Python est lancé pour chaque bloc et que les variables ne seront pas partagées entre les blocs. Comme d'habitude, le code sera exécuté à l'aide de la séquence de touches C-c C-c
.
Le raccourci <P
+ tab
permet d'insérer un bloc de code Python, mais cette fois-ci en mode session. Cela permet de conserver les variables et leurs valeurs d'un bloc à l'autre. En interne et en arrière-plan, Emacs aura un buffer avec une session Python en cours d'exécution. Comme d'habitude, le code sera exécuté à l'aide de la séquence de touches C-c C-c
.
Enfin, le raccourci <PP
+ tab
vous permettra d'insérer un bloc Python en mode session spécialement adapté à la production de graphiques
Si vous rencontrez un problème, essayez de mettre à jour la bibliothèque Python numpy
, par exemple à l'aide de pip
dans une commande dos/shell :
python -m pip install -U numpy
journal.org
que vous devriez avoir placé dans le répertoire ~/org/
. Vous y trouverez au tout début quelques "vieilles" entrées avec les raccourcis clavier Emacs les plus utiles, dont ceux que nous venons de vous présenter ci-dessus.Le raccourci C-c c
(attention, pas C-c C-c
, mais C-c
puis c
) ouvrira un menu vous demandant si vous souhaitez prendre des notes dans votre todo list ou dans votre journal.
Appuyez sur j
pour prendre des notes dans votre journal. Emacs va alors ouvrir votre fichier journal.org
pour y créer, à la toute fin, une entrée avec la date du jour et va vous présenter un mini buffer dans lequel vous allez pouvoir prendre vos notes.
Lorsque vous avez fini, faites simplement C-c C-c
pour sauvegarder vos modifications et fermer le mini-buffer.
Alt
+ \leftarrow
et Alt
+ \rightarrow
vous permettront de décaler les entrées vers la gauche ou vers la droite. Pareil pour vers le haut ou vers le bas…journal.org
. Nous y avons mis les raccourcis et les ruses les plus essentiel(le)s.Amusez-vous bien !