nvim
This commit is contained in:
parent
ae8d3260ef
commit
1cd3a2edb0
302
content/software/nvim-fr.md
Normal file
302
content/software/nvim-fr.md
Normal file
|
@ -0,0 +1,302 @@
|
|||
---
|
||||
Title: Quelques pointeurs pour ViM
|
||||
Date: 2023-05-13 11:00
|
||||
Modified: 2023-05-13 11:00
|
||||
Lang: fr
|
||||
Author: Fabrice
|
||||
Category: programmes
|
||||
Tags: vim, neovim
|
||||
Slug: nvim
|
||||
Header_Cover: ../images/covers/hand-fan.jpg
|
||||
Summary: Des informations que j'aurais bien aimé connaître plus tôt dans (neo)vim.
|
||||
---
|
||||
|
||||
[neovim](https://neovim.org/) est un éditeur de texte modal, héritier direct de
|
||||
[vim](https://www.vim.org) lui-même issu de
|
||||
[vi](https://ex-vi.sourceforge.net/).
|
||||
Cette famille d’éditeurs est assez répandue, et au moment de rechercher un
|
||||
éditeur de texte, on peut se retrouver face à des choix comme
|
||||
[ViM vs Emacs](https://fr.wikipedia.org/wiki/Guerre_d%27%C3%A9diteurs).
|
||||
|
||||
Trolls mis à part, il s’avère que j’utilise vim/neovim comme éditeur de texte au
|
||||
quotidien pour éditer du code, [écrire certains
|
||||
e-mails]({filename}../tips/emails-md-fr.md), prendre des notes, écrire ce blog…
|
||||
|
||||
Cependant, si vous êtes un vimiste convaincu ou simplement intéressé par la
|
||||
question et avez essayé, vous vous serez sans doute rendu compte que la courbe
|
||||
d'apprentissage n'est pas des plus douce, et qu’il est parfois compliqué de
|
||||
trouver l'information que l'on cherche… notamment si on ignore qu'elle existe.
|
||||
|
||||
À ce sujet, je ne peux que recommander les rencontres avec d'autres usagers,
|
||||
comme par exemple aux [tuppervim](https://tuppervim.org).
|
||||
Ces rencontres sont l'occasion de partager et de découvrir des informations
|
||||
autour de ViM afin de les intégrer __progressivement__ à son flot de travail.
|
||||
Malheureusement, cette solution n'est pas forcément des plus pratiques pour
|
||||
tous : les rencontres ont lieues à Paris/Lyon/Grenoble, ce qui les rendent
|
||||
difficile d'accès pour le sud-ouest de la France… voire pour les personnes en
|
||||
dehors de la France métropolitaine.
|
||||
Ainsi, même si comme la documentation ViM qui regroupe toutes les informations
|
||||
dont on pourrait avoir besoin, il existe des [archives des rencontres
|
||||
précédentes](https://tuppervim.org/archives.html), il est fastidieux de naviguer
|
||||
dans cette jungle de conseils. Ces archives sont plutôt pratiques pour les
|
||||
personnes ayant déjà assisté à une des réunions et qui cherche à retrouver un
|
||||
point particulier.
|
||||
|
||||
Ainsi je vais essayer de compiler quelques astuces et conseils que je pense être
|
||||
intéressants et que j'aurais bien aimé découvrir plus tôt par moments…
|
||||
Pour rappeler quelques principes de base du [cheminement vers la
|
||||
sagesse](https://fabi1cazenave.github.io/slides/2017-vim-ducklings/0-survive.html):
|
||||
n'essayez pas de tout intégrer d'un coup, c'est un coup à se décourager.
|
||||
D’autant plus que vim est avant tout un couteau-suisse, ainsi on ne va pas
|
||||
utiliser la lime à ongle pour couper du fromage: ça fonctionne mais c’est pas
|
||||
très pratique.
|
||||
Toutes les commandes et techniques ne se valent donc pas suivant l’usage de ViM
|
||||
que l’on a.
|
||||
|
||||
Ce billet n'est donc pas un cours pour apprendre à utiliser vim, mais simplement
|
||||
quelques astuces pour des personnes qui utilisent vim régulièrement sans pour
|
||||
autant vouloir devenir des _vim-wizards_ et qui pourraient ignorer certains
|
||||
conseils qui améliorent la qualité de vie sans relever de l'ésotérisme.
|
||||
Néanmoins, comme ce billet ne s’adresse pas nécessairement à des personnes qui
|
||||
découvriraient Vim, si je me mets à jargonner de manière incompréhensible et que
|
||||
vous trouvez cela dérangeant dans la lecture, merci de me le signaler (par mail,
|
||||
|
||||
# Parler à son éditeur
|
||||
|
||||
Lorsque j'ai découvert vim, comme indiqué dans la première phrase de ce billet,
|
||||
ce qui m'a marqué est le mot « **modal** ».
|
||||
Je pensais qu’il s’agissait de la partie importante dans la description de vim,
|
||||
et que c'était ce qui le différenciait d'emacs ou autre.
|
||||
En effet, lors de l'apprentissage de vim, la première réaction naturelle est de
|
||||
se dire que pouvoir passer d'un mode à l'autre en une seule touche permet
|
||||
d'éviter des acrobaties digitales pour appuyer sur trois touches à la fois, qui
|
||||
ne sont pas toujours bien placées.
|
||||
|
||||
Cependant, selon moi, ce qui fait la force de ViM, ce n'est pas seulement cette
|
||||
distinction entre modes qui permet de faire de la sélection visuelle, ou de
|
||||
naviguer dans son fichier pour aller exactement où l’on souhaite aller en trois
|
||||
entrées de touches, mais c'est la _langue_ de vim.
|
||||
|
||||
Ainsi, lors de l'apprentissage, il est important de comprendre ce qu'il se
|
||||
passe.
|
||||
De la même manière qu'il ne faut pas copier/coller des lignes de commandes qu'on
|
||||
ne comprend pas dans sont terminal, il est impératif de ne pas simplement
|
||||
apprendre des séquences de commandes dans vim sans comprendre ce qu'on est en
|
||||
train de communiquer à son éditeur.
|
||||
|
||||
Pour citer une erreur de jeunesse, lorsque j'ai appris à utiliser vim, j'ai lu
|
||||
quelque part sur internet que `gqap` en mode normal permettait de reformater un
|
||||
bloc de texte.
|
||||
Je ne comprenais pas exactement ce que « bloc » signifiait, mais ça fonctionnait
|
||||
globalement, et les modificateurs de répétition (par exemple `3gqap`) ont le
|
||||
comportement attendu.
|
||||
Cependant, ce défaut d'abstraction fait d'une part que j'ai appris plus de
|
||||
commandes par cœur que nécessaire, par exemple `dap` et `yap` construites sur le
|
||||
même principe, là où simplement savoir ce que signifie la commande aurait été un
|
||||
gain de place en mémoire, et fait gagner en flexibilité.
|
||||
|
||||
Pour cela il existe pas mal de tutoriels :
|
||||
|
||||
* [Learn Vim For the Last Time: A Tutorial and Primer](https://danielmiessler.com/study/vim/#language)
|
||||
* [Learning Vim in 2014: Vim as Language](https://benmccormick.org/2014/07/02/062700.html)
|
||||
|
||||
Mais pour faire simple, et ce que j'aurais bien aimé qu'on me dise à mes débuts
|
||||
(mais bon, après faut lire de la documentation rébarbative en anglais, et
|
||||
c'était pas très facile pour moi à l’époque), c’est qu’une commande vim est en
|
||||
fait… une phrase.
|
||||
On demande une action (par exemple `=` qui signifie « indenter »), on donne un
|
||||
champ d’action (`ap` qui signifie « autour du paragraphe », où un paragraphe est
|
||||
défini comme un bloc séparé par au moins deux retours chariots avant et après).
|
||||
Et là encore ce champ d'action peut être modifié, ainsi le `a` de `ap` signifie
|
||||
_around_ (autour), et peut-être remplacé par `i` pour `inside`.
|
||||
Pour les paragraphes, cela signifie prendre en compte ou non les lignes vides
|
||||
autour de ce dernier, mais pour des parenthèses, cela peut-être plus
|
||||
intéressant.
|
||||
Ainsi `ri(` permet de réécrire le contenu d'une parenthèse, ce qui peut être
|
||||
utiles pour remplacer les arguments d'une fonction, là où `ra(` va aussi effacer
|
||||
les parenthèses lors de la réécriture.
|
||||
|
||||
Si vous n'êtes pas certain de ce que vous faites, il peut être intéressant de se
|
||||
placer en mode visuel (`v`)pour voir et assimiler ce qu’il se passe. C'est un
|
||||
peu comme mettre des sous-titres.
|
||||
|
||||
# Le mode visuel
|
||||
|
||||
Parlons de ce mode visuel d'ailleurs.
|
||||
Comme beaucoup d’utilisateur Linux, j’ai été formaté pour trouver que tout ce
|
||||
qui se fait simplement en ligne de commande est mieux que de devoir faire treize
|
||||
clics pour arriver au même résultat.
|
||||
Or comme tout dogmatisme, il révèle parfois ses limites et pousse à
|
||||
l’obstination là où ça n’a pas forcément lieu d’être.
|
||||
Une des conséquences perverse de cette préconception est d’avoir ignoré le mode
|
||||
visuel, ou alors essayer de trouver de manière de m’en passer par moments alors
|
||||
qu'il permet de faire les choses avec un retour visuel qui permet de limiter les
|
||||
erreurs.
|
||||
Et de manière similaire à la frappe au clavier, la précision est plus importante
|
||||
que la vitesse : on perd beaucoup plus de temps et d’énergie à corriger une
|
||||
faute que d'avoir pris quelques instants de plus pour garantir le résultat… sans
|
||||
parler de la frustration induite.
|
||||
|
||||
## Changer la position du curseur visuel
|
||||
|
||||
Il peut arriver de sélectionner un paragraphe, avec `vip` par exemple, et de se
|
||||
rendre compte qu’on aurait bien aussi pris la ligne précédente, qui peut-être un
|
||||
titre par exemple.
|
||||
Or, `vip` va placer le curseur permettant d'éditer la zone de sélection
|
||||
visuelle (par exemple avec `}` pour sélectionner en plus le paragraphe suivant)
|
||||
à la fin de la sélection.
|
||||
|
||||
Pour alterner la position du curseur du début à la fin, il suffit d’une simple
|
||||
pression sur la touche `o`.
|
||||
|
||||
## Incrémenter une colonne de nombres
|
||||
|
||||
Si l'on souhaite créer une colonne de nombres (par exemple pour une énumération) comme ceci:
|
||||
```
|
||||
1
|
||||
2
|
||||
3
|
||||
4
|
||||
5
|
||||
6
|
||||
7
|
||||
8
|
||||
9
|
||||
10
|
||||
```
|
||||
|
||||
Une technique consiste à insérer 10 fois 0: `10i0<Enter><Esc>`, supprimer la
|
||||
ligne surnuméraire `dd`, rentrer en mode visuel `v`, sélectionner le bloc (s’il
|
||||
est précédé d’une ligne vide ou d'un début de fichier): `ip`, et incrémenter de
|
||||
manière globale `g<Ctrl+a>`.
|
||||
|
||||
## Utiliser le mode visuel pour limiter certaines actions
|
||||
|
||||
Parfois on est tenté de lancer de gros remplacements par expressions régulières
|
||||
sur son fichier, mais on est pas toujours sûr de ce qu'on fait.
|
||||
Lorsqu'on se met en mode ligne de commande sous vim pour effectuer un
|
||||
[remplacement](https://www.gnu.org/software/sed/manual/sed.html) par exemple,
|
||||
cela va commencer la ligne par `'<,'>`, qui indique que l’action se déroulera
|
||||
entre les marques `<` et `>` qui représentent le début et la fin de la sélection
|
||||
visuelle.
|
||||
|
||||
C'est ainsi possible de faire des tests pour vérifier si l'expression régulière
|
||||
fait bien ce qui est attendu d'elle sur un petit exemple avant de passer à
|
||||
l'échelle.
|
||||
|
||||
Bien entendu, je ne recommande pas cette méthode, principalement parce
|
||||
qu’aujourd’hui il existe d’autres méthodes pour faire du remplacement de masse.
|
||||
Par exemple, une des raisons qui peut pousser à cela, est le renommage d'une
|
||||
variable dans un programme.
|
||||
Désormais, il est possible de faire appel au « _language-server protocol_ » (LSP) pour
|
||||
faire cela:
|
||||
|
||||
* [<tt>vim.lsp.buf.rename()</tt>](https://neovim.io/doc/user/lsp.html#vim.lsp.buf.rename())
|
||||
|
||||
# Ranger sa configuration
|
||||
|
||||
Un autre point que je trouve important et que j’ai découvert un peu tard est la
|
||||
structure des dossier `.config/{n,}vim/`.
|
||||
J'ai en effet passé mes premières années avec un seul `.vimrc` avant de
|
||||
l’étendre avec d'autres fichiers que je changeais (`source`) par la suite.
|
||||
|
||||
Or, le dossier `$VIMHOME` est rangé de manière sémantique:
|
||||
|
||||
* [Vim Directory Structure](http://www.panozzaj.com/blog/2011/09/09/vim-directory-structure/)
|
||||
* [Plugin Layout in the Dark Ages](https://learnvimscriptthehardway.stevelosh.com/chapters/42.html)
|
||||
|
||||
Bien entendu je n’utilise par toute la structure, mais le point intéressant sont
|
||||
les dossiers `ftplugin` et `plugin`.
|
||||
Pour faire simple, le contenu de `plugin/*.{vim,lua}` sera automatiquement
|
||||
chargé au démarrage, et le contenu de `ftplugin/$FT.{vim,lua}` sera chargé
|
||||
lorsque vous ouvrez un fichier reconnu comme `$FT` par son
|
||||
[type de fichier](https://vimdoc.sourceforge.net/htmldoc/filetype.html).
|
||||
|
||||
Ainsi, en ayant un fichier `ftplugin/pandoc.lua` avec le paramétrage de
|
||||
[vim-pandoc-syntax](https://github.com/vim-pandoc/vim-pandoc-syntax) et mes [raccourcis pour pandoc]({filename}../tips/emails-md-fr.md) pour écrire
|
||||
ce billet, il m'est facile de l'éditer par la suite et de retrouver quelle ligne
|
||||
sert à quoi grâce au système de fichier.
|
||||
|
||||
De manière similaire, je sais que `plugin/bepo.lua` est mon réarrangement
|
||||
partiel des raccourcis vim pour le [bépo](https://bepo.fr/).
|
||||
|
||||
# La navigation
|
||||
|
||||
Un autre point important, est la navigation dans vos projets. En effet, à partir
|
||||
d'un moment, avoir un seul fichier pour tout devient irréaliste quel que soit le
|
||||
projet, et il convient de savoir naviguer rapidement entre différents
|
||||
emplacements dans le fichier.
|
||||
|
||||
Par soucis de généralité, nous allons ignorer les navigations spécifiques à
|
||||
certains plugins comme LSP.
|
||||
|
||||
## Sauter de fichier en fichier
|
||||
|
||||
Pour prendre un exemple de ma vie courante, j'utilise souvent LaTeX pour générer
|
||||
des documents. Lorsque ces documents commencent à prendre de la place (par
|
||||
exemple un [manuscrit de thèse](https://git.epheme.re/fmouhart/Manuscrit)) et
|
||||
qu’ils sont séparés en plusieurs fichiers, on inclut les sous-fichiers à l'aide
|
||||
de la macro `\include{filename}`.
|
||||
|
||||
Pour aller directement à au fichier `filename.tex`, il suffit de placer le
|
||||
curseur dessus et d'utiliser la commande `gf` (_go file_ pour le mnémonique,
|
||||
même si en terme de langue vim c'est pas exactement ça, c'est une approximation
|
||||
suffisante).
|
||||
Bien entendu cette commande peut s’étendre :
|
||||
[`<ctrl-w>gf`](https://vimdoc.sourceforge.net/htmldoc/windows.html#CTRL-W_gf)
|
||||
permet de l'ouvrir dans un [nouvel
|
||||
onglet](https://vim.fandom.com/wiki/Using_tab_pages).
|
||||
|
||||
Et cela fonctionne aussi pour les en-têtes en C par exemple ou dans n’importe
|
||||
quel situation où un chemin vers un fichier existe dans le fichier ouvert.
|
||||
|
||||
## L’historique de navigation
|
||||
|
||||
Si vous avez effectué la commande précédente (`gf`), pour revenir sur vos pas,
|
||||
il existe la commande `<Ctrl-o>` qui permet de revenir en arrière dans
|
||||
l'[historique de
|
||||
sauts](https://vimdoc.sourceforge.net/htmldoc/motion.html#jumplist), que vous
|
||||
pouvez visualiser à l'aide de la commande `jumps`.
|
||||
|
||||
Vous pouvez aussi revenir en avant à l'aide de la commande `<Ctrl-i>`.
|
||||
|
||||
C'est aussi pratique pour revenir plus haut après un grand déplacement (par
|
||||
exemple une recherche avec `/`).
|
||||
|
||||
## Repliements
|
||||
|
||||
Je ne vais pas rentrer dans les détails des repliements sous vim, surtout que
|
||||
c’est parfois les plugins qui le gèrent, mais apprendre à les ouvrir et les
|
||||
fermer peut-être utile alors je laisse ça ici:
|
||||
|
||||
* `zo`/`zc`: ouvrir/fermer d'un niveau le repli sous le curseur.
|
||||
* `zO`/`zC`: ouvrir/fermer complètement le repli sous le curseur.
|
||||
* `zm`/`zr`: ouvrir/fermer d'un niveau tous les replis.
|
||||
* `zM`/`zR`: ouvrir/fermer complètement tous les replis.
|
||||
|
||||
Plus de ressources:
|
||||
|
||||
* [Learn Vim the smart way: Folds](https://github.com/iggredible/Learn-Vim/blob/master/ch17_fold.md)
|
||||
|
||||
# Le reste en vrac
|
||||
|
||||
Quelques autres astuces plus ou moins utiles en vrac qui utilisent des concepts
|
||||
présentés précédemment:
|
||||
|
||||
* `%r)<Ctrl-o>r(`: en se plaçant sur le premier élément d'une paire (par exemple
|
||||
des crochets), permet de les remplacer par des parenthèses. La commande va à
|
||||
la paire associée avec `%`, remplace par une parenthèse fermante avec `r)`,
|
||||
revient en arrière avec `<Ctrl-o>` (donc au crochet ouvrant) et remplace par
|
||||
une parenthèse ouvrante via `r(`.
|
||||
* `@:`/`@@`: je n'ai rien dit sur les macros parce que si c'est puissant, c'est
|
||||
aussi un moyen simple de faire des erreurs, mais une utilisation un peu
|
||||
détourné des macros est de remarquer que `@:` permet de relancer la commande
|
||||
précédente (par exemple un `make`), et ainsi `@@` qui relance la macro
|
||||
précédente, permet de réeffectuer cette commande à moindre coût.
|
||||
* `<Ctrl-x><Ctrl-f>`: complète un nom de fichier. Je voulais en dire plus sur la
|
||||
complétion, mais pour le moment, ma configuration est un peu chaotique à ce
|
||||
niveau et j'ai trois plugins qui se battent pour la même fonctionnalité, je
|
||||
me suis donc passé de cette section pour le moment.
|
||||
* `:r !<commande système>`: par exemple `:r !date` permet d’écrire la date
|
||||
actuelle sur la ligne suivante. De façon plus générale, cela permet d’écrire
|
||||
la sortie standard d’un programme installé sur votre système.
|
Loading…
Reference in New Issue
Block a user