*farsi.txt*                                    Pour les versions de Vim 6.2c


                       MANUEL DE REFERENCE DE VIM          par Mortaza Ghassab Shiran

De droite à gauche et codage clavier pour Vim                      *farsi* *Farsi*

{Vi ne possède aucune de ces commandes}

                                                                   *E27*
Pour pouvoir utiliser le support codage clavier Farsi et l'écriture de
droite à gauche, il est nécessaire de compiler Vim avec la fonctionnalité
|+farsi|.

Ces fonctions ont été écrites par Mortaza Ghassab Shiran <shiran@jps.net>


Introduction
------------
Dans les fichiers orientés de droite à gauche, les caractères apparaissent à
l'écran de la droite vers la gauche. Ce type de fichiers est très utilisé
lorsque l'on écrit des documents Farsi, compose des fax ou écrit des mémos Farsi.

Les commandes, invites et fichiers d'aide ne sont pas en Farsi, par conséquent,
l'interface homme-machine rappelle l'interface standard de Vi.


Avantages
---------

o  Edition des fichiers orientés de gauche à droite comme dans le Vi original,
   sans changement.

o  Apperçu et édition des fichiers dans les fenêtres de droite à gauche.
   L'orientation des fenêtres est propre à chacune, ainsi il est possible de
   voir le même fichier simultanément dans les modes droite à gauche et gauche
   à droite.

o  Compatibilité avec le Vi original. Presque toutes les fonctionnalités
   travaillent en mode droite à gauche (voir les bogues plus bas).

o  Changement du codage clavier et du mode d'insertion inversée en utilisant
   une seule commande.

o  Retour depuis le mode d'insertion inversée vers la place correcte dans le
   fichier (si possible).

o  Même en mode Farsi, les nombres sont entrés de la gauche vers la droite.
   Lorsqu'un caractère non numérique est entré, ce caractère sera inséré juste à
   gauche du dernier chiffre.

o  Aucun terminal spécial avec capacité de mode droite à gauche n'est requis.
   Les changements droite à gauche sont complétement indépendants du matériel. 
   Seule la police de caractères Farsi est nécessaire.

o  Codage clavier Farsi sur la ligne de commande en mode d'insertion inversé.

o  Basculement entre gauche à droite et droite à gauche via la touche de
   fonction F8.

o  Basculement entre encodage standard Farsi ISIR-3342 et Farsi VIM via la
   touche de fonction F9. Comme ceci ne prend sens que pour du texte écrit en
   mode droite à gauche, cette fonction n'est supportée seulement qu'en mode
   droite vers gauche.


Polices de caractères Farsi
---------------------------
Si l'archive "extra" est décompactée, les fichiers suivants se trouvent dans le
sous-répertoire du répertoire '$VIM/farsi':

   +  far-a01.pcf    police de caractères X Windows pour Unix incluant les systèmes Linux
   +  far-a01.bf     police de caractères X Windows pour SunOs
   +  far-a01.f16    une police de caractères d'écran pour Unix incluant les systèmes Linux
   +  far-a01.fon    une police de caractères à espacement unique pour Windows NT/95/98
   +  far-a01.com    une police de caractères d'écran pour DOS


Installation des polices de caractères
--------------------------------------

o  Installation des polices de caractères pour systèmes MS Windows (NT/95/98)

   Depuis le panneau de configuration, démarrez le programme 'Polices de
   caractères'. Alors, depuis le menu 'Fichier', sélectionnez l'item 'Installer
   une nouvelle police de caractères'. Selectionnez la police 'far-a01.fon', et
   suivez le guide d'installation.
   NOTE: Plusieurs personnes ont rapporté que cela ne fonctionnait pas. La
   solution n'est pas connue.

o  Installation des polices de caractères pour systèmes X Window (Unix/Linux)

   Selon votre système, copiez far-a01.pcf.Z ou far-a01.pcf.gz dans le
   répertoire de votre choix. Changez vers le répertoire contenant les polices
   Farsi et executez les commandes:
   
      >  mkfontdir
      >  xset +fp path_name_of_farsi_fonts_directory
      
o  Installation des polices de caractères pour systèmes X Window (SunOs)

   Copiez la police far-a01.bf dans le répertoire de votre choix. Changez vers
   le répertoire contenant la police far-a01.fb et executez les commandes:
   
      >  fldfamily
      >  xset +fp path_name_of_fonts_directory

o  Installation des polices de caractères d'écrans ASCII (Unix/Linux)

   Pour un système Linux, copiez le far-a01.f16 dans le répertoire
   /usr/lib/kbd/consolefonts et executez le programme setfont "setfont
   far-a01.f16". Pour les autres systèmes, (par exemple, SCO Unix), référez-vous
   s'il-vous-plaît à la section d'installation des polices de caractères de
   vos manuels d'administration système.

o  Installation des polices de caractères d'écrans ASCII (DOS)

   Après le démarrage de votre système, avant votre première utilisation de VIM,
   chargez les polices Farsi en executant le programme de chargement des polices
   far-a01.com.


Utilisation
-----------
Avant de démarrer Vim, l'environnement dans lequel Vim peut s'executer en mode
Farsi doit être défini. En plus de l'installation des polices Farsi, les
points suivants soumis à quelques environnements système, que vous devriez
définir : codages des codes claviers, chargement d'une carte graphique en mode
ASCII, placer le pilote entrée-sortie en mode 8 bits <8 bits clean mode>...

o  Placer les polices Farsi

   + Pour le GUI VIM, placez 'guifont' à far-a01. Pour cela, tappez 
     ':set guifont=far-a01' en mode normal dans la fenêtre VIM.

     Vous pouvez faire placer 'guifont' à far-a01 par VIM pendant le
     démarrage de VIP en ajoutant le ':set guifont=far-a01' à votre
     fichier .vimrc (_vimrc sur les plateformes NT/95/98).

     Sous environnement X, vous pouvez également lancer VIM avec l'option
     '-fn far-a01'.

   + Pour VIM à l'intérieur d'un xterm, lancez un xterm avec les polices
     Farsi (ex : kterm -fn far-a01). Ensuite, démarrez VIM dans ce
     terminal virtuel.

   + Pour VIM sous DOS, avant toute utilisation de VIM, téléchargez les
     polices Farsi en éxécutant le programme d'installation de polices
     far-a01.com.
	 
o  Activation du codage clavier Farsi

   Pour activer le codage clavier Farsi, positionnez soit 'altkeymap', soit
   'fkmap'. Ceci peut être effectué en entrant ':set akm' ou ':set fk' dans la
   fenêtre VIM. Vous pouvez avoir 'altkeymap' ou 'fkmap' positionné par défaut
   en ajoutant ':set akm' ou ':set fk' dans votre fichier .vimrc ou _vimrc
   dans le cas des plateformes NT/95/98.

   Pour désactiver le codage clavier Farsi comme second codage clavier par
   défaut, réinitialisez 'altkeymap' en entrant ':set noakn'.

o  Mode Farsi de droite à gauche

   Par défaut, VIM démarre en mode gauche à droite. Pour changer l'orientation
   de la fenêtre, vous pouvez :

   + soit démarrer VIM avec l'option -F (ex : vim -F ...).

   + soit utiliser la touche de fonction F8 pour basculer entre les
     orientations gauche à droite ou droite à gauche.

   + soit entrer 'set rl' dans la ligne de commande en orientation gauche à
     droite ('rl' est l'abréviation pour rightleft).

   + Placer la ligne 'set rl' dans votre fichier .vimrc pour démarrer VIM en
     mode droite à gauche de façon permanente.


Encodage
--------
L'encodage des lettres utilisé est le standard VIM ISIR-3342 étendu avec une
fonction interne de conversion entre le ISIR-3342 standard et le VIM ISIR-3342
étendu.

Pour des raisons de portabilité de documents, l'encodage des caractères est
conservé à l'identique d'une plateforme à l'autre (i.e. UNIX, NT/95/98,
MS DOS, ...).

o  Clavier

   + CTRL-_ en mode insertion/remplacement bascule entre les modes
     Farsi(akm)/Latin comme suit :

   + CTRL-_ déplace le curseur jusqu'à la fin du texte tappé en mode
     d'édition.

   + CTRL-_ en mode commande bascule seulement le codage clavier entre les
     modes Farsi(akm)/Latin. Le texte Farsi est alors entré en mode insertion
     renversé.

   + F8 - bascule entre les orientations gauche à droite et droite à gauche.

   + F9 - bascule l'encodage entre le ISIR-3342 standard et le VIM ISIR-3342
     étendu de VIM (supporté seulement en mode droite à gauche).

   + le codage clavier est basé sur le standard ISIRI-2901 iranien.
     La table qui suit montre le codage clavier lorsque le mode Farsi(akm) est
     activé :

        -------------------------------------
        `  1  2  3  4  5  6  7  8  9  0  -  =
        ¢  ±  ²  ³  ´  µ  ¶  ·  ¸  ¹  °    ½
        -------------------------------------
        ~  !  @  #  $  %  ^  &  *  (  )  _  +
        ~  £  §  ®  ¤  ¥  ª  ¬  è  ¨  ©  é  «
        -------------------------------------
        q  w  e  r  t  z  u  i  o  p  [  ]
        Ó  Ò  Æ  Ù  Ø  Õ  Ö  à  Ê  É  Ç  ~H
        -------------------------------------
        Q  W  E  R  T  Z  U  I  O  P  {  }
        ÷  õ  ô  ó  ò  ý  ð  ö  [  ]  {  }
        -------------------------------------
        a  s  d  f  g  h  j  k  l  ;  '  \
        Ñ  Ð  á  Ã  Ü  Á  Å  Þ  Ý  Ú  Û  ë
        -------------------------------------
        A  S  D  F  G  H  J  K  L  :  "  |
        ù  û|  þ  ú  ø  À  ü  æ  ç  º  »  ê
        -------------------------------------
        <  y  x  c  v  b  n  m  ,  .  /
        ¾  ×  Ô  Î  Í  Ì  Ë  Ä  ß  ¦  ¯
        -------------------------------------
        >  Y  X  C  V  B  N  M  <  >  ?
        ¼  ñ  Ô  Ï  Í  ¡  Ë  Â  ¾  ¼  ¿
        -------------------------------------

Note :
        ¡  à la place de Farsi PSP (coupure sans espace)

        ¢  à la place de Farsi PCN (pour attribut HAMZE)


Restrictions
------------

o  CTRL-B n'est pas supporté en mode insertion/remplacement lorsque fkmap
   (Farsi mode) activé.

o  Si vous changez de codage de caractères entre Latin/Farsi, le tampon
   redo (refaire) sera réinitialisé (vidé). Ainsi, redo est valide et
   fonctionne (en utilisant '.') seulement dans le mode dans lequel vous êtes.

o  Quand des nombres sont entrés en mode Farsi, le tampon redo est
   réinitialisé (vidé). Ainsi, vous ne pouvez refaire le dernier changement
   (en utilisant '.') après avoir entré des nombres.

o  CTRL-R n'est pas supporté quand les modes gauche vers droite et Farsi
   sont activés.

o  En mode droite vers gauche, la recherche de motifs latins ne fonctionne
   pas, sauf si vous entrez le motif de recherche à l'envers.

o  En mode commande, il n'y a pas de support pour entrer les nombres de gauche
   à droite et, aussi, par soucis de flexibilité, la logique de codage clavier
   est restreinte.

o  Sous l'environnement X Window, si vous souhaitez éxécuter VIM dans un
   émulateur de terminaux xterm avec le mode Farsi activé, vous devez avoir un
   émulateur de terminaux xterm compatible ANSI. Ceci parce que les codes
   caractères au dessus de 128 (en décimal) ont certaines significations dans
   l'émulateur de terminaux standard.

   Note : Sous un environnement X Window, GUI VIM fonctionne bien en mode
          Farsi. Cela élimine toute nécessité d'émulateur de terminaux.

Bogues
------
En mode insertion/remplacement et en mode Farsi, si vous changez à plusieurs
reprises la position du curseur (via des mouvements de curseur) et entrez du
nouveau texte, et essayez de défaire le dernier changement, cette commande
sera en retard d'un changement. Mais, si vous continuez à défaire, vous
retrouverez la ligne de texte originale. Vous pouvez aussi utiliser U pour
défaire tous les changements faits sur la ligne courante.

Pour plus d'informations concernant les bogues, confère rileft.txt.

 vim:tw=78:ts=8:ft=help:norl: