====== plugin Vim Airline ======

Agrégation de plugins créant des thèmes et améliorant la barre de status Vim.

===== Installation =====

Pour installer facilement Airline, on utilise [[software:applications:vim:gestion-plugins|Pathogen]]. Installer d'abord pathogen puis dans le dossier bundle, cloner directement le dépot d'airline. 
 
<code bash>
$ git clone https://github.com/bling/vim-airline ~/.vim/bundle/vim-airline
</code>

Sous vim taper **:Helptags** pour générer la documentation
<code>
:Helptags
</code>

L'aide est disponible en tapant **:help airline**


===== Utilisation des symboles Powerline =====

Airline peut utiliser les symboles fournis par le plugin **Powerline** pour améliorer l'affichage de la barre de status. Pour cela, il faut installer les polices fournies par Powerline.

Sous une Debian like, un paquet regroupant seulement les polices existe:
<code bash>
sudo apt-get install fonts-powerline
</code>

Sinon on clone directement le dépot du projet :
<code bash>
$ git clone https://github.com/powerline/fonts.git
$ cd fonts
$ ./install.sh
</code>

<note>
Le script d'installation n'est pas exécuté par root, il installe les polices pour l'utilisateur courant.
</note>

Une fois les polices installées, ajouter la directive suivante dans le fichier ~/.vimrc
<file>
let g:airline_powerline_fonts = 1
</file>


===== Modifier le thème =====

pour modifier le thème en mode commande:
<code>
:AirlineTheme mon_theme
</code>

<note>
Les thème ne sont plus directement inclus dans les nouvelles versions de airline. Ils ont été regroupés dans un  autre dépot git https://github.com/vim-airline/vim-airline-themes.
</note>

===== Problèmes rencontrés =====

==== Les couleurs des thèmes n'apparaissent pas ====

Vérifier la valeur de la variable **t_Co** qui permet de spécifier le nombre de couleurs du terminal en tapant sous vim:

<code>
:set t_Co
</code> 

Ce genre de problème peut être rencontré si la variable n'est pas définie ou si elle contient une valeur faible ( exemple t_Co=8 ). Définir **t_Co** dans vimrc à 256.

<file>
set t_Co=256
</file>

==== La barre de status n’apparaît pas ====

Par défaut elle n'est pas chargée, sous vim en mode commande taper:
<code>
:set laststatus=2
</code>

Pour que la barre de status apparaisse systématiquement modifier votre fichier .vimrc en ajoutant cette meme commande.

==== Les polices powerline n'apparaissent pas correctement ====


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

  * https://github.com/bling/vim-airline
  * https://powerline.readthedocs.org/en/master/installation.html#patched-fonts