*usr_45.txt*	Pour Vim version 6.2.

	       MANUEL de l'UTILISATEUR VIM - par Bram Moolenaar

			      Choisir sa langue


Dans Vim, les messages peuvent être donnés en plusieurs langues. Ce chapitre
explique comment changer la langue utilisée. Il explique également les
différentes méthodes pour travailler avec des fichiers dans des langues
différentes.

|45.1|	Langue utilisée pour les messages
|45.2|	Langue utilisée pour les menus
|45.3|	Utiliser un encodage différent
|45.4|	Éditer des fichiers avec un encodage différent
|45.5|	Saisir du texte dans une langue donnée

  Chapitre suivant : |usr_90.txt|  Installer Vim
Chapitre précédent : |usr_44.txt|  Créer ses propres colorations syntaxiques
Table des matières : |usr_toc.txt|

==============================================================================
*45.1*	Langue utilisée pour les messages

Au démarrage, Vim examine l'environnement pour déterminer quelle langue vous
utilisez. La plupart du temps cela fonctionne bien, et vous obtenez les
messages dans votre langue (s'ils sont disponibles). Pour voir quelle est la
langue en cours, utilisez cette commande :

	:language

Si la réponse est "C", cela signifie que Vim utilise la langue par défaut,
c.-à-d. l'anglais.

	NOTE :
	L'utilisation de langues différentes fonctionne uniquement lorsque Vim
	a été compilé pour le supporter. Pour déterminer si c'est le cas,
	utilisez la commande ":version" et cherchez "+gettext" et
	"+multi_lang" dans la réponse. Si vous voyez "-gettext" ou
	"-multi_lang", vous devrez trouver un autre Vim.

Comment faire si vous voulez que les messages soient dans une autre langue ?
Il y a plusieurs méthodes, selon le système que vous utilisez.
   La première méthode consiste à configurer l'environnement pour la langue
désirée avant de démarrer Vim. Exemple sous Unix :

	env LANG=de_DE.ISO_8859-1  vim

Cette méthode fonctionne seulement si la langue est disponible sur votre
système. L'avantage est que tous les messages de l'IHM graphique et les
bibliothèques utilisent aussi la bonne langue. L'inconvénient est qu'il faut
le faire avant de démarrer Vim. Si vous voulez changer de langue sans quitter
Vim, vous pouvez utiliser la seconde méthode :

	:language fr_FR.ISO_8859-1

Vous pouvez ainsi essayer plusieurs noms pour votre langue. Vous obtiendrez un
message d'erreur pour les langues non supportées sur votre système. En
revanche vous n'obtiendrez pas d'erreur si les messages traduits sont
indisponibles. Dans ce cas Vim se rabattra silencieusement sur l'anglais.
   Pour déterminer les langues supportées par votre système, trouvez le
répertoire où elles sont listées. Sur mon système il s'agit de
"/usr/share/locale". Sur certains systèmes c'est "/usr/lib/locale". La page de
manuel de `setlocale` devrait vous aider à déterminer cet emplacement sur
votre système.
   Attention à saisir le nom avec exactitude. La casse est prise en compte, et
les caractères '-' et '_' se confondent facilement.

Vous pouvez aussi fixer séparément la langue des messages, celle du texte
édité et celle utilisée pour la date. Voir |:language|.


TRADUIRE SOI-MÊME LES MESSAGES

Si la traduction des messages n'est pas disponible pour votre langue, vous
pouvez la faire vous-même. Pour cela, récupérez le code source de Vim ainsi
que le paquetage GNU gettext. Une fois les sources dépaquetées, vous trouverez
les instructions dans le fichier "src/po/README.TXT".
   Il n'est pas très difficile d'effectuer la traduction. Pas la peine d'être
un développeur. Bien entendu vous devez connaître l'anglais et la langue dans
laquelle vous traduisez.
   Lorsque vous êtes satisfait de votre traduction, envisagez de la rendre
disponible pour les autres. Déposez-la sur le site de Vim (http://vim.sf.net)
ou envoyez un courriel au responsable de Vim à l'adresse <maintainer@vim.org>.
Ou bien les deux.

==============================================================================
*45.2*	Langue utilisée pour les menus

Par défaut les menus sont en anglais. Pour être affichés dans votre langue
locale, ils doivent être traduits. Normalement si l'environnement est
configuré pour votre langue, cela se fait automatiquement. Vous n'avez rien à
faire. Mais cela ne fonctionne que si les traductions pour la langue
considérée sont disponibles.
   Supposons que vous êtes en Allemagne, votre langue est l'allemand mais vous
préférez utiliser "File" plutôt que "Datei". Vous pouvez remettre les menus en
anglais ainsi :

	:set langmenu=none

Il est également possible d'indiquer une langue :

	:set langmenu=nl_NL.ISO_8859-1

Comme précédemment, la différence entre '-' et '_' est importante. Par contre,
ici la casse n'est pas prise en compte.
   L'option 'langmenu' doit être fixée avant le chargement des menus. Une
fois les menus définis, le changement de l'option 'langmenu' n'a aucun effet
immédiat. Il vous faut donc mettre la commande qui définit 'langmenu' dans
votre fichier vimrc.
   Si vous voulez quand même changer la langue des menus sans quitter Vim,
vous pouvez le faire ainsi :

	:source $VIMRUNTIME/delmenu.vim
	:set langmenu=de_DE.ISO_8859-1
	:source $VIMRUNTIME/menu.vim

Il y a un inconvénient : la disparition de tous les menus que vous avez
définis vous-même. Vous devrez également les redéfinir.


TRADUIRE SOI-MÊME LES MENUS

Pour voir dans quelles langues les menus ont été traduits, regardez dans ce
répertoire :

	$VIMRUNTIME/lang 

Les fichiers sont nommés "menu_{langue}.vim". Si vous ne trouvez pas la langue
que vous voulez utiliser, vous pouvez effectuer la traduction vous-même. Le
plus simple est de copier l'une des traductions existantes puis de la
modifier.
   Tout d'abord déterminez le nom de votre langue avec la commande
":language". Utilisez ce nom, mais avec toutes les lettres en minuscules.
Ensuite copiez le fichier dans votre répertoire de support personnel, tel que
défini au début de 'runtimepath'. Par exemple, sous Unix, vous procéderiez
comme suit :

	:!cp $VIMRUNTIME/lang/menu_ko_kr.euckr.vim ~/.vim/lang/menu_nl_be.iso_8859-1.vim

Vous trouverez des conseils pour la traduction dans
"$VIMRUNTIME/lang/README.txt".

==============================================================================
*45.3*	Utiliser un encodage différent

Vim suppose que les fichiers que vous éditez sont encodés pour votre langue.
Pour bon nombre de langues européennes il s'agit de "latin1", avec lequel un
octet correspond à un caractère. Cela signifie qu'il existe 256 caractères
possibles. Pour les langues asiatiques ce n'est pas suffisant. La plupart du
temps ces langues utilisent un encodage à deux octets ce qui leur fournit plus
de dix mille caractères. Mais ce n'est toujours pas suffisant lorsqu'un texte
contient plusieurs langues différentes. C'est là qu'intervient Unicode.
Unicode a été conçu pour inclure tous les caractères utilisés dans la plupart
des langues usuelles. C'est le « super encodage qui remplace tous les
autres ». Mais pour le moment ce n'est pas tellement utilisé.
   Heureusement, Vim supporte ces trois types d'encodage. Et vous pouvez les
utiliser même lorsque votre environnement est configuré pour une autre langue
que celle du texte, avec quelques restrictions.
   Quoi qu'il en soit lorsque vous éditez des fichiers qui sont encodés dans
votre langue, le comportement de Vim par défaut devrait convenir, sans que
vous ayez à le modifier. Ce qui suit n'est intéressant que si vous voulez
éditer des langues différentes.

	NOTE :
	L'utilisation d'encodages différents fonctionne uniquement lorsque Vim
	a été compilé pour le supporter. Pour déterminer si c'est le cas,
	utilisez la commande ":version" et cherchez "+multi_byte" dans la
	réponse. Si vous le trouvez, c'est bon. Si vous voyez "-multi_byte",
	vous devrez trouver un autre Vim.


UTILISER UNICODE DANS L'IHM GRAPHIQUE

L'avantage d'Unicode est que l'on peut facilement convertir n'importe quel
encodage vers celui-là, et vice versa, sans perte d'information. Quand vous
configurez Vim pour qu'il utilise Unicode en interne, vous pouvez éditer des
fichiers dans n'importe quel encodage.
   Malheureusement le nombre de systèmes qui supportent Unicode est toujours
limité. Il est donc improbable que votre langue l'utilise. Vous devez indiquer
à Vim que vous voulez utiliser Unicode, et comment l'interfacer avec le reste
du système.
   Commençons par la version IHM graphique de Vim, qui est capable d'afficher
des caractères Unicode. Ceci devrait fonctionner :

	:set encoding=utf-8
	:set guifont=-misc-fixed-medium-r-normal--18-120-100-100-c-90-iso10646-1

L'option 'encoding' indique à Vim l'encodage des caractères que vous utilisez.
Cela s'applique au texte dans les tampons (les fichiers que vous êtes en train
d'éditer), les registres, les scripts Vim, etc. Vous pouvez considérer
'encoding' comme la valeur de l'encodage interne de Vim.
   Cet exemple présuppose que vous possédez cette police sur votre système. Le
nom de la police concerne le système X Window. Cette police se trouve dans un
paquetage permettant d'ajouter à xterm le support Unicode. Si vous ne possédez
pas cette police, vous la trouverez peut-être ici :

	http://www.cl.cam.ac.uk/~mgk25/download/ucs-fonts.tar.gz 

Pour MS-Windows, certaines polices ont un nombre limité de caractères Unicode.
Essayez d'utiliser la police "Courier New". Vous pouvez utiliser le menu
Edition/Sélectionner la Police... pour sélectionner et tester les polices
disponibles. Cela étant, seules les polices à espacement constant peuvent être
utilisées. Exemple :

	:set guifont=courier_new:h12

Si cela ne fonctionne pas, essayez de vous procurer un paquetage de polices.
Si Microsoft ne l'a pas déplacé, voyez à cette adresse :

	http://www.microsoft.com/typography/fontpack/default.htm 

Maintenant vous avez indiqué à Vim d'utiliser Unicode en interne et d'afficher
le texte avec une police Unicode. Les caractères saisis au clavier arrivent
toujours avec l'encodage de votre langue de départ. Il faut les convertir en
Unicode. Indiquez à Vim la langue depuis laquelle effectuer la conversion avec
l'option 'termencoding'. Vous pouvez le faire comme suit :

	:let &termencoding = &encoding
	:set encoding=utf-8

Ceci assigne l'ancienne valeur de 'encoding' à 'termencoding', avant de fixer
'encoding' à UTF-8. Vous devrez tester si cela fonctionne vraiment pour votre
configuration. Cela devrait particulièrement bien fonctionner si vous utilisez
la méthode de saisie d'une langue asiatique, et que vous voulez éditer le
texte en Unicode.


UTILISER UNICODE DANS UN TERMINAL UNICODE

Il y a des terminaux qui supportent Unicode directement. Le xterm standard
fourni avec XFree86 est de ceux-là. Utilisons-le comme exemple.
   Tout d'abord, xterm doit avoir été compilé avec le support Unicode. Voir
|UTF8-xterm| pour savoir comment vérifier si c'est le cas et comment le
compiler si besoin est.
   Lancez xterm avec l'argument "-u8". Il se peut que vous deviez également
indiquer une police. Exemple :

   xterm -u8 -fn -misc-fixed-medium-r-normal--18-120-100-100-c-90-iso10646-1

À présent vous pouvez démarrer Vim dans ce terminal. Fixez 'encoding' à
"utf-8" comme précédemment. C'est tout.


UTILISER UNICODE DANS UN TERMINAL ORDINAIRE

Supposons que vous vouliez travailler sur des fichiers Unicode, mais que vous
n'ayez pas de terminal Unicode. Vous pouvez le faire avec Vim, mais dans ce
cas les caractères non supportés par le terminal ne seront pas affichés. La
disposition du texte sera préservée.

	:let &termencoding = &encoding
	:set encoding=utf-8

C'est la même chose que pour l'IHM graphique. Mais le fonctionnement est
différent : Vim convertira le texte à afficher avant de l'envoyer au terminal.
Cela évite de salir l'écran avec des caractères étranges.
   Pour que cette méthode fonctionne, la conversion entre 'termencoding' et
'encoding' doit être possible. Vim sait faire la conversion de latin1 vers
Unicode, si bien que ce cas fonctionnera toujours. Pour les autres conversions
la fonctionnalité |+iconv| est requise.
   Essayez d'éditer un fichier comportant des caractères Unicode. Vous
remarquerez que Vim met un point d'interrogation (ou bien un caractère de
soulignement, ou un autre caractère) là où se trouve un caractère que le
terminal ne peut pas afficher. Déplacez le curseur sur un point
d'interrogation et utilisez cette commande :

	ga

Vim affichera une ligne avec le code du caractère, ce qui vous permet de
savoir de quel caractère il s'agit. Vous pouvez le chercher dans une liste
Unicode. En fait vous pourriez visualiser un fichier de cette manière, si vous
aviez beaucoup de temps devant vous.

	NOTE :
	Étant donné que 'encoding' est utilisé pour la totalité du texte dans
	Vim, sa modification rend tout texte non-ASCII invalide. Vous le
	remarquerez en utilisant les registres et le fichier 'viminfo'
	(p. ex., un rappel de motif de recherche). Il est recommandé de fixer
	'encoding' dans votre fichier vimrc, et de ne plus y toucher.

==============================================================================
*45.4*	Éditer des fichiers avec un encodage différent

Supposons que vous ayez configuré Vim pour utiliser Unicode, et que vous
vouliez éditer un fichier encodé en 16-bits. Cela paraît simple, non ? Eh bien
en fait, Vim utilise en interne l'encodage UTF-8, c'est pourquoi l'encodage
16-bits doit être converti. Ainsi il y a une différence entre le jeu de
caractères (Unicode) et l'encodage (UTF-8 ou 16-bits).
   Vim essaye de détecter le type de fichier que vous éditez. Il utilise les
noms d'encodage dans l'option 'fileencodings'. Lorsqu'Unicode est utilisé, la
valeur par défaut est : "ucs-bom,utf-8,latin1". Cela signifie que Vim examine
le fichier pour voir si l'encodage est l'un des suivants :

	ucs-bom		Le fichier doit commencer par une marque d'encodage
			(BOM), ce qui permet la détection des encodages
			Unicode 16-bits, 32-bits et UTF-8.
	utf-8		Unicode UTF-8. Rejeté lorsqu'une séquence d'octets est
			illégale en UTF-8.
	latin1		Le bon vieil encodage 8-bits. Fonctionne dans tous les
			cas.

Lorsque vous commencez à éditer un fichier Unicode 16-bits qui comporte une
marque d'encodage, Vim le détecte et le convertit en UTF-8 lors de la lecture.
L'option 'fileencoding' (sans 's' à la fin) est fixée à la valeur détectée.
Dans ce cas il s'agit de "ucs-2le", c.-à-d. Unicode, deux octets et petit
boutiste. Ce format de fichier est usuel sur MS-Windows (p. ex., les fichiers
de base de registre).
   À l'enregistrement du fichier, Vim compare 'fileencoding' avec 'encoding'.
En cas de différence, le texte est converti.
   Si 'fileencoding' est vide cela signifie qu'aucune conversion ne doit être
effectuée. Dans ce cas Vim part du principe que le fichier est encodé avec
'encoding'.

Si la valeur par défaut de 'fileencodings' ne vous convient pas, vous pouvez y
mettre les encodages que vous voulez faire essayer par Vim. C'est seulement
lorsqu'une valeur apparaît comme invalide que Vim passe à la suivante. Mettre
"latin1" en premier ne fonctionne pas car ce n'est jamais illégal. Par
exemple, pour se rabattre sur le japonais lorsque le fichier n'a pas de marque
d'encodage et n'est pas encodé en UTF-8 :

	:set fileencodings=ucs-bom,utf-8,sjis

Voir |encoding-values| pour des suggestions. D'autres valeurs devraient
également fonctionner, selon les conversions disponibles.


FORCER UN ENCODAGE

Si la détection automatique d'encodage échoue vous devez indiquer à Vim
l'encodage du fichier. Exemple :

	:edit ++enc=koi8-r russe.txt

"++enc" permet de définir l'encodage à utiliser pour ce fichier uniquement.
Vim convertira le fichier depuis l'encodage spécifié, russe dans cet exemple,
vers 'encoding'. 'fileencoding' sera également fixé à l'encodage spécifié,
afin que la conversion inverse puisse être effectuée lors de l'enregistrement
du fichier.
   Le même argument peut s'appliquer pour enregistrer un fichier. Ainsi vous
pouvez utiliser Vim pour convertir un fichier. Exemple :

	:write ++enc=utf-8 russe.txt

	NOTE :
	La conversion peut entraîner une perte de caractères. La plupart du
	temps, la conversion d'un encodage donné en Unicode et vice versa n'a
	pas ce problème, pour peu qu'il n'y ait aucun caractère illégal. La
	conversion depuis Unicode vers d'autres encodages entraîne souvent des
	pertes d'information lorsque le fichier contient plus d'une langue.

==============================================================================
*45.5*	Saisir du texte dans une langue donnée

Les claviers d'ordinateur ont à peine plus de cent touches. Certaines langues
ont des milliers de caractères, Unicode en a dix mille. Dans ces conditions
comment saisir ces caractères ?
   Tout d'abord, lorsque vous n'utilisez pas trop de caractères spéciaux, vous
pouvez utiliser les digraphes. Ce sujet a déjà été traité, voir |24.9|.
   Lorsque vous écrivez dans une langue qui comporte bien plus de caractères
que de touches sur votre clavier, vous aurez à utiliser une méthode de saisie
[N.D.T. : "Input Method" ou IM]. Cela nécessite d'apprendre la correspondance
entre des touches pressées et le caractère associé. Si vous avez besoin d'une
méthode de saisie, vous en avez probablement déjà une sur votre système, qui
devrait fonctionner pour Vim comme pour les autres programmes. Pour plus de
détails voir |mbyte-XIM| pour le système X Window et |mbyte-IME| pour
MS-Windows.


CODAGE CLAVIER

Certaines langues utilisent un jeu de caractères non latin, mais qui compte à
peu près autant de caractères. Il est possible de mapper les touches aux
caractères. Pour ce faire Vim utilise les codages clavier.
   Supposons que vous vouliez saisir de l'hébreu. Vous pouvez charger le
codage clavier ainsi :

	:set keymap=hebrew

Vim essaye de trouver le codage clavier pour vous, en fonction de la valeur de
'encoding'. Si aucun fichier approprié n'est trouvé, vous obtenez un message
d'erreur.

Maintenant vous pouvez taper de l'hébreu en mode Insertion. En mode Normal, et
lorsque vous saisissez une commande ":", Vim passe automatiquement en mode
latin. Vous pouvez utiliser cette commande pour passer de l'hébreu au latin,
et vice versa :

	CTRL-^

Cela ne fonctionne que dans les modes Insertion et Ligne-de-commande. En mode
Normal le résultat est complètement différent (saute au fichier alternatif).
   L'utilisation du codage clavier est indiquée dans le message de mode, si
l'option 'showmode' est activée. Dans l'IHM graphique Vim indiquera
l'utilisation d'un codage clavier avec un curseur de couleur différente.
   Vous pouvez également changer l'utilisation du codage clavier avec les
options 'iminsert' et 'imsearch'.

Pour voir la liste des mappages, utilisez cette commande :

	:lmap

Dans l'IHM graphique, pour déterminer quels fichiers de codage clavier sont
disponibles, vous pouvez utiliser le menu Edition/Codage Clavier. Autrement
vous pouvez utiliser cette commande :

	:echo globpath(&rtp, "keymap/*.vim")


CRÉER SES PROPRES CODAGES CLAVIER

Vous pouvez créer votre propre fichier de codage clavier. Ce n'est pas très
difficile. Partez d'un fichier de codage clavier similaire à la langue que
vous voulez utiliser. Copiez-le dans le répertoire "keymap" de votre
répertoire de support personnel. Par exemple sous Unix, vous utiliseriez le
répertoire "~/.vim/keymap".
   Le nom du fichier de codage clavier doit ressembler à cela :

	keymap/{nom}.vim 
ou
	keymap/{nom}_{encodage}.vim 

{nom} est le nom du codage clavier. Choisissez un nom aussi simple que
possible, mais différent des codages clavier déjà existants (à moins que vous
ne vouliez remplacer un fichier de codage clavier déjà présent). {nom} ne doit
pas contenir de souligné ('_'). Éventuellement, ajoutez un encodage à utiliser
après un souligné. Exemples :

	keymap/hebrew.vim 
	keymap/hebrew_utf-8.vim 

Le contenu du fichier se comprend de lui-même. Examinez quelques-uns des
fichiers de codage clavier distribués avec Vim. Pour les détails, voir
|mbyte-keymap|.


DERNIER RECOURS

Si toutes les autres méthodes échouent, vous pouvez entrer n'importe quel
caractère avec CTRL-V :

	ENCODAGE   SAISIE		PLAGE 
	8-bits	   CTRL-V 123		décimal 0-255
	8-bits	   CTRL-V x a1		hexadécimal 00-ff
	16-bits	   CTRL-V u 013b	hexadécimal 0000-ffff
	31-bits	   CTRL-V U 001303a4	hexadécimal 00000000-7fffffff

Ne saisissez pas les espaces. Voir |i_CTRL-V_digit| pour plus de détails.

==============================================================================

Chapitre suivant : |usr_90.txt|  Installer Vim

Copyright : voir |manual-copyright|  vim:tw=78:ts=8:ft=help:norl: