VIM comme tout éditeur qui se respecte, dispose d'un système permettant de
replier des portions de texte selon divers critères. Mais là où VIM se surpasse, c'est
une fois encore dans sa capacité de personnalisation. Là où la majorité des éditeur
"pense à notre place", VIM propose pas moins de 5 modes de pliage différent dont un
totalement personnalisable. Ajoutez à cela la
fonctionnalité de masquage apportée par VIM 7.3, et l'on obtient des choses bien
sympathiques.
Méthodes de pliage
Comme soufflé en introduction, VIM dispose de cinq méthodes pour gérer le pliage. Ce
mode est modifiable à travers le réglage foldmethod.
-
manual permet de placer les points de pliage à la mano.
-
indent permet de plier par niveau d'indentation (pratique pour du
python).
-
syntax, un peu plus chaud pour débuter, cela indique que c'est le
fichier de coloration syntaxique qui contrôle les pliages.
-
diff, un pliage adapté au format diff. Seules sont pliées les lignes
qui ne correspondent pas à du texte modifié.
-
marker qui permet de définir des séquences de lettres marquant le début
et la fin du pliage.
-
expr, le fin du fin, qui permet de définir le pliage à travers une
fonction.
Pliage par marqueur
Pour débuter nous allons nous intéresser au mode le plus simple, par marqueur. Il faut
donc ouvrir vim, faire une sauvegarde d'un fichier vide :w mon_text.txt et
modifier le mode de marquage pour ce fichier :
:setlocal foldmethod=marker
Activation du pliage par marqueurs
Pour rappel, setlocal applique le réglage au seul buffer en cours. Si on
voulait définir de manière générale (tout buffer confondu) le mode de pliage, on aurait
utilisé set.
Par défaut, le marqueur de début de pliage est {{{ et }}} pour la
fin. Ainsi nous pouvons taper dans notre fichier :
Ceci est le titre de mon pliage {{{
Et ceci est
son corps...
}}}
Placez vous maintenant dans le corps de votre pliage et tapez za (en mode
normal hein ! :-). Pouf, le code est plié. Un coup de za supplémentaire et il
s'ouvre à nouveau.
Il est aussi possible de faire du pliage imbriqué de la manière suivante :
Ceci est le titre de mon pliage {{{
Et ceci est
encore un pliage {{{
son corps...
}}}
}}}
Avec za vous pouvez plier le niveau inférieur, plus le niveau supérieur.
Notez qu'un coup de flèche droite ou de barre d'espace sur un pliage permet aussi de
l'ouvrir.
Je ne vais pas détailler toutes les commandes utilisables sur les pliages, il y en a un
bon paquet. Faite un coup de :help fold-commands pour avoir tous les
détails.
Bien évidemment, le marqueur est paramétrable. Il est contenu dans le réglage
foldmarker et contient par défault {{{,}}}, logique.
Dans certain cas le marqueur de fin n'est pas utile et l'on préfèrera définir le
marquage d'un niveau. C'est possible en standard de la manière suivante :
Ceci est le titre de mon pliage {{{1
Et ceci est
encore un pliage {{{2
son corps...
et encore un... {{{2
Un puis un autre {{{1
Avec cette notation plus besoin de marqueur de fin car vim arrêta le pliage du premier
{{{2 juste avant le second, et celui du second juste avant le
{{{1.
Pour conclure sur ce point, notez que vous avez aussi un réglage pour déterminer le
niveau de pliage à afficher : set foldlevel=1. En gros 0 c'est pour tout
plier et 9999 pour tout déplier :).
Au passage, un truc bien pratique dans vim. Lorsque vous mettez quelque part dans un
fichier un vim:foldlevel=1, cela règle le niveau de pliage automatiquement à
la ré-ouverture du fichier. Notez que ce n'est pas spécifique au pliage, vous pouvez insérer
dans cette ligne tout réglage VIM (tabstop, format de fichier, etc).
Libellé de pliage
Vous pouvez maintenant considérer que la ligne affichée pour indiquer un pliage est
moche. Et en effet, elle l'est. Mais là aussi VIM permet de tout changer à notre sauce.
Pour commencer dans le simple, il est possible de changer le caractère de remplissage de
la ligne.
:set fillchars+=fold:X
altération du caractère de remplissage
Maintenant, un X marque le trésor. Notez au passage que ce réglage permet de
modifier tous les caractères de remplissage (barre vertical de séparation, caractère de
ligne vide, etc). Comme d'hab, :help fillchars.
Pour passer au niveau supérieur, voyons comment définir totalement notre libellé.
Pour cela créons un fichier test.vim et ajoutons y une fonction
function MonLabelDePliage()
" Récupération de la ligne à la position v:foldstart
let line = getline(v:foldstart)
" On supprime les caractères innutiles
let line = substitute(line, '\\v\\/\\*|--\\s+|\\#\\s+|"\\s+|\\*\\/|\\{'.'\\{\\{\\d=', '', 'g')
" On ajoute un pipe devant
let line = " | ".line
return line
endfunction
Sauvez le fichier, puis pour charger la fonction, faite un :source %
(% veut dire "nom de fichier du buffer courant").
Il suffit maintenant d'indiquer à VIM l'usage de cette fonction pour écrire un libellé
de pliage.
:setlocal foldtext=MonLabelDePliage()
Si tout s'est bien passé, vous deviez voir vos pliage sous la forme de la ligne
d'origine, privée du marqueur, et avec un | en tête de ligne. Je n'ai pas dit
que j'allais améliorer le rendu, mais juste vous montrer comment faire ;-).
Il est aussi bien évidemment possible de changer la colorisation de la ligne de pliage par
:highlight Folded ctermfg=26 guifg=#2B2B5E
Colonne de pliage
Outre le label, il est aussi possible d'ajouter une colonne sur la gauche pour indiquer
visuellement les marquage par :setlocal foldcolumn=3. 3 indique
que vous désirez que la colonne prenne 3 caractères de large, vous pouvez mettre moins
ou plus, ou 0 pour que la colonne disparaisse.
Pour contrôler la colorisation de cette colonne :
:highlight FoldColumn ctermfg=26 guifg=#2B2B5E ctermbg=18 guibg=#B8B8AC
Pliage par expression
La méthode par marqueur ne vous convient pas ? Aucune ne vous convient en réalité ? Pas
de soucis, on passe en mode "Expression" :
:setlocal foldmethod=expr
Dans ce mode, nous pouvons définir une fonction VIM qui serra appelée pour chaque ligne
du buffer en cours et qui renverra des informations de pliage. Pour illustrer cela
imaginons que nous voulions plier notre fichier texte par niveau d'indentation. Nous
allons donc taper la commande suivante :
:setlocal foldexpr=indent(v:lnum)+1
Ceci fait, nous allons modifier notre texte pour quelque chose comme cela (les espaces
en début de ligne sont des tabulation) :
Niveau 1
Niveau 2
Niveau 3
Maintenant vous devez pouvoir plier le niveau 2, et le niveau 3. Le principe de
l'expression que nous avons saisie est assez simple. La fonction VIMScript indent
prend en paramètre un numéro de ligne du buffer en cours et qui renvoie le niveau d'indentation
allant de 0 à N. Nous lui fournissons donc le paramètre v:lnum qui correspond
au numéro de ligne à évaluer. Nous ajoutons 1 au résultat car renvoyer 0 signifie que la
ligne serait au même niveau que la précédente.
Bien évidemment il est possible de faire des choses un peu plus complexes que cela en
passant par la création d'un fonction. Pour tester cela, ajoutez une fonction à notre
test.vim créé plus haut.
function! MonExpressionDePliage(lnum)
return 1+indent(a:lnum)
endfunction
Sauvez le fichier, puis pour charger la fonction, faite un :source %
(% veut dire "nom de fichier du buffer courant"). Maintenant vous pouvez
revenir à notre fichier texte initial et taper :setlocal
foldexpr=MonExpressionDePliage(v:lnum), tout simplement.
Les marqueurs c'est moche !!
En fait oui, c'est vrai, mais c'est aussi tellement pratique. Mais cela serait tout de
même sympa de pouvoir les masquer.
Et bien c'est possible depuis la version 7.3 de vim.
Cette dernière ajoute en effet un nouveau concept dans la vue du buffer, la possibilité
de définir une région qui sera masqué sous certaines conditions et éventuellement
remplacée par un caractère de votre choix.
Soyons clair cette fonctionnalité n'a rien à voir avec le pliage mais trouve ici un
usage intéressant. Techniquement il s'agit d'une extension du système de coloration
syntaxique. Pour masquer les marqueurs standard, cela donne quelque chose comme cela :
:syntax match Marker "\\v\\{\\{\\{\\d*" conceal containedin=ALL cchar=❭
Vous aurez reconnu l'expression régulière permettant de matcher le marqueur avec ou sans
niveau (\\d*). Les points intéressant sont conceal qui demande à
VIM de masquer l'expression matchée. cchar qui indique le caractère à
utiliser en replacement (ici un petit chevron UTF8), et enfin containedin=ALL
indique juste que la règle peut être appliquée à n'importe quel élément de syntaxe (les
marqueurs peuvent être n'importe où).
En validant cette ligne, pouf, les marqueurs devraient disparaître, remplacés par notre
caractère de substitution. Pour contrôler l'affichage du marqueur, nous utilisons le
réglage concealcursor qui détermine les modes dans lesquels l'expression est
cachée lorsque l'on se trouve sur la ligne du masquage. Pour que le marqueur ne soit par
exemple ré-affiché qu'en mode "insertion", il suffit d'émettre :setlocal
concealcursor=nc. Ainsi même si l'on est sur la ligne du masquage, il restera
actif pour les modes n (normal) et c (commande) mais pas pour le
mode i (insertion).
Enfin vous pouvez coloriser le caractère de masquage pour qu'il se voit un peu mieux
:highlight Conceal ctermfg=24 guifg=#8B2252
Paramétrage de VIM
Ici nous avons beaucoup testé en tapant directement les commandes. Pour pérenniser tout
cela, vous pouvez mettre vos fonctions de libellé et de pliage dans
~/.vimrc, faire des choses spécifiques à certains type de fichiers dans
~/.vim/ftplugin/mon-type.vim ou encore ajouter les commandes highlight
dans votre schéma de couleurs ~/.vim/colors/xxx.vim. Notez juste que vous
devrez fait du set plutôt que du setlocal partout sauf dans les
ftplugin. À titre d'exemple, voici ce que j'ai dans mon ~/.vimrc
:
" Un plus joli caractère pour le remplissage des libellés
set fillchars+=fold:·
" Deux colonne pour le folding c'est suffisant
set foldcolumn=2
" Ma fonction pour les libellés
function! Viral_FoldingLabel()
let line = "".getline(v:foldstart)
let line = substitute(line, '\\v\\/\\*|--\\s+|\\#\\s+|"\\s+|\\*\\/|\\{'.'\\{\\{\\d=', '', 'g')
let line = substitute(line, '\\v^\\s+', '', 'g')
let line = substitute(line, '\\v\\s*$', '', 'g')
if (v:foldlevel>1)
let line = repeat(' ',&sw*(v:foldlevel-1)).'❭ '.line
else
let line = '| '.line
endif
return line.' '
endfunction
" Définition des libellés custom
set foldtext=Viral_FoldingLabel()
" Usage du pliage par marqueurs par défaut
set foldmethod=marker
" Quelque raccourcis pratiques
nmap z1 :setlocal foldlevel=0<CR>
nmap z2 :setlocal foldlevel=1<CR>
nmap z3 :setlocal foldlevel=2<CR>
nmap z4 :setlocal foldlevel=3<CR>
nmap z5 :setlocal foldlevel=4<CR>
nmap z6 :setlocal foldlevel=6<CR>
nmap z0 :setlocal foldlevel=9999<CR>
" Masquage des marqueurs
syntax match Marker "\\v\\{\\{\\{\\d*" conceal containedin=ALL cchar=❭
Conclusion
VIM est réellement un éditeur hors norme. Il n'est pas forcement le plus accessible
(euphémisme ? ;-) mais permet de se plier à toutes les exigences ou presque. J'ai
cependant quelques regrets (on devient exigeant ;-). Il est en effet dommage que l'on ne
puisse pas mieux coloriser les libellés de pliage (mettre un mot en valeur, ou coloriser
le niveau de replis). De même il aurait été sympa qu'au lieu d'un caractère de masquage,
une chaîne, ou mieux une expression soit utilisable.
Mais bon, dans l'ensemble VIM est pour moi le premier éditeur qui fournit un système de
pliage réellement efficace et utilisable.
