526 lines
26 KiB
Markdown
526 lines
26 KiB
Markdown
---
|
||
Title: Quelques pointeurs pour Vim
|
||
Date: 2023-05-13 11:00
|
||
Modified: 2023-05-14 14:00
|
||
Lang: fr
|
||
Author: Fabrice
|
||
Category: programmes
|
||
Tags: vim, neovim
|
||
Slug: nvim
|
||
table-of-contents: true
|
||
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és par la
|
||
question et avez essayé, vous vous serez sans doute rendu compte que la courbe
|
||
d’apprentissage n’est pas des plus douces, 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 lieu à Paris/Lyon/Grenoble, ce qui les rend difficiles
|
||
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](https://www.vim.org/docs.php) qui
|
||
regroupe toutes les informations dont on pourrait avoir besoin, il existe des
|
||
[archives des rencontres précédentes](https://tuppervim.org/archives.html).
|
||
On se perd cependant très vite au milieu de 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éressant 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 peut fonctionner 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.
|
||
Je ne vais d’ailleurs pas aborder le point des modules en détails et essayer de
|
||
rester le plus agnostique possible.
|
||
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,
|
||
irc, autre).
|
||
|
||
# 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 entre ses différents fichiers pour aller exactement où l’on souhaite
|
||
aller en trois entrées clavier, 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 son 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
|
||
utile 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 pour être sûr de comprendre ce qu’il
|
||
se dit.
|
||
|
||
# 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 beaucoup plus pur/élégant 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.
|
||
|
||
Avant de passer à la suite, voici deux liens qui présentent la même chose, mais le
|
||
premier est plus visuel (il y a des vidéos démonstratives) que le second, je
|
||
vous laisse choisir selon vos préférences.
|
||
|
||
* [learnbyexample: Vim Reference Guide -- Visual mode](https://learnbyexample.github.io/vim_reference/Visual-mode.html)
|
||
* [Mastering Visual Mode in Vim](https://dev.to/iggredible/mastering-visual-mode-in-vim-15pl)
|
||
|
||
## Changer la position du curseur visuel
|
||
|
||
Il peut arriver de sélectionner un paragraphe, avec `vap` 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, `vap` 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`.
|
||
|
||
Par exemple, sur un bloc de trois paragraphes, on peut sélectionner le deuxième
|
||
(`vap`) parce que c’est celui qui nous intéresse (pour le copier par exemple),
|
||
puis se rendre compte que le premier introduit le deuxième et avoir envie de le
|
||
rajouter à la sélection.
|
||
On peut donc presser `o` pour replacer le curseur au début, et sélectionner le
|
||
paragraphe précédent avec `{{` (oui, pour, me semble-t-il, de sombres raisons
|
||
d'[inclusion/exclusion](https://vimdoc.sourceforge.net/htmldoc/motion.html#exclusive),
|
||
le paragraphe précédent est… une ligne vide).
|
||
On se rend ensuite compte que les deux paragraphes sélectionnés ne sont pas
|
||
complets si on ne rajoute par le dernier paragraphe, et pour cela, on peut
|
||
revenir à la fin par une seconde pression sur `o` et le sélectionner avec `}`.
|
||
|
||
L’exemple précédent illustre également l’intérêt du mode visuel pour se rendre
|
||
compte de ce qu’il se passe.
|
||
Intuitivement, je pensais que `{` au début du paragraphe allait reprendre le
|
||
paragraphe précédent directement, et cela m’a amené à regarder la doc des
|
||
[`object-motions`](https://vimdoc.sourceforge.net/htmldoc/motion.html#object-motions),
|
||
et me rendre compte que cela ne fonctionne pas exactement comme je me le
|
||
représentais.
|
||
Durant mes tests pour écrire ce billet, je me suis aussi rendu compte que `v3ap`
|
||
sélectionne bien le paragraphe en cours et les trois qui suivent, là où `v3ip`
|
||
n’en prend que deux pour ces raisons de mouvements inclusifs ou exclusifs.
|
||
|
||
## 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>`.
|
||
|
||
Pour comprendre [ce qu’il se
|
||
passe](https://vimdoc.sourceforge.net/htmldoc/change.html#CTRL-A), `<Ctrl-a>`
|
||
permet d’incrémenter le nombre sous lequel se trouve le curseur (et sa
|
||
contrepartie `<Ctrl-x>` permet de le décrémenter).
|
||
Si on sélectionne visuellement une colonne et qu’on applique simplement
|
||
`<Ctrl-a>`, la colonne va être incrémentée (et donc donner une colonne de « 1 »
|
||
dans le cas précédent).
|
||
Ici, le modificateur `g` s’interprète comme « effectue `<Ctrl-a>` de manière
|
||
_intelligente_ ».
|
||
|
||
## Utiliser le mode visuel pour limiter certaines actions
|
||
|
||
On est parfois 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 dossiers `.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)
|
||
|
||
N’utilisant pas toute la structure, je vais me concentrer ici sur mon usage :
|
||
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.
|
||
Par la suite, il est plus facile de l’éditer et de retrouver la signification
|
||
des différentes lignes grâce au système de fichier.
|
||
|
||
De manière similaire, je sais que `plugin/bepo.lua` décrit mon réarrangement
|
||
partiel des raccourcis Vim pour le [bépo](https://bepo.fr/).
|
||
|
||
## Type du fichier
|
||
|
||
### Détection automatique
|
||
|
||
Comme indiqué précédemment, les fichiers dans `ftplugin` sont chargés en
|
||
fonction du type de fichier.
|
||
Celui-ci est défini via l’option
|
||
[`filetype`](https://vimdoc.sourceforge.net/htmldoc/filetype.html) ou `ft` pour
|
||
faire court.
|
||
Cette abstraction permet de faire partager à une classe de fichier des
|
||
configurations (par exemple la coloration syntaxique ou l'indentation)
|
||
malgré des extensions différentes (`html`/`htm`, `py`/`sage`, `c`/`h`).
|
||
On peut de plus noter que la reconnaissance automatisée de type de fichier
|
||
(`:filetype on`) est activée par défaut dans Neovim.
|
||
|
||
### Indication manuelle
|
||
|
||
Celui-ci peut aussi être défini à la main via `:set ft=<…>`, par exemple pour que le
|
||
fichier de syntaxe de pandoc soit chargé, il faut que ce fichier soit de type
|
||
`pandoc`.
|
||
Or, par défaut un `*.md` est reconnu comme `filetype=markdown`, et les
|
||
personnalisations spécifiques de l’extension `vim-pandoc` ne seront pas
|
||
appliquées.
|
||
|
||
### Modeline
|
||
|
||
De manière ponctuelle, il est possible de le définir fichier par fichier à
|
||
l’aide du `modeline`.
|
||
Il s’agit de cette ligne commentée étrange que l’on retrouve parfois au début ou
|
||
à la fin d'un fichier qui ressemble à
|
||
[ça](https://github.com/dunst-project/dunst/blob/master/dunstctl#L164):
|
||
```sh
|
||
# vim: noexpandtab
|
||
```
|
||
|
||
Le `modeline` permet de préciser certains paramètres à propos d'un fichier,
|
||
comme précédemment pour indiquer l’utilisation de tabulations plutôt que
|
||
d’espaces.
|
||
Mais cela peut aussi être utile pour indiquer que l’on souhaite l’utilisation
|
||
d’un vérificateur orthographique (`spell`), la langue de ce vérificateur
|
||
(`spelllang`/`spl`), le type de fichier (`ft`), et autres.
|
||
|
||
Il est à noter que le `modeline` est là pour une utilisation ponctuelle.
|
||
Comme il s’agit d’une entrée externe exécutée à l'ouverture du fichier, il peut
|
||
créer des risques de sécurité au moment d’ouvrir des fichiers issus d’une source
|
||
externe, comme ça a pu être le cas avec les vulnérabilités
|
||
[CVE-2019-12735](https://www.cvedetails.com/cve/CVE-2019-12735/) et
|
||
[CVE-2016-1248](https://www.cvedetails.com/cve/CVE-2016-1248/) par exemple.
|
||
|
||
### Autocommands
|
||
|
||
Autrement, il est aussi possible d’exécuter des commandes pour des fichiers
|
||
particuliers à l'aide des
|
||
[`autocommands`](https://vimdoc.sourceforge.net/htmldoc/autocmd.html).
|
||
|
||
Je souhaite, par la suite faire un billet spécifiquement sur la configuration de
|
||
Vim, mais il est difficile de parler d’`autocommands` sans l’évoquer.
|
||
|
||
Par exemple, pour spécifier le type de fichier pour les documents de ce blog,
|
||
détecter la langue à partir de ma convention de nommage ainsi que des options de
|
||
mise en forme il est possible de définir dans `$VIMHOME/plugin/blog.lua`:
|
||
|
||
```lua
|
||
local blog_group = vim.api.nvim_create_augroup('blog', { clear = true })
|
||
|
||
vim.api.nvim_create_autocmd({"BufEnter", "BufWinEnter"}, {
|
||
pattern = {vim.fn.expand("~") .. "/chemin/vers/blog/**/*.md"},
|
||
group = blog_group,
|
||
callback = function()
|
||
vim.o.filetype = 'pandoc'
|
||
vim.o.tw = 80
|
||
vim.o.spell = true
|
||
vim.o.spl = 'en'
|
||
end
|
||
})
|
||
|
||
vim.api.nvim_create_autocmd({"BufEnter", "BufWinEnter"}, {
|
||
pattern = {vim.fn.expand("~") .. "/chemin/vers/blog/**/*-fr.md"},
|
||
group = blog_group,
|
||
callback = function()
|
||
vim.o.spl = "fr"
|
||
end
|
||
})
|
||
```
|
||
|
||
La compréhension du bloc de code non commenté ci-dessus est laissée en exercice
|
||
au lecteur attentif.
|
||
|
||
Blague à part, on remarque aussi que le fait d’avoir rangé ses fichiers de
|
||
manière sémantique dans sa configuration Neovim/Vim permet de s'y retrouver
|
||
facilement mais surtout de pouvoir tester et revenir en arrière aisément.
|
||
Ainsi, « configurer son éditeur » devient moins effrayant que ce qu’il
|
||
semblerait de prime abord, d’autant plus que la configuration de Neovim par
|
||
défaut va au-delà de la politique de Vim initiale qui est d’essayer d’être
|
||
compatible avec vi.
|
||
Conséquence de quoi, la configuration de Neovim, étant plus orientée
|
||
« utilisable » par défaut est moins verbeuse que celle de Vim.
|
||
|
||
Je vous conseille ces deux vidéos pour en savoir plus sur les `autocommands` en
|
||
Lua pour Neovim:
|
||
|
||
* [[Demo] Lua Augroups - Why And How To Use?](https://www.youtube.com/watch?v=F6GNPOXpfwU)
|
||
* [[Demo] Lua Autocmds in Neovim (by the author of Lua Autocmds)](https://www.youtube.com/watch?v=ekMIIAqTZ34)
|
||
|
||
|
||
# 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 souci de généralité, je vais, dans la suite, ignorer les actions de
|
||
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 au-dessus et d’utiliser la commande `gf` (_go file_ pour le mnémonique,
|
||
même si en termes 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
|
||
quelle 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 <em>plugin</em>s qui le gèrent, mais apprendre à les ouvrir et
|
||
les fermer est potentiellement utile alors je pose ça là:
|
||
|
||
* `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 ou non 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ée 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.
|
||
* Activer
|
||
[`undodir`](https://vimdoc.sourceforge.net/htmldoc/options.html#'undodir') et
|
||
[`undofile`](https://vimdoc.sourceforge.net/htmldoc/options.html#'undofile')
|
||
pour avoir un historique de modification (`u`/`<Ctrl-r>`)
|
||
[persistant](https://neovim.io/doc/user/undo.html#undo-persistence) par
|
||
fichier et non par session. Cela peut être pratique pour pouvoir annuler une
|
||
modification sur un fichier
|
||
de configuration quand on se rend compte trois jours après que cela ne nous
|
||
convient pas par exemple.
|
||
* `]p`: pour avoir une indentation cohérente lors d'un copier-coller.
|
||
* `:cq`: pour quitter sans sauvegarder et en renvoyant un code d'erreur non nul.
|
||
Cela peut être utile pour annuler l’écriture d’un message de commit
|
||
[git]({filename}../cheat-sheets/git-fr.md) par exemple.
|
||
* `cursorline`/`cursorcolumn`: ces deux options permettent respectivement de
|
||
surligner la ligne et la colonne du curseur afin de le repérer plus
|
||
facilement dans la fenêtre. Ce n’est pas indispensable, mais je trouve ça
|
||
plutôt agréable.
|
||
|
||
# Le mot de la fin
|
||
|
||
Pour conclure, on peut voir que Vim est un éditeur assez puissant et qui peut
|
||
s’adapter à beaucoup de cas d’usages.
|
||
On a juste effleuré ce qui était possible, et à chaque fois que je vais à un
|
||
[tuppervim](https://tuppervim.org), je découvre toujours des petits trucs qui
|
||
modifient un peu mon usage et rendent l’utilisation de Vim de plus en plus
|
||
confortable.
|
||
De manière similaire à l’utilisation de dispositions de claviers dites
|
||
ergonomiques, ce qui rend Vim agréable à utiliser ce n’est pas la course
|
||
permanente à la productivité, mais le gain de confort.
|
||
L’amélioration de la vitesse n’est qu’un effet de bord des facilités accordées
|
||
par l’éditeur pour effectuer certaines actions autrement plus rébarbatives.
|
||
|
||
De plus, en rangeant son `$VIMHOME`, il est possible de pouvoir tester
|
||
différentes choses rapidement et sans conséquences.
|
||
Vous avez essayé une commande étrange trouvée sur internet dans
|
||
`$VIMHOME/plugin/test.lua` et ça affiche 30 lignes d'erreurs ? Pas de problèmes,
|
||
il suffit de supprimer le fichier de test.
|
||
Si celui-ci fonctionne comme attendu, il ne reste plus qu'à le renommer de
|
||
manière plus compréhensible.
|
||
Je pense qu'il est assez fondamental de s’approprier ses outils, et pour un
|
||
éditeur de texte aussi configurable que Neovim, c’est d’autant plus important de
|
||
l’adapter à son utilisation.
|
||
Une règle d’or étant : « Si quelque chose vous dérange, c’est qu’il y a moyen
|
||
d’améliorer ça ».
|
||
D'autant plus que d’autres personnes ont sans doute rencontré le même problème
|
||
avant vous (sauf cas de niche bien entendu).
|
||
Ainsi, je vous encourage fortement à essayer de nouvelles choses dans Vim,
|
||
d'autant plus que les usages ne sont pas figés dans le temps, et que ce qui nous
|
||
convient à un moment, ne sera pas forcément toujours d'actualité trois ans plus
|
||
tard.
|
||
|
||
Je n’ai bien entendu pas parlé d’énormément de choses : le découpage de l’espace
|
||
de travail à la `tmux`, les onglets et la navigation, la complétion automatique,
|
||
les marques, les tags, les déplacements… Et le but de ce billet n’est pas d’être
|
||
exhaustif mais d’être rapidement accessible. Cependant si vous pensez qu’il
|
||
manque des choses, n’hésitez pas à me contacter à ce sujet, ce billet peut
|
||
évoluer suivant ce que je découvre et en fonction de ma mémoire.
|
||
|
||
Enfin, ça a été rapidement évoqué à la fin des points en vrac, mais je pense
|
||
aussi faire un billet, dans un futur plus ou moins proche, un billet à propos de
|
||
la configuration de Vim en `lua`.
|
||
|
||
C’est tout pour moi, en espérant que vous avez apprécié ce petit pavé. À
|
||
bientôt !
|
||
|
||
<small>
|
||
**Remerciements**: Merci à [Pablo Coves](https://pcoves.gitlab.io/blog/) pour
|
||
sa relecture et ses conseils pour améliorer le billet.
|
||
</small>
|