Fait quelques ajustements et début d'un petit tutoriel

.gitignore

@@ -12,3 +12,4 @@ auto-save-list
 /transient/
 /.python-environments/
 /elpy/
+/Readme.tex

Readme.org

 #+STARTUP: org-pretty-entities entitiespretty
 #+PROPERTY: header-args :comments yes :results silent
+#+options: h:1 num:nil toc:nil
 
 * Installation
 L'installation la plus simple de cette configuration se résume à
@@ -16,26 +17,22 @@ cette optimisation ajouter les alias suivants à votre shell
   alias kill-emacs="emacsclient -q -e '(let ((last-nonmenu-event nil))(save-buffers-kill-emacs))'"
 #+END_SRC
 
-* Tutoriels de M. Zamansky
-Cette configuration d'Emacs est grandement (et librement) inspirée de
-celle proposée par Mike Zamansky.
-
-Pour une excellente série tutoriels ainsi que la construction pas a
-pas de configurations, voir ci-dessous
-#+begin_verse
-For a list of all posts and videos check out
-[[http://cestlaz.github.io/stories/emacs]]
+* Premiers pas avec Emacs
+Emacs est bien plus qu'un éditeur de texte. C'est un véritable
+environnement de travail dont la tâche ne se réduit pas à la
+programmation.
 
-                      -- Mike Zamansky
-#+end_verse
+On fournit un [[Tutoriel.org]] qui n'a pour but que de donner quelques
+liens utiles et rappeler les principes de base et quelques raccourcis.
 
-* Choix d'interface
-** Pas d'écran de bienvenue
+* Configuration
+** Choix d'interface
+*** Pas d'écran de bienvenue
 #+BEGIN_SRC emacs-lisp
   (setq inhibit-startup-message t)
 #+END_SRC
 
-** Augumente la mémoire pour le "garbage collector" => meilleures perfs
+*** Augumente la mémoire pour le /garbage collector/ \rArr meilleures performances
 #+BEGIN_SRC emacs-lisp
   (setq gc-cons-threshold 64000000)
   (add-hook 'after-init-hook
@@ -44,17 +41,17 @@ For a list of all posts and videos check out
                 (setq gc-cons-threshold 800000)))
 #+END_SRC
 
-** Pas de toolbar
+*** Pas de toolbar
 #+BEGIN_SRC emacs-lisp
   (tool-bar-mode -1)
 #+END_SRC
 
-** Réponses par y ou n
+*** Réponses par y ou n
 #+BEGIN_SRC emacs-lisp
   (fset 'yes-or-no-p 'y-or-n-p)
 #+END_SRC
 
-** Commentaires
+*** Commentaires
 | Raccourci | Description                       |
 |-----------+-----------------------------------|
 | ~C-c ;~   | Commente ou décommente une région |
@@ -62,17 +59,17 @@ For a list of all posts and videos check out
   (global-set-key (kbd "C-c ;") 'comment-or-uncomment-region)
 #+END_SRC
 
-** Affiche aussi le numéro de colone
+*** Affiche aussi le numéro de colone
 #+BEGIN_SRC emacs-lisp
   (setq column-number-mode t)
 #+END_SRC
 
-** Désactive l'auto-save
+*** Désactive l'auto-save
 #+BEGIN_SRC emacs-lisp
   (setq auto-save-default nil)
 #+END_SRC
 
-** Auto-fill
+*** Auto-fill
 Utilise l'auto-fill
 #+BEGIN_SRC emacs-lisp
   (turn-on-auto-fill)
@@ -82,7 +79,7 @@ Utilise l'auto-fill
   (add-hook 'prog-mode-hook (lambda () (auto-fill-mode -1)))
 #+END_SRC
 
-** Supression des blancs inutiles
+*** Supression des blancs inutiles
 On retire les blancs qui traînent en fin de ligne à la sauvegarde d'un
 buffer
 #+BEGIN_SRC emacs-lisp
@@ -92,11 +89,11 @@ buffer
                 (delete-trailing-whitespace))))
 #+END_SRC
 
-** Affichage de la fonction courante
+*** Affichage de la fonction courante
 #+BEGIN_SRC emacs-lisp
   (which-function-mode t)
 #+END_SRC
-* Powerline
+** Powerline
 Un bel affichage pour la barre d'état (=mode-line=)
 #+BEGIN_SRC emacs-lisp
   (use-package powerline
@@ -104,21 +101,21 @@ Un bel affichage pour la barre d'état (=mode-line=)
     :config (powerline-default-theme))
 #+END_SRC
 
-* Try
+** Try
 Permet d'essayer des paquets (sans les installer de manère permanente)
 #+BEGIN_SRC emacs-lisp
   (use-package try
     :ensure t)
 #+END_SRC
 
-* Posframe
+** Posframe
 Affiche des boites de dialogue
 #+BEGIN_SRC emacs-lisp
   (use-package posframe
     :ensure t)
 #+END_SRC
 
-* Which key
+** Which key
 Aide en ligne pour les raccourcis (/quelle touche ?/)
 #+BEGIN_SRC emacs-lisp
     (use-package which-key
@@ -127,7 +124,7 @@ Aide en ligne pour les raccourcis (/quelle touche ?/)
       (which-key-mode))
 #+END_SRC
 
-* Org mode
+** Org mode
 Org bullets makes things look pretty
 #+BEGIN_SRC emacs-lisp
   (use-package org
@@ -180,7 +177,7 @@ Org bullets makes things look pretty
   (setq org-ditaa-jar-path "/usr/share/ditaa/ditaa.jar")
 #+END_SRC
 
-* Ace window
+** Ace window
 Permet de changer facilement de fenêtre.  S'il y a plus de deux
 buffers leur numéros sont affichés et il suffit de taper le numéro de
 la fenêtre choisie pour s'y rendre.
@@ -201,7 +198,7 @@ la fenêtre choisie pour s'y rendre.
       ))
 #+END_SRC
 
-* Ivy / Counsel
+** Ivy / Counsel
 Interface de complétion
 #+BEGIN_SRC emacs-lisp
   (use-package counsel
@@ -222,7 +219,7 @@ Interface de complétion
     (setq ivy-display-style 'fancy))
 #+END_SRC
 
-* Swiper
+** Swiper
 Améliore la recherche incrémentale. Les raccourcis sont les raccourcis
 classiques. Deux différences notables.
 - ~<SPC>~ joue le rôle de joker:
@@ -255,7 +252,7 @@ classiques. Deux différences notables.
     ))
 #+END_SRC
 
-* Avy
+** Avy
 Saute très rapidement vers la zone de texte contenant une lettre.
 | Raccourci | Description                         |
 |-----------+-------------------------------------|
@@ -266,7 +263,7 @@ Saute très rapidement vers la zone de texte contenant une lettre.
     :bind ("M-s" . avy-goto-word-1))
 #+END_SRC
 
-* Company
+** Company
 Boites de dialogue pour la complétion
 #+BEGIN_SRC emacs-lisp
   (use-package company
@@ -293,9 +290,9 @@ Boites de dialogue pour la complétion
   (add-hook 'python-mode-hook 'my/python-mode-hook)
 #+END_SRC
 
-* C++
+** C++
 Transforme Emacs en un véritable IDE en utilisant Irony
-** On branche Irony à Company
+*** On branche Irony à Company
 #+BEGIN_SRC emacs-lisp
   (use-package company-irony
     :ensure t
@@ -303,7 +300,7 @@ Transforme Emacs en un véritable IDE en utilisant Irony
     (add-to-list 'company-backends 'company-irony))
 #+END_SRC
 
-** On active Irony pour le C++
+*** On active Irony pour le C++
 #+BEGIN_SRC emacs-lisp
   (use-package irony
     :ensure t
@@ -313,7 +310,7 @@ Transforme Emacs en un véritable IDE en utilisant Irony
     (add-hook 'irony-mode-hook 'irony-cdb-autosetup-compile-options))
 #+END_SRC
 
-** Eldoc / Irony
+*** Eldoc / Irony
 Affiche la documentation des objets/functions dans le minibuffer
 #+BEGIN_SRC emacs-lisp
   (use-package irony-eldoc
@@ -322,7 +319,7 @@ Affiche la documentation des objets/functions dans le minibuffer
     (add-hook 'irony-mode-hook #'irony-eldoc))
 #+END_SRC
 
-** Formatage automatique : clang-format
+*** Formatage automatique : clang-format
 Création d'un raccourci spécial pour formater une zone du code.
 | Raccourci | Description                                      |
 |-----------+--------------------------------------------------|
@@ -353,7 +350,7 @@ Force le formatage du fichier quand il est sauvgardé
   (add-hook 'c-mode-common-hook 'clang-format-buffer-on-save)
 #+END_SRC
 
-** Coloration syntaxique (C++ moderne)
+*** Coloration syntaxique (C++ moderne)
 #+BEGIN_SRC emacs-lisp
   (use-package modern-cpp-font-lock
     :ensure t
@@ -365,7 +362,7 @@ Force le formatage du fichier quand il est sauvgardé
     :config (modern-c++-font-lock-global-mode t))
 #+END_SRC
 
-* Themes
+** Themes
 Préchargement de quelques themes
 #+BEGIN_SRC emacs-lisp
   (use-package cloud-theme :ensure t)
@@ -382,7 +379,7 @@ Chargement d'un theme
   (load-theme 'sourcerer t)
 #+END_SRC
 
-* Modeline
+** Modeline
 Augmente la taille de la police
 #+BEGIN_SRC emacs-lisp
   (defvar my-font-size 140)
@@ -411,7 +408,7 @@ Taille de la fenêtre et position
           ))
 #+END_SRC
 
-* Parenthèses arc-en-ciel
+** Parenthèses arc-en-ciel
 Améliore le visuel des parenthèses
 #+BEGIN_SRC emacs-lisp
   (use-package rainbow-delimiters
@@ -423,7 +420,7 @@ Améliore le visuel des parenthèses
     (add-hook 'prog-mode-hook #'rainbow-delimiters-mode))
 #+END_SRC
 
-* Flycheck
+** Flycheck
 On branche flycheck à Irony
 #+BEGIN_SRC emacs-lisp
   (use-package flycheck-irony
@@ -445,7 +442,7 @@ Active flycheck globalement
 #+BEGIN_SRC
   (add-hook 'after-init-hook #'global-flycheck-mode)
 #+END_SRC
-* Python
+** Python
 Attention pour que la configuration fonctionne, il faut installer
 ~virtualenv~. Pour les systèmes Debian
 #+BEGIN_SRC shell
@@ -468,7 +465,7 @@ apt install virtualenv
     (venv-initialize-eshell))
 #+END_SRC
 
-* YaSnippet
+** YaSnippet
 Le système de templates pour Emacs
 #+BEGIN_SRC emacs-lisp
   (use-package yasnippet
@@ -479,14 +476,14 @@ Le système de templates pour Emacs
     :ensure t)
 #+END_SRC
 
-* Divers paquets
-** Highlight line
+** Divers paquets
+*** Highlight line
 Mise en valeur de la ligne courante
 #+BEGIN_SRC emacs-lisp
   (global-hl-line-mode t)
 #+END_SRC
 
-** Beacon
+*** Beacon
 Flash de la ligne aux changements de page ou de buffer
 #+BEGIN_SRC emacs-lisp
   (use-package beacon
@@ -495,7 +492,7 @@ Flash de la ligne aux changements de page ou de buffer
     (beacon-mode 1))
 #+END_SRC
 
-** hungry-delete
+*** hungry-delete
 Suppression de tous les blancs quand appuie sur backspace ou delete
 #+BEGIN_SRC emacs-lisp
   (use-package hungry-delete
@@ -504,14 +501,14 @@ Suppression de tous les blancs quand appuie sur backspace ou delete
     (global-hungry-delete-mode))
 #+END_SRC
 
