Update emacs_newbie_fr.org - quelques typos et formulations

parent ab306cc9
...@@ -6,9 +6,10 @@ ...@@ -6,9 +6,10 @@
#+PROPERTY: header-args :eval never-export #+PROPERTY: header-args :eval never-export
Ce document présuppose que vous avez déjà installé emacs et suivi les Ce document présuppose que vous avez déjà installé emacs et suivi les
instructions données [[https://www.fun-mooc.fr/courses/course-v1:inria+41016+session02/jump_to_id/954f94ce4f9a4d858d47b41793cc96c8][ici]]. Toutes les captures d'écran utilisées dans instructions données [[https://www.fun-mooc.fr/courses/course-v1:inria+41016+session02/jump_to_id/954f94ce4f9a4d858d47b41793cc96c8][ici]].
ce document ont été faites sous Windows mais vous devriez obtenir le Toutes les captures d'écran utilisées dans ce document ont été faites sous
même genre de choses avec n'importe quel système d'exploitation. Windows mais vous devriez obtenir le même genre de choses avec n'importe quel
système d'exploitation.
* Premiers pas avec Emacs pour éditer des documents computationnels * Premiers pas avec Emacs pour éditer des documents computationnels
** Un premier document org-mode ** Un premier document org-mode
...@@ -23,16 +24,16 @@ même genre de choses avec n'importe quel système d'exploitation. ...@@ -23,16 +24,16 @@ même genre de choses avec n'importe quel système d'exploitation.
- Vous disposez maintenant d'un document org-mode vide - Vous disposez maintenant d'un document org-mode vide
- Tapez =<b= et appuyez sur =tab= pour obtenir un bloc de code shell. Vous - 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 pouvez alors écrire la commande shell de votre choix (par exemple
=dir= sous windows ou =ls= sous linux et Mac). Maintenant, faites =C-c =dir= sous Windows ou =ls= sous Linux et Mac). Maintenant, faites =C-c C-c=
C-c= (cette notation signifie appuyer deux fois de suite rapidement (cette notation signifie appuyer deux fois de suite rapidement
sur les touches =Ctrl= et =c=). Votre commande shell devrait avoir été 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. exécutée et la sortie devrait avoir été mise juste en dessous.
#+BEGIN_CENTER #+BEGIN_CENTER
[[file:emacs_orgmode_images/shell.png]] [[file:emacs_orgmode_images/shell.png]]
#+END_CENTER #+END_CENTER
- Si jamais vous avez l'impression qu'emacs est entré dans un mode un - Si jamais vous avez l'impression qu'Emacs est entré dans un mode un
peu étrange suite à un raccourci clavier malencontreux, faites peu étrange suite à un raccourci clavier malencontreux, faites
plusieurs fois de suite =C-g= (une fois de plus, cela signifie appuyer plusieurs fois de suite =C-g= (à nouveau, cela signifie appuyer
sur les touches =Ctrl= et =g=). sur les touches =Ctrl= et =g=).
** Exécuter du code R ** Exécuter du code R
- De la même façon que le raccourci =<b= que nous venons de présenter - De la même façon que le raccourci =<b= que nous venons de présenter
...@@ -45,7 +46,7 @@ même genre de choses avec n'importe quel système d'exploitation. ...@@ -45,7 +46,7 @@ même genre de choses avec n'importe quel système d'exploitation.
[[file:emacs_orgmode_images/commandeR1.png]] [[file:emacs_orgmode_images/commandeR1.png]]
#+END_CENTER #+END_CENTER
Normalement, Emacs vous demandera alors où il doit lancer Normalement, Emacs vous demandera alors où il doit lancer
R. Conservez alors la proposition d'utiliser le répertoire courrant R. Conservez alors la proposition d'utiliser le répertoire courant
en appuyant sur la touche =Entrée=. À nouveau, la sortie devrait être en appuyant sur la touche =Entrée=. À nouveau, la sortie devrait être
capturée et insérée juste en dessous. capturée et insérée juste en dessous.
#+BEGIN_CENTER #+BEGIN_CENTER
...@@ -56,7 +57,7 @@ même genre de choses avec n'importe quel système d'exploitation. ...@@ -56,7 +57,7 @@ même genre de choses avec n'importe quel système d'exploitation.
code R adaptés au cas où vos commandes R génèrent des images. Le 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 =(org-babel-temp-file \"figure\" \".png\")= génère un nom de fichier
temporaire à chaque exécution. Ce fichier sera donc effacé lorsque temporaire à chaque exécution. Ce fichier sera donc effacé lorsque
vous fermerez emacs. Si vous souhaitez que vos images soient vous fermerez Emacs. Si vous souhaitez que vos images soient
conservées d'une fois sur l'autre, indiquez un vrai nom de fichier à conservées d'une fois sur l'autre, indiquez un vrai nom de fichier à
la place. la place.
#+BEGIN_CENTER #+BEGIN_CENTER
...@@ -69,30 +70,30 @@ même genre de choses avec n'importe quel système d'exploitation. ...@@ -69,30 +70,30 @@ même genre de choses avec n'importe quel système d'exploitation.
=(org-babel-temp-file \"figure\" \".png\")= par =\"D:/temp/figure.png\"= =(org-babel-temp-file \"figure\" \".png\")= par =\"D:/temp/figure.png\"=
ou tout autre endroit/nom de fichier que vous préféreriez. ou tout autre endroit/nom de fichier que vous préféreriez.
** Exécuter du code Python ** Exécuter du code Python
- Vous pourriez trouver utile de lire la page [[https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-python.html][Python Source Code Blocks - Vous trouverez quelques exemples sur la page [[https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-python.html][Python Source Code Blocks
in Org Mode]] pour avoir quelques exemples. in Org Mode]].
- Le raccourci =<p= + =tab= permet d'insérer un block de code python en - 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 mode /non-session/. Cela signifie qu'un nouvel interpréteur Python est
lancé à chaque fois pour ce block et que les variables ne seront pas lancé pour chaque bloc et que les variables ne seront pas partagées
partagées entre les blocs. Comme d'habitude, le code sera exécuté à entre les blocs. Comme d'habitude, le code sera exécuté à l'aide de la
l'aide de la séquence de touches =C-c C-c=. séquence de touches =C-c C-c=.
#+BEGIN_CENTER #+BEGIN_CENTER
[[file:emacs_orgmode_images/commande_python.png]] [[file:emacs_orgmode_images/commande_python.png]]
#+END_CENTER #+END_CENTER
#+BEGIN_CENTER #+BEGIN_CENTER
[[file:emacs_orgmode_images/python1.png]] [[file:emacs_orgmode_images/python1.png]]
#+END_CENTER #+END_CENTER
# Note that if python was not correctly installed, you may end up with # Note that if Python was not correctly installed, you may end up with
# a message like this: # a message like this:
# #+BEGIN_CENTER # #+BEGIN_CENTER
# [[file:emacs_orgmode_images/python3.png]] # [[file:emacs_orgmode_images/python3.png]]
# #+END_CENTER # #+END_CENTER
# Then try to follow the steps in the installation section. # Then try to follow the steps in the installation section.
- Le raccourci =<P= + =tab= permet d'insérer un bloc de code Python, mais - 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 cette fois-ci en mode /session/. Cela permet de conserver les
variables et leurs valeurs d'un bloc sur l'autre. En interne et en 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 arrière-plan, Emacs aura un buffer avec une session Python en cours
d'exécution. Comme d'habitude, le code sera exécuté à d'exécution. Comme d'habitude, le code sera exécuté à
l'aide de la séquence de touches =C-c C-c=. l'aide de la séquence de touches =C-c C-c=.
#+BEGIN_CENTER #+BEGIN_CENTER
...@@ -100,13 +101,13 @@ même genre de choses avec n'importe quel système d'exploitation. ...@@ -100,13 +101,13 @@ même genre de choses avec n'importe quel système d'exploitation.
#+END_CENTER #+END_CENTER
- Enfin, le raccourci =<PP= + =tab= vous permettra d'insérer un bloc - Enfin, le raccourci =<PP= + =tab= vous permettra d'insérer un bloc
python en mode /session/ spécialement adapté à la production de graphiques Python en mode /session/ spécialement adapté à la production de graphiques
#+BEGIN_CENTER #+BEGIN_CENTER
[[file:emacs_orgmode_images/python4.png]] [[file:emacs_orgmode_images/python4.png]]
#+END_CENTER #+END_CENTER
Si vous rencontrez un problème, essayez de mettre à jour la Si vous rencontrez un problème, essayez de mettre à jour la
bibliothèque Python =numpy=, par exemple à l'aide de =pip= dans une bibliothèque Python =numpy=, par exemple à l'aide de =pip= dans une
commande dos/shell: commande dos/shell :
#+begin_src shell :results output :exports both #+begin_src shell :results output :exports both
python -m pip install -U numpy python -m pip install -U numpy
#+end_src #+end_src
...@@ -114,10 +115,10 @@ même genre de choses avec n'importe quel système d'exploitation. ...@@ -114,10 +115,10 @@ même genre de choses avec n'importe quel système d'exploitation.
** Le journal ** Le journal
- Ouvrez le fichier =journal.org= que vous devriez avoir placé dans le - Ouvrez le fichier =journal.org= que vous devriez avoir placé dans le
répertoire =~/org/=. Vous y trouverez au tout début quelques répertoire =~/org/=. Vous y trouverez au tout début quelques
"vieilles" entrées avec les raccourcis clavier emacs les plus "vieilles" entrées avec les raccourcis clavier Emacs les plus
utiles, dont ceux que nous venons de vous présenter au dessus. utiles, dont ceux que nous venons de vous présenter ci-dessus.
** Prendre des notes ** Prendre des notes
- Le raccourci =C-c c= (attention, pas =C-c C-c=, mais =Ctrl c= puis =c=) - 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 ouvrira un menu vous demandant si vous souhaitez prendre des notes
dans votre todo list ou dans votre journal. dans votre todo list ou dans votre journal.
#+BEGIN_CENTER #+BEGIN_CENTER
...@@ -127,22 +128,23 @@ même genre de choses avec n'importe quel système d'exploitation. ...@@ -127,22 +128,23 @@ même genre de choses avec n'importe quel système d'exploitation.
- Appuyez sur =j= pour prendre des notes dans votre journal. Emacs va - 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, 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 une entrée avec la date du jour et va vous présenter un mini buffer
dans le quel vous allez pouvoir prendre vos notes. dans lequel vous allez pouvoir prendre vos notes.
#+BEGIN_CENTER #+BEGIN_CENTER
[[file:emacs_orgmode_images/org_mode.png]] [[file:emacs_orgmode_images/org_mode.png]]
#+END_CENTER #+END_CENTER
Lorsque vous avez fini, faites simplement =C-c C-c= pour sauvegarder Lorsque vous avez fini, faites simplement =C-c C-c= pour sauvegarder
vos modifications et fermer le mini-buffer. vos modifications et fermer le mini-buffer.
** Édition d'un document org ** Édition d'un document org
- Il est courrant lorsque l'on prend des notes dans une session de - Il est courant lorsque l'on prend des notes dans une session de
brainstorming de devoir les nettoyer et les réorganiser. Les brainstorming de devoir les nettoyer et les réorganiser. Les raccourcis
raccourcis =Alt= + =\leftarrow= et =Alt= + =\rightarrow= vous permettrons de =Alt= + =\leftarrow= et =Alt= + =\rightarrow= vous permettront de
décaler les entrées vers la gauche ou vers la droite. Pareil pour décaler les entrées vers la gauche ou vers la droite. Pareil pour
vers le haut ou vers le bas... vers le haut ou vers le bas...
- Les raccourcis Org-mode sont en fait bien plus intuitifs que les - Les raccourcis Org-mode sont en fait bien plus intuitifs que les
raccourcis (pré-)historiques d'emacs. Vous devriez vite vous y faire. raccourcis (pré-)historiques d'Emacs. Vous devriez vite vous y faire.
Encore une fois, regarder bien la première entrée de votre Encore une fois, regardez bien la première entrée de votre
=journal.org=. Nous y avons mis les raccourcis et les ruses les plus =journal.org=. Nous y avons mis les raccourcis et les ruses les plus
essentiel(le)s. essentiel(le)s.
- N'oubliez pas de sauvegarder vos fichiers avant de fermer emacs. - N'oubliez pas de sauvegarder vos fichiers avant de fermer Emacs.
Amusez vous bien!
Amusez-vous bien !
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment