{{tag>software application éditeur vim extension plugin}}


====== Vim : Installation du plugin vim-airline sous Windows ======

L'extension **vim-airline** permet d'améliorer la mise en forme de la barre de status de Vim.

Dans un premier temps installer Vundle.

On peut ensuite modifier le fichier _vimrc pour ajouter les plugins :

<file txt _vimrc>
</file>

<note warning>
Pour que l'installation du plugin réussisse lancer l'installation depuis une **console Git-Bash**
</note>

Relancer Vim dans une console **Git-Bash** puis dans le mode commande saisir :
<code>
:PluginInstall
</code>


===== Utiliser les symboles Powerline =====

**vim-airline** peut utiliser les polices de l'extension Powerline pour améliorer la mise en forme de la barre de status.

<note>
Vim utilise la police (fonts) de la console. Si celle-ci n'est pas une des polices Powerline spécifiquement patchées, les symboles ne s'afficheront pas correctement. Confère section troubleshooting.
</note>

Cloner le dépot contenant l'ensemble des polices :
<code powershell>
# On clone le dépot dans un dossier temporaire (ici sur un ramdisk)
Set-Location R:\Temp\

git clone https://github.com/powerline/fonts.git
Set-Location .\fonts\

# Installation des polices
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass
.\install.ps1
</code>


===== Troubleshooting =====

Après installation certains symboles dans la barre vim-airline ne sont pas correctement affichés:

{{airline_pb_affichage_symboles.jpg}}
 
Afficher les symboles depuis le mode normal:
<code>
:set g:airline_symbols
</code>

On obtient la liste des symboles utilisés par airline
<code>
g:airline_symbols     {'linenr': ' :', 'modified': '+', 'whitespace': '☲', 'bra
nch': '', 'ellipsis': '...', 'paste': 'PASTE', 'maxlinenr': '☰ ', 'readonly': '
', 'spell': 'SPELL', 'space': ' ', 'dirty': '⚡', 'colnr': ' ℅:', 'keymap': 'Ke
ymap:', 'crypt': '🔒', 'notexists': 'Ɇ'}
</code>

On peut voir que certains symboles ne sont pas correctement affichés. vim-airline est configuré pour utiliser une police Powerline : ces polices sont spécifiquement patchées pour offrir des glyples permettant d'améliorer la mise en forme de la barre d'état.

En cas de mauvais affichage deux solutions :
  * Patcher la police en cours d'utilisation pour y ajouter les glyphes utilisés par Powerline. Notons que les polices de caractères sont souvent sous copyright : il faudra utiliser une police avec une licence permissive et un logiciel dédié comme [[https://fontforge.org/en-US/|FontForge]] ;
  * Redéfinir les symboles Powerline par défaut et utiliser des symboles existants dans la police en cours d'utilisation, c'est que nous allons faire ici.


<file txt _vimrc>
" Unicode symbols
let g:airline_left_sep = '»'
let g:airline_left_sep = '▶'
let g:airline_right_sep = '«'
let g:airline_right_sep = '◀'
let g:airline_symbols.linenr = '␊'
let g:airline_symbols.linenr = '␤'
let g:airline_symbols.linenr = '¶'
let g:airline_symbols.branch = '⎇'
let g:airline_symbols.paste = 'ρ'
let g:airline_symbols.paste = 'Þ'
let g:airline_symbols.paste = '∥'
let g:airline_symbols.whitespace = 'Ξ'
</file>

===== Références =====

  * https://stackoverflow.com/questions/19105279/how-can-i-setup-my-vim-airline-or-vim-powerline
  * https://github.com/vim-airline/vim-airline/issues/620
  * [[https://powerline.readthedocs.io/en/latest/|Documentation Powerline]].
  * [[https://stackoverflow.com/questions/5354379/a-simple-way-to-add-or-modify-glyphs-in-true-type-fonts-ttf|Modifier des glyphes dans une police de caractères (stackoverflow.com)]].