-** Multiple-cursors
+*** Multiple-cursors
 Permet l'utilisation de plusieurs curseurs simultanément
 #+BEGIN_SRC emacs-lisp
   (use-package multiple-cursors
     :ensure t)
 #+END_SRC
 
-** Expand-region
+*** Expand-region
 Sélectionne une zone de manière incrémentale. mot, phrase, paragraphe,
 etc de manière intelligente.
 #+BEGIN_SRC emacs-lisp
@@ -521,19 +518,19 @@ etc de manière intelligente.
     (global-set-key (kbd "C-=") 'er/expand-region))
 #+END_SRC
 
-** Meilleure gestion du ~kill-ring~
+*** Meilleure gestion du ~kill-ring~
 #+BEGIN_SRC emacs-lisp
   (setq save-interprogram-paste-before-kill t)
 #+END_SRC
 
-** Gestion de la restauration des buffers
+*** Gestion de la restauration des buffers
 #+BEGIN_SRC emacs-lisp
   (global-auto-revert-mode 1)
   (setq auto-revert-verbose nil)
   (global-set-key (kbd "<f5>") 'revert-buffer)
 #+END_SRC
 
-* iedit
+** iedit
 Modifie les copies d'une zone séléctionnée simultanément
 
 | Raccourci   | Description                |
@@ -545,7 +542,7 @@ Modifie les copies d'une zone séléctionnée simultanément
     :ensure t)
 #+END_SRC
 
-* Narrow/widen dwim
+** Narrow/widen dwim
 Réduit/agrandit une zone d'édition de manière intelligente
 #+BEGIN_SRC emacs-lisp
   (defun narrow-or-widen-dwim (p)
@@ -577,7 +574,7 @@ Remplace la fonction Emacs standard par =dwim=
   (define-key ctl-x-map "n" #'narrow-or-widen-dwim)
 #+END_SRC
 
-* Web Mode
+** Web Mode
 Mode avancé pour l'édition de pages =html=, =CSS=,...
 #+BEGIN_SRC emacs-lisp
   (use-package web-mode
@@ -595,7 +592,7 @@ Mode avancé pour l'édition de pages =html=, =CSS=,...
   (setq web-mode-enable-auto-quoting t) ; this fixes the quote problem I mentioned
 #+END_SRC
 
-* Emmet mode
+** Emmet mode
 Ensemble de fonctions permettant l'édition rapide de markup languages (html,sgml,...)
 #+BEGIN_SRC emacs-lisp
   (use-package emmet-mode
@@ -609,7 +606,7 @@ Ensemble de fonctions permettant l'édition rapide de markup languages (html,sgm
     (add-hook 'css-mode-hook  'emmet-mode))
 #+END_SRC
 
-* Dired
+** Dired
 Permet d'utiliser reduire/agrandir les affichages de répertoires
 #+BEGIN_SRC emacs-lisp
   (setq dired-dwim-target t)
@@ -628,7 +625,7 @@ Permet d'utiliser reduire/agrandir les affichages de répertoires
     (bind-key "<backtab>" #'dired-subtree-cycle dired-mode-map))
 #+END_SRC
 
-* LaTeX
+** LaTeX
 Configuration LaTeX basique.
 #+BEGIN_SRC emacs-lisp
   (use-package tex
@@ -639,7 +636,7 @@ Configuration LaTeX basique.
     (tex-send-command "evince" (tex-append tex-print-file ".pdf")))
 #+END_SRC
 
-* Gestion de projets
+** Gestion de projets
 #+BEGIN_SRC emacs-lisp
   (use-package projectile
     :ensure t
@@ -649,7 +646,7 @@ Configuration LaTeX basique.
     (setq projectile-completion-system 'ivy))
 #+END_SRC
 
-* Org mode (langages suportés)
+** Org mode (langages suportés)
 Charge les langages disponnibles pour org-mode
 #+BEGIN_SRC emacs-lisp
   (org-babel-do-load-languages
@@ -665,7 +662,7 @@ Charge les langages disponnibles pour org-mode
      (latex . t )))
 #+END_SRC
 
-* Parenthèses
+** Parenthèses
 #+BEGIN_SRC emacs-lisp
   (use-package smartparens
     :ensure t
@@ -679,7 +676,7 @@ Charge les langages disponnibles pour org-mode
   (setq show-paren-style 'mixed)
 #+END_SRC
 
-* Taille de la police
+** Taille de la police
 Change la taille de la police dynamiquement (temporaire)
 | Raccourci | Description                     |
 |-----------+---------------------------------|
@@ -693,7 +690,7 @@ Change la taille de la police dynamiquement (temporaire)
     (global-set-key (kbd "C-M--") 'default-text-scale-decrease))
 #+END_SRC
 
-* Hydra
+** Hydra
 Outil de simplification des raccourcis. Un popup contextuel apparaît.
 | Raccourci | Description                           |
 |-----------+---------------------------------------|
@@ -777,7 +774,7 @@ Outil de simplification des raccourcis. Un popup contextuel apparaît.
     ("<drag-mouse-1>" ignore))
 #+END_SRC
 
-* Modes git
+** Modes git
 Le sublime *magit*
 | Raccourci | Description                          |
 |-----------+--------------------------------------|
@@ -839,7 +836,7 @@ modifications, de les valider (~git add -p~) ou de les annuler (~git checkout -p
      :color blue))
 #+END_SRC
 
-* Flyspell
+** Flyspell
 Correcteur orthographique à la volée
 #+BEGIN_SRC emacs-lisp
   (add-hook 'org-mode-hook 'turn-on-flyspell)
@@ -848,7 +845,7 @@ Correcteur orthographique à la volée
   (add-hook 'mu4e-compose-mode-hook 'turn-on-auto-fill)
 #+END_SRC
 
-* C++
+** C++
 Activation des *ggtags*
 #+BEGIN_SRC emacs-lisp
   (use-package ggtags
@@ -860,7 +857,7 @@ Activation des *ggtags*
                   (ggtags-mode 1)))))
 #+END_SRC
 
-* CMake
+** CMake
 #+BEGIN_SRC emacs-lisp
   (use-package cmake-mode
     :ensure t
@@ -879,14 +876,14 @@ Activation des *ggtags*
                                     1 font-lock-warning-face t)))))))
 #+END_SRC
 
-* Markdown
+** Markdown
 #+BEGIN_SRC emacs-lisp
   (use-package markdown-mode
     :ensure t
     :mode (".md" ".markdown"))
 #+END_SRC
 
-* Dumb jump
+** Dumb jump
 Permet de se déplacer *très* rapidement dans un texte ou de retrouver
 une définition.
 | Raccourci | Description                                                             |
@@ -904,14 +901,14 @@ une définition.
     :ensure t)
 #+END_SRC
 
-* Origami
+** Origami
 Mode permettant le pliage (/folding/) de regions
 #+BEGIN_SRC emacs-lisp
   (use-package origami
     :ensure t)
 #+END_SRC
 
-* IBuffer
+** IBuffer
 Un meilleur gestionnaire de /buffers/.
 
 | Raccourci | Description                        |
@@ -950,7 +947,7 @@ Un meilleur gestionnaire de /buffers/.
   (setq ibuffer-expert t)
 #+END_SRC
 
-* Wgrep
+** Wgrep
 Permet de modifier le résultat d'un *grep* (donc simultanément dans
 plusieurs fichiers par exemple).
 
@@ -968,7 +965,7 @@ voir [[https://github.com/emacsmirror/emacswiki.org/blob/master/wgrep.el][wgrep]
   (require 'wgrep-ag)
 #+END_SRC
 
-* PDF tools
+** PDF tools
 Outils d'édition de PDF dans Emacs
 #+BEGIN_SRC emacs-lisp
   (use-package pdf-tools
@@ -977,7 +974,7 @@ Outils d'édition de PDF dans Emacs
     :ensure t)
 #+END_SRC
 
-* AutoYASnippet
+** AutoYASnippet
 Outil de création rapide de snipets.
 Voir la documentation en ligne [[https://github.com/abo-abo/auto-yasnippet]]
 #+BEGIN_SRC emacs-lisp
@@ -985,7 +982,7 @@ Voir la documentation en ligne [[https://github.com/abo-abo/auto-yasnippet]]
     :ensure t)
 #+END_SRC
 
-* Divers
+** Divers
 Quelques réglages utilitaires
 #+BEGIN_SRC emacs-lisp
   (setq browse-url-browser-function 'browse-url-generic
@@ -996,7 +993,7 @@ Quelques réglages utilitaires
         '((cursor-color . "DarkGrey")))
 #+END_SRC
 
-* Keyfreq
+** Keyfreq
 Enregistre la fréquence d'utilisation de commandes.
 Pour obtenir les statistiques, utiliser la commande
 ~M-x keyfreq-show~
@@ -1009,7 +1006,7 @@ Pour obtenir les statistiques, utiliser la commande
     (keyfreq-autosave-mode 1))
 #+END_SRC
 
-* Dictionnaire et césures
+** Dictionnaire et césures
 #+BEGIN_SRC emacs-lisp
   (use-package dictionary
     :ensure t)
@@ -1017,6 +1014,21 @@ Pour obtenir les statistiques, utiliser la commande
     :ensure t)
 #+END_SRC
 
+
+* À propos de cette configuration
+Cette configuration d'Emacs est grandement (et librement) inspirée de
+celle proposée par Mike Zamansky.
+
+Pour une excellente série tutoriels ainsi que la construction pas a
+pas de configurations, voir ci-dessous
+#+begin_verse
+For a list of all posts and videos check out
+[[http://cestlaz.github.io/stories/emacs]]
+
+                      -- Mike Zamansky
+#+end_verse
+
+
 #+BEGIN_COMMENT
 Local Variables:
 ispell-local-dictionary: "francais"

Tutoriel.org

+#+STARTUP: org-pretty-entities entitiespretty
+#+PROPERTY: header-args :comments yes :results silent
+#+options: h:1 num:nil toc:nil
+
+* Historique
+* Prise en main
+* Quelques raccourcis
+* Modes utiles
+* Pour aller plus loin
+
+#+BEGIN_COMMENT
+Local Variables:
+ispell-local-dictionary: "francais"
+End:
+#+END_COMMENT

init.el

@@ -17,12 +17,14 @@
 	     '("org" . "https://orgmode.org/elpa/"))
 
 ;; positionner is-standalone à true pour utiliser l'archive elpa
-;; locale (nécessite au)
-(defvar is-standalone nil)
+;; locale, ou créer un fichier "~/.emacs.d/STANDALONE"
+(defvar is-standalone (file-exists-p "~/.emacs.d/STANDALONE"))
 (if is-standalone
     (setq package-archives '(("myelpa" . "~/.emacs.d/myelpa/")
 			      ("org" . "https://orgmode.org/elpa/")))
   nil)
+
+;; initialise la liste des paquets
 (package-initialize)
 
 ;; Bootstrap `use-package'
@@ -30,6 +32,7 @@
   (package-refresh-contents)
   (package-install 'use-package))
 
+;; Indique où sont stockés les paquets téléchargés
 (add-to-list 'load-path (expand-file-name "~/.emacs.d/elpa"))
 (use-package auto-async-byte-compile
   :ensure t
@@ -47,7 +50,6 @@
  '(hydra-hint-display-type (quote posframe))
  '(irony-cdb-search-directory-list (quote ("." "build")))
  '(org-confirm-babel-evaluate nil)
- '(org-default-notes-file (concat org-directory "/notes.org"))
  '(org-export-html-postamble nil)
  '(org-hide-leading-stars t)
  '(org-src-fontify-natively t)