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


====== Vim : Installation de Vundle sous Windows ======

**Vundle** est un gestionnaire d'extensions pour **Vim**.

===== Prérequis =====

Pour l'installation sous Windows quelques prérequis :

  * Git en version 2.12 ou supérieure. Le path doit être correctement configuré pour qu'il puisse être appelé depuis la ligne de commande.

<code>
git --version
git version 2.41.0.windows.3
</code>

  * cURL doit être installé. Il est inclus dans les versions de Windows  10 et supérieures. Pour les plus anciennes versions, [[https://curl.se/download.html#Win64|télécharger cURL depuis la page du projet]].


===== Installation =====

Sous Windows, les nouvelles version de Vim (Gvim) recherchent le fichier _vimrc et le répertoire ~/vimfiles. Le métacaractère '~' peut également être utilisé pour désigner le répertoire HOME de l'utilisateur. Il faut convertir le type du séparateur de chemin via la directive **shellshash**.

Pour l'installation, on clone le répertoire du projet via git. Depuis une console Git-Bash:
<code>
git clone https://github.com/VundleVim/Vundle.vim.git ~/vimfiles/bundle/Vundle.vim
</code>

S'il n'existe pas encore créer le fichier ~/vimfiles/_vimrc
<code powershell>
cd ~
vim _vimrc
</code>

<file txt _vimrc>
source $VIMRUNTIME/defaults.vim

filetype off
set shellslash
set rtp+=~/vimfiles/bundle/Vundle.vim
call vundle#begin('~/vimfiles/bundle')
" let Vundle manage Vundle, required
Plugin 'VundleVim/Vundle.vim'

" All of your Plugins must be added before the following line
call vundle#end()            " required
filetype plugin indent on    " required
" To ignore plugin indent changes, instead use:
"filetype plugin on
"
" Brief help
" :PluginList       - lists configured plugins
" :PluginInstall    - installs plugins; append `!` to update or just :PluginUpdate
" :PluginSearch foo - searches for foo; append `!` to refresh local cache
" :PluginClean      - confirms removal of unused plugins; append `!` to auto-approve removal
"
" see :h vundle for more details or wiki for FAQ
" Put your non-Plugin stuff after this line
</file>

Enregistrer les modification et relancer Vim. Depuis le mode normal saisir :

<code>
:PluginInstall
</code>

Vundle est installé et les tags pour la documentation sont générés. Depuis le mode normal la documetation de Vundle est disponible :

<code>
:h vundle
</code>
===== Troubleshooting =====


==== Raccourcis clavier non fonctionnels ====

Certaines séquences de caractères sont interceptées en amont de Vim par la console Windows. Par exemple <key>ctrl</key> + <key>v</key> utilisée par Vim pour activer le mode "visuel par bloc" ne se déclenche pas car la console interprète en amont la séquence pour coller le contenu du presse papier.

On peut modifier le raccourcis de la console Windows:
  * Paramètres > Actions
  * Dans la listes des actions repérer les entrées "coller" il en existe plusieurs ;
  * Supprimer l'entrée "Coller" ayant pour déclencheur <key>ctrl</key> + <key>v</key>.

source : [[https://superuser.com/questions/1761269/how-to-send-ctrl-v-to-a-remote-ssh-shell-in-cmd-on-windows-11|Envoyer CTRL-V dans la console Windows (superuser)]].

==== Saut sur un tag ====

Le saut vers un tag sous le curseur via le raccourcis CTRL-] ne fonctionne pas depuis la console Windows. Si la souris est active on peut sauter vers un tag en maintenant <key>ctrl</key> enfoncé et en cliquant sur le label. Sinon on peut utiliser la commande '':tag'' depuis le mode normal:
<code>
:tag aTagName
</code>

L'aide Vim est disponible en tapant '':help tag''

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

  * [[https://github.com/VundleVim/Vundle.vim/wiki/Vundle-for-Windows|Installer Vundle sous Windows (dépôt officiel git du projet)]]