*pi_expl.txt* Pour Vim version 6.2. Dernière modification : 08 nov 2002 MANUEL de RÉFÉRENCE VIM - par M A Aziz Ahmed mis à jour par Mark Waggoner *file-explorer* *file-browser* Greffon d'exploration (ou de navigation) pour répertoires et fichiers 1. Lancer l'explorateur de fichiers |expl-starting| La fonctionnalité mentionnée dans ce fichier est mise en oeuvre par le biais d'un greffon global |standard-plugin|. Ce greffon n'est chargé que si l'option 'compatible' n'est pas activée. Vous pouvez éviter le chargement de ce greffon en fixant la variable "loaded_explorer" : > :let loaded_netrw = 1 {absent de Vi} ============================================================================== 1. Lancer l'explorateur de fichiers *expl-starting* Le greffon permet d'explorer les répertoires en restant à l'intérieur de Vim. L'explorateur de fichiers est démarré à chaque fois que l'utilisateur tente d'éditer un répertoire. *:Explore* *:Sexplore* Pour lancer l'explorateur dans le répertoire du fichier est cours d'édition : > :Explore Si le fichier a été modifié, la fenêtre est partagée. Pour toujours partager la fenêtre : > :Sexplore Pour lancer l'explorateur dans un répertoire particulier : > :Explore nomrep :Sexplore nomrep Une fois dans l'explorateur, placez le curseur sur une ligne contenant un nom de fichier ou de répertoire. Les commandes suivantes sont disponibles : ouvre le fichier dans la fenêtre actuellement utilisée par l'explorateur. 'o' partage la fenêtre et ouvre le fichier dans la nouvelle fenêtre. 'O' ouvre le fichier dans la fenêtre dans laquelle le curseur se trouvait juste avant que vous démarriez ou alliez dans la fenêtre de l'explorateur. Si l'explorateur est la seule fenêtre, une nouvelle fenêtre sera ouverte pour y charger le fichier. 'p' utilise la fenêtre de prévisualisation pour afficher le fichier. 'x' exécute le fichier avec l'action par défaut du système. Supporté uniquement par MS-Windows et KDE). Quand une nouvelle fenêtre est ouverte, vous pouvez contrôler sa position par rapport à la fenêtre de l'explorateur en utilisant les variables "g:explVertical", "g:explSplitBelow" et "g:explSplitRight". *g:explVertical* *g:explSplitBelow* *g:explSplitRight* *g:explStartBelow* *g:explStartRight* Pour indiquer si le partage doit se faire horizontalement ou verticalement, utilisez : > let g:explVertical = 1 " Partage verticalement let g:explVertical = 0 " Partage horizontalement (par défaut) Pour indiquer la position de la nouvelle fenêtre par rapport à l'explorateur quand le partage est horizontal, utilisez la variable : > let g:explSplitBelow = 1 " Placer la nouvelle fenêtre sous l'explorateur let g:explSplitBelow = 0 " Placer la nouvelle fenêtre au-dessus La valeur par défaut est fixée à la valeur de l'option 'splitbelow' lors du chargement du greffon. Pour indiquer la position de la nouvelle fenêtre par rapport à l'explorateur quand le partage est vertical, utilisez la variable : > let g:explSplitRight = 1 " Placer la nouvelle fenêtre à droite let g:explSplitRight = 0 " Placer la nouvelle fenêtre à gauche La valeur par défaut est fixée à la valeur de l'option 'splitright' lors du chargement du greffon. Pour changer le principe de partage utilisé pour la fenêtre de l'explorateur, utilisez : > let g:explStartRight = 1 " Place la nouvelle fenêtre de l'explorateur à " droite de la fenêtre courante let g:explStartRight = 0 " Place la nouvelle fenêtre de l'explorateur à " gauche de la fenêtre courante La valeur par défaut est fixée à la valeur de "g:explSplitRight" au moment du chargement du greffon. Pour changer le principe de partage utilisé pour la fenêtre de l'explorateur, utilisez : > let g:explStartBelow = 1 " Place la nouvelle fenêtre de l'explorateur " sous la fenêtre courante let g:explStartBelow = 0 " Place la nouvelle fenêtre de l'explorateur " au-dessus la fenêtre courante La valeur par défaut est fixée à la valeur de "g:explSplitBelow" au moment du chargement du greffon. Le comportement de partage au lancement de l'explorateur permettent le placement de la fenêtre à la manière d'un navigateur de fichiers, dans lequel les répertoires sont affichés à gauche et leur contenu à droite. Les paramètres de partage au lancement ne sont utilisés qu'avec la commande ":Sexplore". NOTE : le partage de la fenêtre est effectué de manière légèrement différente par rapport à un partage traditionnel. D'ordinaire, lors du partage d'une fenêtre, l'espace occupé par la fenêtre courante est partagé pour donner de la place à la nouvelle fenêtre. L'explorateur tente au contraire de partager la fenêtre adjacente pour ne pas changer la taille de la fenêtre depuis laquelle est il est lancé. Si aucune fenêtre adjacente n'existe dans la direction retenue pour le partage, la fenêtre depuis laquelle il est lancé est partagée. *g:explWinSize* Après l'ouverture d'un fichier avec la commande 'o', vous pourrier vouloir redimensionner la fenêtre de l'explorateur. C'est possible en fixant la variable > let g:explWinSize = N où N désigne le nombre de lignes (si le partage est horizontal) ou de colonnes (si le partage est vertical). Si "g:explWinSize" à pour valeur une chaîne vide (""), le redimensionnement n'a pas lieu. La valeur par défaut de "g:explWinSize" est 15. *g:explDetailedList* La taille de fichiers (en octets) et la date de modification peuvent être affichées dans la fenêtre de l'explorateur de fichiers. En tapant 'i', vous pouvez passer de l'affichage des noms uniquement à un affichage plus complet. Si vous souhaitez que la taille et la date apparaîssent par défaut, utilisez : > let g:explDetailedList = 1 Cette fonctionnalité peut ralentir l'explorateur. La différence peut être sensible ou non en fonction de votre système, selon que le répertoire est local ou sur un réseau, et selon la taille de ce répertoire. *g:explDateFormat* Le format de la date affichée est paramètrable en utilisant la variable "g:explDateFormat". L'explorateur passe cette variable à |strftime()| pour récupérer les informations sur la date. La valeur par défaut est : > let g:explDateFormat = "%d %b %Y %H:%M" NOTE : à des fins de tri, la date dans sa forme brute est toujours placée à la fin de chaque ligne. Si la coloration syntaxique est activée, cette date devrait rester invisible. *g:explHideFiles* Vous pouvez masquer certains fichiers en spécifiant des expressions rationnelles dans la variable "g:explHideFiles". Un nom de fichier correspondant avec l'une de ces exprat ne sera pas affiché. Par exemple > let g:explHideFiles = '^\.,\.gz$,\.exe$,\.zip$' n'affichera par les fichiers débutant par ".", ni ceux se terminant par ".gz", ".exe" ou ".zip". Cependant, tous les noms de répertoires seront montrés. Si durant l'exploration, vous souhaitez également voir les fichiers masqués, utilisez la commande 'a'. L'en-tête de l'explorateur vous indiquera si un filtrage a été effectué. *g:explDetailedHelp* Le message d'aide de plusieurs lignes peut être désactivé (pour laisser un message d'aide minimal) en utilisant la variable > let g:explDetailedHelp = 0 Vous pouvez activer (ou désactiver) l'aide détaillée à n'importe quel moment en tapant '?'. *explorer-delete* Taper 'D' dans l'explorateur supprime le fichier sous le curseur. Vous pouvez supprimer plusieurs fichiers en les sélectionnant Visuellement et en utilisant 'D'. La suppression est interactive (invite oui/non/toujours/quitter). La suppression des répertoires n'est pas supportée (principalement parce qu'aucune manière de supprimer un répertoire n'est disponible avec les fonctions intégrées de Vim). *explorer-rename* Taper 'R' dans l'explorateur vous permet de renommer le fichier sous le curseur. *g:explSortBy* L'affichage des fichiers dans l'explorateur peut être trié par ordre (direct ou inverse) de nom, de taille ou de date de modification. Vous pouvez fixer l'ordre de tri par défaut avec cette variable : > let g:explSortBy = 'name' " alphabétique let g:explSortBy = 'reverse name' " alphabétique inverse let g:explSortBy = 'date' " le plus récent d'abord let g:explSortBy = 'reverse date' " le plus ancien d'abord let g:explSortBy = 'size' " le plus gros d'abord let g:explSortBy = 'reverse size' " le plus petit d'abord Une fois dans l'explorateur, vous pouvez passer d'un tri à l'autre avec la touche 's', et vous pouvez inverser l'ordre de tri en appuyant sur la touche 'r'. Le tri selon des champs différents du nom sera plus rapide si la date et la taille sont affichées (en utilisant 'i' ou "g:explDetailedList"). L'en-tête de l'explorateur vous indiquera le tri actuellement utilisé. *g:explDirsFirst* Pour contrôler la séparation entre les répertoires et les fichiers, vous pouvez utiliser cette variable : > let g:explDirsFirst = 1 " Placer les répertoire au début (par défaut) let g:explDirsFirst = 0 " Mélanger les répertoire et les fichiers let g:explDirsFirst = -1 " Placer les répertoire à la fin < *g:explSuffixesLast* Pour contrôler la séparation des fichiers dont les suffixes correspondent avec certaines extensions, vous pouvez utiliser cette variable : > let g:explSuffixesLast = 1 " Placer les fichiers dont les suffixent " correspondent à la fin (par défaut) let g:explSuffixesLast = 0 " Mélanger les fichiers dont les suffixes " correspondent avec les autres let g:explSuffixesLast = -1 " Placer les fichiers dont les suffixes " correspondent au début L'en-tête de l'explorateur vous indiquera si les fichiers avec les suffixes spécifiés sont placés à la fin ou au début de la liste. *g:explUseSeparators* Les répertoires et fichiers dont les suffixes correspondent sont mis en surbrillance. Si vos répertoires, fichiers et suffixes sont séparés et que vous souhaitez afficher une ligne entres les groupes, vous pouvez utiliser cette variable : > let g:explUseSeparators = 1 " Mettre des séparateurs let g:explUseSeparators = 0 " Ne pas mettre de séparateurs < *g:explFileHandler* Si vous fixez la variable "g:explFileHandler" au nom d'une fonction, cette dernière sera appelée quand 'x' sera tapé. Le nom du fichier ou du répertoire sous le curseur sera passé en argument à la fonction. En supposant que vous utilisez KDE, vous pourriez faire ceci : > function MyFileHandler(nomfich) exec "silent! !kfmclient exec " . escape(a:nomfich, ' \%#') endfunction let g:explFileHandler = 'MyFileHandler' Sur Win32, la variable est fixée par défaut pour invoquer l'action « exécuter ». Si vous tapez 'x' sur un fichier HTML, MS Internet Explorer démarrera (ou toute autre application qui est associée aux fichiers HTML). vim:tw=78:noet:ts=8:ft=help:norl: