Current File : //usr/share/doc/brltty/French/BRLTTY-6.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<TITLE>Manuel de r�f�rence de BRLTTY: Tables</TITLE>
<LINK HREF="BRLTTY-7.html" REL=next>
<LINK HREF="BRLTTY-5.html" REL=previous>
<LINK HREF="BRLTTY.html#toc6" REL=contents>
</HEAD>
<BODY>
<A HREF="BRLTTY-7.html">Page suivante</A>
<A HREF="BRLTTY-5.html">Page pr�c�dente</A>
<A HREF="BRLTTY.html#toc6">Table des mati�res</A>
<HR>
<H2><A NAME="tables"></A> <A NAME="s6">6.</A> <A HREF="BRLTTY.html#toc6">Tables</A></H2>
<H2><A NAME="table-text"></A> <A NAME="ss6.1">6.1</A> <A HREF="BRLTTY.html#toc6.1">Tables de texte</A>
</H2>
<P>Les fichiers ayant un nom sous la forme <CODE>*.ttb</CODE> sont des tables de texte,
et ceux avec des noms de la forme <CODE>*.tti</CODE> sont des sous-tables de texte.
Elles sont utilis�es par BRLTTY pour traduire les caract�res � l'�cran
dans les repr�sentations brailles qui correspondent � l'informatique 8 points.</P>
<P>Au d�part, BRLTTY est configur� pour utiliser la table de texte
<A HREF="BRLTTY-15.html#nabcc">North American Braille Computer Code</A>
(NABCC) (code informatique braille nord-am�ricain).
En plus de celle-ci par d�faut, les alternatives suivantes sont fournies:</P>
<P>
<BR><CENTER>
<TABLE BORDER><TR><TD>
Nom</TD><TD>Langue</TD></TR><TR><TD>
auto</TD><TD>s�lection automatique bas�e sur la locale</TD></TR><TR><TD>
ar</TD><TD>Arabe (g�n�rique)</TD></TR><TR><TD>
as</TD><TD>Assamese</TD></TR><TR><TD>
awa</TD><TD>Awadhi</TD></TR><TR><TD>
bg</TD><TD>Bulgare</TD></TR><TR><TD>
bh</TD><TD>Bihari</TD></TR><TR><TD>
bn</TD><TD>Bengali</TD></TR><TR><TD>
bo</TD><TD>Tib�tin</TD></TR><TR><TD>
bra</TD><TD>Braj</TD></TR><TR><TD>
brf</TD><TD>Format pr�t-�-embosser</TD></TR><TR><TD>
</TD><TD>(pour voir des fichiers .brf dans un �diteur ou un pager)</TD></TR><TR><TD>
cs</TD><TD>Tch�que</TD></TR><TR><TD>
cy</TD><TD>Gallois</TD></TR><TR><TD>
da</TD><TD>Danois</TD></TR><TR><TD>
da-1252</TD><TD>Danois (Svend Thougaard, 18-11-2002)</TD></TR><TR><TD>
da-lt</TD><TD>Danois (LogText)</TD></TR><TR><TD>
de</TD><TD>Allemand</TD></TR><TR><TD>
dra</TD><TD>Dravidian</TD></TR><TR><TD>
el</TD><TD>Grec</TD></TR><TR><TD>
en</TD><TD>Anglais</TD></TR><TR><TD>
en_CA</TD><TD>Anglais (Canada)</TD></TR><TR><TD>
en_GB</TD><TD>Anglais (Royaume-Uni)</TD></TR><TR><TD>
en_US</TD><TD>Anglais (�tats-Unis)</TD></TR><TR><TD>
en-nabcc</TD><TD>Anglais (code informatique braille nord-am�ricain)</TD></TR><TR><TD>
eo</TD><TD>Esperanto</TD></TR><TR><TD>
es</TD><TD>Espagnol</TD></TR><TR><TD>
et</TD><TD>Estonien</TD></TR><TR><TD>
fi</TD><TD>Finnois</TD></TR><TR><TD>
fr</TD><TD>Fran�ais</TD></TR><TR><TD>
fr_CA</TD><TD>Fran�ais (Canada)</TD></TR><TR><TD>
fr_FR</TD><TD>Fran�ais (France)</TD></TR><TR><TD>
fr-2007</TD><TD>Fran�ais (unifi� 2007)</TD></TR><TR><TD>
fr-cbifs</TD><TD>Fran�ais (Code Braille Informatique Français Standard)</TD></TR><TR><TD>
fr-vs</TD><TD>Fran�ais (VisioBraille)</TD></TR><TR><TD>
ga</TD><TD>Irlandais</TD></TR><TR><TD>
gd</TD><TD>Ga�lique</TD></TR><TR><TD>
gon</TD><TD>Gondi</TD></TR><TR><TD>
gu</TD><TD>Gujrati</TD></TR><TR><TD>
he</TD><TD>H�breux</TD></TR><TR><TD>
hi</TD><TD>Hindi</TD></TR><TR><TD>
hr</TD><TD>Croate</TD></TR><TR><TD>
hu</TD><TD>Hongrois</TD></TR><TR><TD>
hy</TD><TD>Arm�nien</TD></TR><TR><TD>
is</TD><TD>Islandais</TD></TR><TR><TD>
it</TD><TD>Italien</TD></TR><TR><TD>
kha</TD><TD>Khasi</TD></TR><TR><TD>
kn</TD><TD>Kannada</TD></TR><TR><TD>
kok</TD><TD>Konkani</TD></TR><TR><TD>
kru</TD><TD>Kurukh</TD></TR><TR><TD>
lt</TD><TD>Lituanien</TD></TR><TR><TD>
lv</TD><TD>L�ton</TD></TR><TR><TD>
mg</TD><TD>Malagasy</TD></TR><TR><TD>
mi</TD><TD>Maori</TD></TR><TR><TD>
ml</TD><TD>Malayalam</TD></TR><TR><TD>
mni</TD><TD>Manipuri</TD></TR><TR><TD>
mr</TD><TD>Marathi</TD></TR><TR><TD>
mt</TD><TD>Maltaiss</TD></TR><TR><TD>
mun</TD><TD>Munda</TD></TR><TR><TD>
mwr</TD><TD>Marwari</TD></TR><TR><TD>
ne</TD><TD>N�palais</TD></TR><TR><TD>
new</TD><TD>Newari</TD></TR><TR><TD>
nl</TD><TD>Autrichien</TD></TR><TR><TD>
nl_BE</TD><TD>Autrichien (Belge)</TD></TR><TR><TD>
nl_NL</TD><TD>Autrichien (Pays-Bas)</TD></TR><TR><TD>
no</TD><TD>Norv�gien</TD></TR><TR><TD>
no-generic</TD><TD>Norv�gien (avec le support des autres langues)</TD></TR><TR><TD>
no-oup</TD><TD>Norv�gien (Offentlig Utvalg for punktskrift)</TD></TR><TR><TD>
nwc</TD><TD>Newari (ancien)</TD></TR><TR><TD>
or</TD><TD>Oriya</TD></TR><TR><TD>
pa</TD><TD>Panjabi</TD></TR><TR><TD>
pi</TD><TD>Pali</TD></TR><TR><TD>
pl</TD><TD>Polonais</TD></TR><TR><TD>
pt</TD><TD>Portuguais</TD></TR><TR><TD>
ro</TD><TD>Roumain</TD></TR><TR><TD>
ru</TD><TD>Russe</TD></TR><TR><TD>
sa</TD><TD>Sanscrit</TD></TR><TR><TD>
sat</TD><TD>Santali</TD></TR><TR><TD>
sd</TD><TD>Sindhi</TD></TR><TR><TD>
se</TD><TD>Sami (du Nord)</TD></TR><TR><TD>
sk</TD><TD>Slovaque</TD></TR><TR><TD>
sl</TD><TD>Slov�ne</TD></TR><TR><TD>
sv</TD><TD>Su�dois</TD></TR><TR><TD>
sv-1989</TD><TD>Su�dois (standard 1989)</TD></TR><TR><TD>
sv-1996</TD><TD>Su�dois (standard 1996)</TD></TR><TR><TD>
sw</TD><TD>Swahili</TD></TR><TR><TD>
ta</TD><TD>Tamoul</TD></TR><TR><TD>
te</TD><TD>Telugu</TD></TR><TR><TD>
tr</TD><TD>Turc</TD></TR><TR><TD>
uk</TD><TD>Ukrainien</TD></TR><TR><TD>
vi</TD><TD>Vietnamien</TD></TR><TR><TD>
</TD></TR></TABLE>
</CENTER><BR>
</P>
<P>Voir l'option
<A HREF="BRLTTY-4.html#options-text-table">-t</A> en ligne de commande,
la ligne
<A HREF="BRLTTY-4.html#configure-text-table">text-table</A> du fichier de
configuration, et l'option de compilation
<A HREF="BRLTTY-3.html#build-text-table">--with-text-table</A> pour des d�tails
concernant la fa�on d'utiliser et de changer de table de texte.</P>
<H3>Format des tables de texte</H3>
<P>Une table de texte consiste en une s�quence d'instructions, une par ligne,
qui d�finit comment chaque caract�re doit �tre repr�sent� en braille
Vous devez utiliser l'encodage <CODE>UTF-8</CODE>.
Un blanc (espaces, tabs) tant au d�but de la ligne qu'aavant et/ou apr�s
l'op�rateur d'une instruction, est ignor�.</P>
<P>Les lignes ne contenant que des blancs sont ignor�es.
Si le premier caract�re non blanc d'une ligne est "#", cette ligne est
un commentaire et est ignor�e.</P>
<H3>Instructions des tables de texte</H3>
<P>Les instructions suivantes sont fournies:
<DL>
<DT><B><CODE>char</CODE> <EM>caract�re</EM> <EM>points</EM> # <EM>commentaire</EM></B><DD>
<P>Utilise l'instruction <CODE>char</CODE> pour sp�cifier la fa�on dont un caract�re
Unicode sera repr�sent� en braille. Les caract�res d�finis par cette
instruction peuvent �galement �tre saisies au clavier braille. Si plusieurs
caract�res ont la m�me repr�sentation braille, vous ne devriez en d�finir
qu'un avec la ligne <CODE>char</CODE> - vous devriez d�finir l'autre avec la ligne
<CODE>glyph</CODE> (dont la syntaxe est identique). Si plus d'un caract�re ayant la
m�me repr�sentation braille est d�fini avec l'instruction <CODE>char</CODE>
(ce qui est actuellement possible pour des questions de r�trocompatibilit�),
c'est la premi�re qui est s�lectionn�e. </P>
<P>
<DL>
<DT><B><EM>caract�re</EM></B><DD>
<P>Le caract�re Unicode qui sera d�fini. Cela peut �tre:
<UL>
<LI>Tout caract�re diff�rent d'un antislash ou d'un caract�re blanc.</LI>
<LI>Un caract�re sp�cial pr�c�d� d'un anti-slash.
Ce sont:
<DL>
<P>- </P>
<DT><B>\b</B><DD>
<P>Le caract�re Effacement
- </P>
<DT><B>\f</B><DD>
<P>Le caract�re formfeed
- </P>
<DT><B>\n</B><DD>
<P>Le caract�re Nouvelle ligne.
- </P>
<DT><B>\o###</B><DD>
<P>La repr�sentation octale � 3 chiffres d'un caract�re.
- </P>
<DT><B>\r</B><DD>
<P>Le caract�re retour chariot
- </P>
<DT><B>\s</B><DD>
<P>Le caract�re Espace
- </P>
<DT><B>\t</B><DD>
<P>Le caract�re Tab horizontal
- </P>
<DT><B>\u####</B><DD>
<P>La repr�sentation hexad�cimale � quatre chiffres d'un caract�re.
- </P>
<DT><B>\U########</B><DD>
<P>La repr�sentation hexad�cimale � huit chiffres d'un caract�re.
- </P>
<DT><B>\v</B><DD>
<P>Le caract�re tab vertical
- </P>
<DT><B>\x##</B><DD>
<P>La repr�sentation hexad�cimale � deux chiffres d'un caract�re.
- </P>
<DT><B>\X##</B><DD>
<P>... (la casse du X et des chiffres n'a pas de signification)
- </P>
<DT><B>\#</B><DD>
<P>Signe d'un nombre litt�ral.
- </P>
<DT><B>\<name></B><DD>
<P>Le nom Unicode d'un caract�re (utilisez _ pour l'espace).
- </P>
<DT><B>\\</B><DD>
<P>Un antislash litt�ral.</P>
</DL>
</LI>
</UL>
</P>
<DT><B><EM>dots</EM></B><DD>
<P>La repr�sentation braille du caract�re Unicode. C'est une s�quence d'un
� huit nombres de points. Si la s�quence du nombre de points est entour�e
de parenth�ses, vous pouvez s�parer les num�ros des points l'un de l'autre
par des blancs. Un num�ro de point est un chiffre compris entre <CODE>1</CODE>-<CODE>8</CODE>
tels que d�finis par la
<A HREF="BRLTTY-13.html#dots">Standard Braille Dot Numbering Convention</A> (convention
standard de num�rotation de points brailles). Le num�ro de point sp�cial <CODE>0</CODE>
est reconnu quand il n'est pas entour� de parenth�ses, et il signifie aucun
point; il ne peut �tre utilis� parall�lement � un autre num�ro de point.</P>
</DL>
</P>
<P>Exemples:
<UL>
<LI><CODE>char a 1</CODE></LI>
<LI><CODE>char b (12)</CODE></LI>
<LI><CODE>char c ( 4 1 )</CODE></LI>
<LI><CODE>char \\ 12567</CODE></LI>
<LI><CODE>char \s 0</CODE></LI>
<LI><CODE>char \x20 ()</CODE></LI>
<LI><CODE>char \<LATIN_SMALL_LETTER_D> 145</CODE></LI>
</UL>
</P>
<DT><B><CODE>glyph</CODE> <EM>caract�re</EM> <EM>dots</EM> # <EM>comment</EM></B><DD>
<P>Utilisez l'instruction <CODE>glyph</CODE> pour sp�cifier la fa�on dont doit �tre
repr�sent� en braille un caract�re Unicode. Les caract�res d�finis avec
cette instruction peuvent uniquement �tre affich�s. On ne peut pas les
saisir au clavier braille. Voir la ligne <CODE>char</CODE> pour les d�tails sur
la syntaxe et pour des exemples.</P>
<DT><B><CODE>byte</CODE> <EM>byte</EM> <EM>points</EM> # <EM>commentaire</EM></B><DD>
<P>Utilisez l'instruction <CODE>byte</CODE> pour sp�cifier comment un caract�re en encodage local
doit �tre repr�sent� en braille. Il a �t� retenu pour des raisons de
compatibilit� mais ne devrait pas �tre utilis�.</P>
<P>Les caract�res Unicode devraient �tre d�finis
(via l'instruction <CODE>char</CODE>) de telle sorte que la table de texte demeure
valide par rapport � l'encodage local.</P>
<P>
<DL>
<DT><B><EM>byte</EM></B><DD>
<P>Le caract�re local d�fini. Il peut �tre sp�cifi� de la m�me mani�re que
l'op�rateur <EM>caract�re</EM> de l'instruction <CODE>char</CODE> sauf que les formes
sp�cifiques � l'Unicode (\u, \U, \<) ne peuvent pas �tre utilis�es.</P>
<DT><B><EM>points</EM></B><DD>
<P>La repr�sentation braille du caract�re local.
Il peut �tre sp�cifi� de la m�me mani�re que
l'op�rateur <EM>points</EM> de l'instruction <CODE>char</CODE>.</P>
</DL>
</P>
<DT><B><CODE>include</CODE> <EM>fichier</EM> # <EM>commentaire</EM></B><DD>
<P>Utilisez l'instruction <CODE>include</CODE> pour inclure le contenu d'une sous-table de
texte. Elle est r�cursive, ce qui signifie que toute sous-table de texte peut
inclure elle-m�me une autre sous-table de texte. Prenez soin de vous
assurer de ne pas cr�er une "inclusion en boucle".</P>
<P>
<DL>
<DT><B><EM>fichier</EM></B><DD>
<P>Le fichier � inclure. Cela peut �tre un chemin relatif ou absolu. Si c'est
relatif, il est ancr� au r�pertoire contenant le fichier qui inclut.</P>
</DL>
</P>
</DL>
</P>
<H2><A NAME="table-attributes"></A> <A NAME="ss6.2">6.2</A> <A HREF="BRLTTY.html#toc6.2">Tables d'attributs</A>
</H2>
<P>Les fichiers aux noms sous la forme *.atb sont des tables d'attributs et ceux
aux noms sous la forme *.ati sont des sous-tables d'attributs. Ils sont
utilis�s quand BRLTTY affiche les
attributs de l'�cran au lieu du contenu de l'�cran (voir la commande
<A HREF="BRLTTY-4.html#command-DISPMD">DISPMD</A>).
Chacun des huit points braille repr�sente l'un des huit bits d'attributs
<CODE>VGA</CODE>.
Les tables d'attributs suivantes sont fournies:
<DL>
<DT><B>left_right</B><DD>
<P>La colonne � gauche repr�sente les couleurs de premier plan:
<DL>
<DT><B>Point 1</B><DD>
<P>Bleu</P>
<DT><B>Point 2</B><DD>
<P>Vert</P>
<DT><B>Point 3</B><DD>
<P>Rouge</P>
<DT><B>Point 7</B><DD>
<P>Brillant</P>
</DL>
La colonne � droite repr�sente les couleurs de fond:
<DL>
<DT><B>Point 4</B><DD>
<P>Bleu</P>
<DT><B>Point 5</B><DD>
<P>Vert</P>
<DT><B>Point 6</B><DD>
<P>Rouge</P>
<DT><B>Point 8</B><DD>
<P>Clignotant</P>
</DL>
Un point est affich� quand son bit d'attribut correspondant est actif.
C'est la table d'attributs par d�faut car c'est la plus
intuitive. Cependant, l'un de ses probl�mes est qu'il est difficile de
distinguer la diff�rence entre la vid�o normale (noir sur blanc) et invers�e
(blanc sur noir).</P>
<DT><B>invleft_right</B><DD>
<P>La colonne � gauche repr�sente les couleurs de premier plan:
<DL>
<DT><B>Point 1</B><DD>
<P>Bleu</P>
<DT><B>Point 2</B><DD>
<P>Vert</P>
<DT><B>Point 3</B><DD>
<P>Rouge</P>
<DT><B>Point 7</B><DD>
<P>Brillant</P>
</DL>
La colonne � droite repr�sente les couleurs de fond:
<DL>
<DT><B>Point 4</B><DD>
<P>Bleu</P>
<DT><B>Point 5</B><DD>
<P>Vert</P>
<DT><B>Point 6</B><DD>
<P>Rouge</P>
<DT><B>Point 8</B><DD>
<P>Clignotant</P>
</DL>
Un bit de fond est actif pour g�n�rer ses points correspondant, tandis
qu'un bit de premier plan est inactif pour g�n�rer son point correspondant.
Cette logique non intuitive facilite en fait la lecture de la plupart des
combinaisons d'attributs commun�ment utilis�es.</P>
<DT><B>upper_lower</B><DD>
<P>Le carr� sup�rieur repr�sente les couleurs de premier plan:
<DL>
<DT><B>Point 1</B><DD>
<P>Rouge</P>
<DT><B>Point 4</B><DD>
<P>Vert</P>
<DT><B>Point 2</B><DD>
<P>Bleu</P>
<DT><B>Point 5</B><DD>
<P>Brillant</P>
</DL>
Le carr� inf�rieur repr�sente les couleurs d'arri�re-plan:
<DL>
<DT><B>Point 3</B><DD>
<P>Rouge</P>
<DT><B>Point 6</B><DD>
<P>Vert</P>
<DT><B>Point 7</B><DD>
<P>Bleu</P>
<DT><B>Point 8</B><DD>
<P>Clignotant</P>
</DL>
Un point s'affiche quand le bit de l'attribut qui y correspond est actif.</P>
</DL>
Voir l'option
<A HREF="BRLTTY-4.html#options-attributes-table">-a</A> en ligne de
commande, la ligne
<A HREF="BRLTTY-4.html#configure-attributes-table">attributes-table</A>
du fichier de configuration, et l'option de compilation
<A HREF="BRLTTY-3.html#build-attributes-table">--with-attributes-table</A> pour des
d�tails concernant l'utilisation et le changement de table
d'attributs.</P>
<H3>Format des tables d'attributs</H3>
<P>Une table d'attributs est une s�quence de lignes de commande, avec une
commande par ligne, qui d�finit comment doit �tre repr�sent� en braille les
combinaisons des attributs <CODE>VGA</CODE>. Vous devez utiliser un encodage de caract�res
<CODE>UTF-8</CODE>.
Les espaces blancs (les vides, tabulations) au d�but d'une ligne, ou avant
et/ou apr�s l'op�rateur d'une ligne de commande, sont ignor�s.
Les lignes ne contenant que des espaces sont ignor�es.
Si le premier caract�re non-blanc d'une ligne est "#" cette ligne est un
commentaire et est ignor�e.</P>
<H3>Lignes de commande des tables d'attributs</H3>
<P>Les lignes de commande suivantes sont fournies:
<DL>
<DT><B><CODE>dot</CODE> <EM>point</EM> <EM>etat</EM> # <EM>commentaire</EM></B><DD>
<P>Utilisez l'instruction <CODE>dot</CODE> pour sp�cifier ce que repr�sente un point
particulier.</P>
<P>
<DL>
<DT><B><EM>point</EM></B><DD>
<P>Le point qui est d�fini. C'est une seule case allant de
<CODE>1</CODE> � <CODE>8</CODE> comme d�fini par la
<A HREF="BRLTTY-13.html#dots">Convention standard du nombre de points brailles</A>.</P>
<DT><B><EM>�tat</EM></B><DD>
<P>Ce que repr�sente le point. Il peut s'agir:
<DL>
<DT><B><CODE>on</CODE></B><DD>
<P>D'un point �lev� si l'attribut nomm� est actif.</P>
<DT><B><CODE>off</CODE></B><DD>
<P>D'un point enfonc� si l'attribut nomm� est inactif.</P>
</DL>
</P>
<P>Les noms des bits des attributs sont:
<DL>
<DT><B>0X01</B><DD>
<P><CODE>bleu premier plan</CODE></P>
<DT><B>0X02</B><DD>
<P><CODE>vert premier plan</CODE>/</P>
<DT><B>0X04</B><DD>
<P><CODE>rouge premier plan</CODE>/</P>
<DT><B>0X08</B><DD>
<P><CODE>brillant premier plan</CODE>/</P>
<DT><B>0X10</B><DD>
<P><CODE>fond bleu</CODE></P>
<DT><B>0X20</B><DD>
<P><CODE>fond vert</CODE></P>
<DT><B>0X40</B><DD>
<P><CODE>fond rouge</CODE></P>
<DT><B>0X80</B><DD>
<P><CODE>fond clignotant</CODE></P>
</DL>
</P>
</DL>
</P>
<P>Exemples:
<UL>
<LI><CODE>dot 1 =fg-red</CODE></LI>
<LI><CODE>dot 2 ~bg-blue</CODE></LI>
</UL>
</P>
<DT><B><CODE>include</CODE> <EM>fichier</EM> # <EM>commentaire</EM></B><DD>
<P>Utilisez la ligne <CODE>include</CODE> pour inclure le contenu d'une sous-table d'attributs.
Il est r�cursif, ce qui signifie que toute sous-table d'attributs peut
inclure elle-m�me une autre sous-table d'attributs. Prenez soin de vous
assurer de ne pas cr�er une "inclusion en boucle".</P>
<P>
<DL>
<DT><B><EM>fichier</EM></B><DD>
<P>Le fichier � inclure. Cela peut �tre un chemin relatif ou absolu. Si c'est
relatif, il est ancr� au r�pertoire contenant le fichier qui inclut.</P>
</DL>
</P>
</DL>
</P>
<H2><A NAME="table-contraction"></A> <A NAME="ss6.3">6.3</A> <A HREF="BRLTTY.html#toc6.3">Tables de braille abr�g�</A>
</H2>
<P>Les fichiers aux noms sous la forme <CODE>*.ctb</CODE> sont des tables de braille abr�g�
et ceux aux noms sous la forme <CODE>*.cti</CODE> sont des sous-tables de braille abr�g�.
Ils sont utilis�s par BRLTTY pour traduire des s�quences de caract�res � l'�cran
en leurs repr�sentations correspondantes en braille abr�g�. </P>
<P>BRLTTY pr�sente du braille abr�g� si:
<UL>
<LI>Une table de braille abr�g� a �t� s�lectionn�e.
Voir l'option
<A HREF="BRLTTY-4.html#options-contraction-table">-c</A> en ligne
de commande et la ligne
<A HREF="BRLTTY-4.html#configure-contraction-table">contraction-table</A> du
fichier de configuration pour des d�tails.</LI>
<LI>La fonction braille 6 points a �t� activ�e. Voir la commande
<A HREF="BRLTTY-4.html#command-SIXDOTS">SIXDOTS</A> et la pr�f�rence
<A HREF="BRLTTY-5.html#preference-text-style">Text Style</A> pour des d�tails.</LI>
</UL>
Cette possibilit� n'est pas disponible si vous avez sp�cifi� l'option de
compilation
<A HREF="BRLTTY-3.html#build-contracted-braille">--disable-contracted-braille</A>.</P>
<P>Les tables d'abr�g� suivantes sont fournies:</P>
<P>
<BR><CENTER>
<TABLE BORDER><TR><TD>
Nom</TD><TD>Langue</TD></TR><TR><TD>
auto</TD><TD>s�lection automatique bas�e sur la locale</TD></TR><TR><TD>
af</TD><TD>Afrikaans (abr�g�)</TD></TR><TR><TD>
am</TD><TD>Amharic (d�sabr�g�)</TD></TR><TR><TD>
de</TD><TD>Allemand</TD></TR><TR><TD>
de-g0</TD><TD>Allemand (d�sabr�g�)</TD></TR><TR><TD>
de-g1</TD><TD>Allemand (abr�viations de base)</TD></TR><TR><TD>
de-g2</TD><TD>Allemand (abr�g�)</TD></TR><TR><TD>
de-1998</TD><TD>Allemand (abr�g� - standard 1998)</TD></TR><TR><TD>
de-2015</TD><TD>Allemand (abr�g� - standard 2015)</TD></TR><TR><TD>
en</TD><TD>Anglais</TD></TR><TR><TD>
en_US</TD><TD>Anglais (USA)</TD></TR><TR><TD>
en-ueb-g1</TD><TD>Anglais (Braille anglais unifi�, 1er degr�)</TD></TR><TR><TD>
en-ueb-g2</TD><TD>Anglais (Braille anglais unifi�, 2�me degr�)</TD></TR><TR><TD>
en-us-g2</TD><TD>Anglais (USA, 2�me degr�)</TD></TR><TR><TD>
es</TD><TD>Espagnol (2�me degr�)</TD></TR><TR><TD>
fr</TD><TD>Fran�ais</TD></TR><TR><TD>
fr-g1</TD><TD>Fran�ais (d�sabr�g�)</TD></TR><TR><TD>
fr-g2</TD><TD>Fran�ais (abr�g�)</TD></TR><TR><TD>
ha</TD><TD>Hausa (abr�g�)</TD></TR><TR><TD>
id</TD><TD>Indon�sien (abr�g�)</TD></TR><TR><TD>
ipa</TD><TD>Alphabet phon�tique international</TD></TR><TR><TD>
ja</TD><TD>Japoneais (d�sabr�g�)</TD></TR><TR><TD>
ko</TD><TD>Cor�en</TD></TR><TR><TD>
ko-g0</TD><TD>Cor�en (d�sabr�g�)</TD></TR><TR><TD>
ko-g1</TD><TD>Cor�en (1er degr�)</TD></TR><TR><TD>
ko-g2</TD><TD>Cor�en (2�me degr�)</TD></TR><TR><TD>
lt</TD><TD>Lituanien</TD></TR><TR><TD>
mg</TD><TD>Malagasky (abr�g�)</TD></TR><TR><TD>
mun</TD><TD>Munda (abr�g�)</TD></TR><TR><TD>
nl</TD><TD>Autrichien (abr�g�)</TD></TR><TR><TD>
ny</TD><TD>Chichewa (abr�g�)</TD></TR><TR><TD>
pt</TD><TD>Portuguais (2�me degr�)</TD></TR><TR><TD>
ru</TD><TD>Russe (1er degr�)</TD></TR><TR><TD>
si</TD><TD>Cingalais (d�sabr�g�)</TD></TR><TR><TD>
sw</TD><TD>Swahili (abr�g�)</TD></TR><TR><TD>
th</TD><TD>Tha�landais (abr�g�)</TD></TR><TR><TD>
zh_TW</TD><TD>Chinois (Taiwan, d�sabr�g�)</TD></TR><TR><TD>
zu</TD><TD>Zoulou (abr�g�)</TD></TR><TR><TD>
</TD></TR></TABLE>
</CENTER><BR>
Voir l'option
<A HREF="BRLTTY-4.html#options-contraction-table">-c</A> en ligne de commande
et la ligne
<A HREF="BRLTTY-4.html#configure-contraction-table">contraction-table</A> du fichier de
configuration pour des d�tails sur la fa�on d'utiliser une table d'abr�g�.</P>
<H3>Format des tables de braille abr�g�</H3>
<P>Une table de braille abr�g� est une s�quence de lignes de commande, avec une
commande par ligne, qui d�finit comment les s�quences de caract�res vont �tre
repr�sent�es en braille. Vous devez utiliser un encodage de caract�res
<CODE>UTF-8</CODE>.</P>
<P>Les espaces blancs (les vides, tabulations) au d�but d'une ligne, ou avant
et/ou apr�s l'op�rateur d'une ligne de commande, sont ignor�s.
Les lignes ne contenant qu'� des espaces sont ignor�es.
Si le premier caract�re non-blanc d'une ligne est "#" cette ligne est un
commentaire et est ignor�e.</P>
<P>Le format d'une entr�e de table de braille abr�g� est:
<BLOCKQUOTE><CODE>
<EM>directive</EM> <EM>op�rateur</EM> ... [<EM>commentaire</EM>]
</CODE></BLOCKQUOTE>
Chaque ligne a un nombre d'op�rateurs sp�cifique.
Tout texte au-del� du dernier op�rateur d'une ligne est interpr�t� comme un commentaire.
L'ordre des entr�es � l'int�rieur de la table de braille abr�g� est, en g�n�ral, selon la
convenance de son/ses mainteneur(s).
Une entr�e qui d�finit une entit�, comme <CODE>class</CODE>,
doit pr�c�der toutes les r�f�rences de cette entit�.</P>
<P>Les entr�es qui correspondent � des s�quences de caract�res
sont automatiquement r�organis�es de la plus longue � la plus courte
afin que des correspondances plus longues soient toujours pr�f�r�es.
Si plus d'une entr�e correspond � la m�me s�quence de caract�res,
leur organisation d'origine dans la table est maintenue.
Ainsi, la m�me s�quence peut �tre traduite diff�remment dans des circonstances
diff�rentes. </P>
<H3>Op�rateurs des tables de braille abr�g�</H3>
<P>
<DL>
<DT><B><EM>characters</EM></B><DD>
<P>Le premier op�rateur d'une s�quence de caract�res correspondant � une ligne
est la s�quence de caract�res � laquelle elle doit correspondre.
Chaque caract�re dans la s�quence peut �tre:
<UL>
<LI>Tout caract�re diff�rent d'un antislash (barre oblique invers�e) ou d'un caract�re blanc.</LI>
<LI>Un caract�re sp�cial pr�c�d� d'une barre oblique invers�e.
Ce sont:
<DL>
<P>- </P>
<DT><B>\b</B><DD>
<P>Le caract�re Effacement
- </P>
<DT><B>\f</B><DD>
<P>Le caract�re formfeed
- </P>
<DT><B>\n</B><DD>
<P>Le caract�re Nouvelle ligne.
- </P>
<DT><B>\o###</B><DD>
<P>La repr�sentation octale � 3 chiffres d'un caract�re.
- </P>
<DT><B>\r</B><DD>
<P>Le caract�re retour chariot
- </P>
<DT><B>\s</B><DD>
<P>Le caract�re Espace
- </P>
<DT><B>\t</B><DD>
<P>Le caract�re Tab horizontale
- </P>
<DT><B>\u####</B><DD>
<P>La repr�sentation hexad�cimale � quatre chiffres d'un caract�re.
- </P>
<DT><B>\U########</B><DD>
<P>La repr�sentation hexad�cimale � huit chiffres d'un caract�re.
- </P>
<DT><B>\v</B><DD>
<P>Le caract�re tab verticale
- </P>
<DT><B>\x##</B><DD>
<P>La repr�sentation hexad�cimale � deux chiffres d'un caract�re.
- </P>
<DT><B>\X##</B><DD>
<P>... (la casse du X et des chiffres n'a pas de signification)
- </P>
<DT><B>\#</B><DD>
<P>Signe d'un nombre litt�ral.
- </P>
<DT><B>\<name></B><DD>
<P>Le nom Unicode d'un caract�re (utilisez _ pour l'espace).
- </P>
<DT><B>\\</B><DD>
<P>Un antislash litt�ral.</P>
</DL>
</LI>
</UL>
</P>
<DT><B><EM>representation</EM></B><DD>
<P>Le second op�rateur de ces lignes correspondant � la s�quence de caract�res
qui en a une est la repr�sentation braille de la s�quence.
Chaque cellule braille est sp�cifi�e comme une s�quence d'un � huit num�ros
de points. Un num�ro de point est un chiffre compris entre <CODE>1</CODE>-<CODE>8</CODE>
tels que d�finis par la
<A HREF="BRLTTY-13.html#dots">Standard Braille Dot Numbering Convention</A> (convention standard
de num�rotation de points brailles). Le num�ro de point sp�cial <CODE>0</CODE>
est reconnu quand il n'est pas entour� de parenth�ses, et il signifie aucun
point; il ne peut pas �tre utilis� parall�lement � un autre num�ro de point.</P>
</DL>
</P>
<H3><A NAME="contraction-opcodes"></A> Opcodes</H3>
<P>Un opcode est un mot-cl� qui dit au traducteur comment interpr�ter les
op�rateurs. Les opcodes sont group�s ici par leur fonction.</P>
<H3><A NAME="contraction-opcodes-administration"></A> Administration de la table</H3>
<P>Ces op�rateurs facilitent l'�criture des tables de braille abr�g�.
Ils n'ont pas d'effet direct sur la traduction de caract�re.
<DL>
<DT><B><CODE>include</CODE> <EM>chemin</EM>
<A NAME="contraction-opcode-include"></A> </B><DD>
<P>Inclut le contenu d'un autre fichier.
L'inclusion peut se faire � n'importe quel niveau.
Les chemins relatifs sont d�termin�s par rapport au r�pertoire du fichier inclu.</P>
<DT><B><CODE>locale</CODE> <EM>locale</EM>
<A NAME="contraction-opcode-locale"></A> </B><DD>
<P>D�finit la locale pour l'interpr�tation d'un caract�re (minuscule,
majuscule, num�rique, etc). La locale peut �tre d�finie comme:
<DL>
<DT><B><EM>langue</EM>[<CODE>_</CODE><EM>pays</EM>][<CODE>.</CODE><EM>charset</EM>][<CODE>@</CODE><EM>modifier</EM>]</B><DD>
<P>La composante <EM>langue</EM> est requise et devrait �tre un code de
langue � deux lettres <CODE>ISO-639</CODE>.
La composante <EM>pays</EM> est facultative et devrait �tre un code de
pays � deux lettres <CODE>ISO-3166</CODE>.
La composante <EM>charset</EM> est optionnelle et devrait �tre le nom
d'une table de caract�res, comme <CODE>ISO-8859-1</CODE>.</P>
<DT><B>C</B><DD>
<P>7-bit ASCII.</P>
<DT><B>-</B><DD>
<P>Aucune locale.</P>
</DL>
La derni�re sp�cification de locale s'applique � toute la table. Si
vous n'utilisez pas cet opcode, la locale <CODE>C</CODE> est utilis�e.</P>
</DL>
</P>
<H3><A NAME="contraction-opcodes-symbols"></A> D�finition d'un symbole sp�cial</H3>
<P>Ces opcodes d�finissent les caract�res sp�ciaux qui doivent �tre ins�r�s dans
le texte braille afin de le rendre plus clair.
<DL>
<DT><B><CODE>capsign</CODE> <EM>points</EM>
<A NAME="contraction-opcode-capsign"></A> </B><DD>
<P>Le symbole qui met en majuscule une seule lettre.</P>
<DT><B><CODE>begcaps</CODE> <EM>points</EM>
<A NAME="contraction-opcode-begcaps"></A> </B><DD>
<P>Le symbole qui commence un bloc de lettres en majuscule � l'int�rieur d'un
mot.</P>
<DT><B><CODE>endcaps</CODE> <EM>points</EM>
<A NAME="contraction-opcode-endcaps"></A> </B><DD>
<P>Le symbole qui termine un bloc de lettres en majuscules � l'int�rieur
d'un mot.</P>
<DT><B><CODE>letsign</CODE> <EM>points</EM>
<A NAME="contraction-opcode-letsign"></A> </B><DD>
<P>Le symbole qui d�signe une lettre ne faisant pas partie du mot.</P>
<DT><B><CODE>numsign</CODE> <EM>points</EM>
<A NAME="contraction-opcode-numsign"></A> </B><DD>
<P>Le symbole marquant le d�but d'un nombre.</P>
<DT><B><CODE>lastlargesign</CODE> <EM>points</EM>
<A NAME="contraction-opcode-numsign"></A> </B><DD>
<P>Traduit les caract�res quel que soit l'endroit o� ils apparaissent.
Supprime les espaces qui les pr�c�de si le mot pr�c�dent a �t� marqu�
par le code "largesign".</P>
</DL>
</P>
<H3><A NAME="contraction-opcodes-translation"></A> Traduction de caract�re</H3>
<P>Ces opcodes d�finissent les repr�sentations braille des s�quences de caract�res.
Chacun d'eux d�finit une entr�e � l'int�rieur de la table de braille abr�g�.
Ces entr�es peuvent �tre d�finies dans n'importe quel ordre, sauf, comme
remarqu� ci-dessous, lorsqu'elles d�finissent des repr�sentations
alternatives de la m�me s�quence de caract�res.</P>
<P>Chacun de ces opcodes a un op�rateurs <EM>caract�res</EM> (qui doit �tre
sp�cifi� comme une <EM>cha�ne</EM>), et une condition de configuration dirigeant
son utilisation.
Le texte est traduit strictement de la gauche vers la droite, caract�re par
caract�re, avec l'entr�e la plus acceptable pour chaque position utilis�e.
S'il y a plus d'une entr�e acceptable pour une position donn�e, celle ayant la
cha�ne de caract�res la plus longue est utilis�e. S'il y a plus d'une
entr�e acceptable pour la m�me cha�ne de caract�res, celle d�finie le plus
au d�but de la table est utilis�e (c'est la seule d�pendance de l'ordre).</P>
<P>Beaucoup de ces opcodes ont un op�rateur <EM>points</EM> qui d�finit la
repr�sentation braille de son op�rateur <EM>caract�res</EM>. Il peut
�tre aussi sp�cifi� comme un signe �gal (<CODE>=</CODE>), au quel cas il
signifie l'une des deux choses. Si l'entr�e est pour un seul caract�re,
cela signifie que la repr�sentation du braille informatique s�lectionn�e
(voir l'option
<A HREF="BRLTTY-4.html#options-text-table">-t</A> en ligne de
commande et la ligne
<A HREF="BRLTTY-4.html#configure-text-table">text-table</A>
du fichier de configuration) de ce caract�re doit �tre utilis�e. Si
c'est pour une s�quence multi-caract�res, la repr�sentation par d�faut
de chaque caract�re (voir
<A HREF="#contraction-opcode-always">always</A>) dans une s�quence doit �tre utilis�e.</P>
<P>Certains termes sp�ciaux sont utilis�s � l'int�rieur des descriptions de ces
opcodes.
<DL>
<DT><B>word</B><DD>
<P>Une s�quence maximale d'une ou plusieurs lettres � la suite.</P>
</DL>
</P>
<P>Enfin, voici maintenant la description des opcodes eux-m�mes:
<DL>
<DT><B><CODE>literal</CODE> <EM>caract�res</EM>
<A NAME="contraction-opcode-literal"></A> </B><DD>
<P>Traduit ce qui est li� � l'espace et qui contient une s�quence de
caract�res en braille informatique (voir l'option
<A HREF="BRLTTY-4.html#options-text-table">-t</A> en ligne de commande et la ligne
<A HREF="BRLTTY-4.html#configure-text-table">text-table</A> du fichier de
configuration).</P>
<DT><B><CODE>replace</CODE> <EM>caract�res</EM> <EM>caract�res</EM>
<A NAME="contraction-opcode-replace"></A> </B><DD>
<P>Remplace la premi�re valeur des caract�res, quel que soit l'endroit o� ils
apparaissent, par la seconde. Les caract�res remplac�s ne sont pas
r�ins�r�s.</P>
<DT><B><CODE>always</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-always"></A> </B><DD>
<P>Traduit les caract�res quel que soit l'endroit o� ils apparaissent.
S'il n'y a qu'un caract�re, alors, en plus, d�finit la repr�sentation par
d�faut de ce caract�re.</P>
<DT><B><CODE>repeatable</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-repeated"></A> </B><DD>
<P>Traduit les caract�res quel que soit l'endroit o� ils apparaissent. Ignore toute
r�p�tition imm�diate de la m�me s�quence.</P>
<DT><B><CODE>largesign</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-largesign"></A> </B><DD>
<P>Traduit les caract�res quel que soit l'endroit o� ils apparaissent. Supprime les
espaces entre les mots qui se suivent et qui sont g�r�s par cet opcode.</P>
<DT><B><CODE>word</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-word"></A> </B><DD>
<P>Traduit les caract�res s'ils forment un mot.</P>
<DT><B><CODE>joinword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-joinword"></A> </B><DD>
<P>Traduit les caract�res s'ils forment un mot. Supprime l'espace suivant si
le premier caract�re qui le suit est une lettre.</P>
<DT><B><CODE>lowword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-lowword"></A> </B><DD>
<P>Traduit les caract�res s'ils forment un mot li� � un espace. </P>
<DT><B><CODE>contraction</CODE> <EM>caract�res</EM>
<A NAME="contraction-opcode-contraction"></A> </B><DD>
<P>Fait pr�c�der les caract�res d'un signe-lettre (voir
<A HREF="#contraction-opcode-letsign">letsign</A>) s'ils forment un mot.</P>
<DT><B><CODE>sufword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-sufword"></A> </B><DD>
<P>Traduit les caract�res s'ils forment soit un mot, soit s'ils sont au
d�but d'un mot.</P>
<DT><B><CODE>prfword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-prfword"></A> </B><DD>
<P>Traduit les caract�res s'ils forment soit un mot, soit s'ils sont � la
fin d'un mot.</P>
<DT><B><CODE>begword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-begword"></A> </B><DD>
<P>Traduit les caract�res s'ils sont au d�but d'un mot.</P>
<DT><B><CODE>begmidword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-begmidword"></A> </B><DD>
<P>Traduit les caract�res s'ils sont au d�but ou au milieu d'un mot.</P>
<DT><B><CODE>midword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-midword"></A> </B><DD>
<P>Traduit les caract�res s'ils sont au milieu d'un mot.</P>
<DT><B><CODE>midendword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-midendword"></A> </B><DD>
<P>Traduit les caract�res s'ils sont au milieu ou � la fin d'un mot.</P>
<DT><B><CODE>endword</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-endword"></A> </B><DD>
<P>Traduit les caract�res s'ils sont � la fin d'un mot.</P>
<DT><B><CODE>prepunc</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-prepunc"></A> </B><DD>
<P>Traduit les caract�res s'ils font partie de la ponctuation au d�but d'un
mot.</P>
<DT><B><CODE>postpunc</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-postpunc"></A> </B><DD>
<P>Traduit les caract�res s'ils font partie de la ponctuation � la fin d'un
mot.</P>
<DT><B><CODE>begnum</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-begnum"></A> </B><DD>
<P>Traduit les caract�res s'ils sont au d�but d'un nombre.</P>
<DT><B><CODE>midnum</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-midnum"></A> </B><DD>
<P>Traduit les caract�res s'ils sont au milieu d'un nombre.</P>
<DT><B><CODE>endnum</CODE> <EM>caract�res</EM> <EM>points</EM>
<A NAME="contraction-opcode-endnum"></A> </B><DD>
<P>Traduit les caract�res s'ils sont � la fin d'un nombre.</P>
</DL>
</P>
<H3><A NAME="contraction-opcodes-classes"></A> Classes de caract�re</H3>
<P>Ces opcodes d�finissent et utilisent des classes de caract�res. Une classe de
caract�res associe un type de caract�re � un nom. Le nom se r�f�re alors �
n'importe quel caract�re � l'int�rieur de la classe. Un caract�re peut
appartenir � plus d'une classe.</P>
<P>Les classes de caract�re suivantes sont automatiquement pr�d�finies, bas�es sur
la locale s�lectionn�e.
<DL>
<DT><B>digit</B><DD>
<P>Caract�res num�riques.</P>
<DT><B>letter</B><DD>
<P>Les caract�res alphab�tiques majuscule ou minuscule.
Certaines locales ont des lettres suppl�mentaires qui ne sont ni en majuscule
ni en minuscule.</P>
<DT><B>lowercase</B><DD>
<P>Les caract�res alphab�tiques minuscules.</P>
<DT><B>punctuation</B><DD>
<P>Caract�res imprimables qui ne sont ni des espaces ni alphanum�riques.</P>
<DT><B>space</B><DD>
<P>Caract�res d'espacement.
Dans la locale par d�faut, il s'agit de: espace, tabulation horizontale, tabulation
verticale, retour chariot, nouvelle ligne, saut de page.</P>
<DT><B>uppercase</B><DD>
<P>Caract�res alphab�tiques en majuscules.</P>
</DL>
</P>
<P>Les opcodes qui d�finissent et utilisent des classes de caract�res sont:
<DL>
<DT><B><CODE>class</CODE> <EM>nom</EM> <EM>caract�res</EM>
<A NAME="contraction-opcode-class"></A> </B><DD>
<P>D�finit une nouvelle classe de caract�re. L'op�rateur <EM>caract�res</EM>
doit �tre sp�cifi� comme une <EM>cha�ne</EM>. Une classe de caract�re ne peut
pas �tre utilis�e tant qu'elle n'est pas d�finie.</P>
<DT><B><CODE>after</CODE> <EM>class</EM> <EM>opcode</EM> ...
<A NAME="contraction-opcode-after"></A> </B><DD>
<P>L'opcode sp�cifi� est assez contraint dans le sens o� la s�quence de
caract�res ad�quat doit �tre imm�diatement pr�c�d�e par un caract�re
appartenant � la classe sp�cifi�e.
Si vous utilisez plus d'une fois cet opcode sur la m�me ligne, l'union des
caract�res de toute la classe est utilis�e.</P>
<DT><B><CODE>before</CODE> <EM>class</EM> <EM>opcode</EM> ...
<A NAME="contraction-opcode-before"></A> </B><DD>
<P>L'opcode sp�cifi� est assez contraint dans le sens o� la s�quence de
caract�res ad�quat doit �tre imm�diatement suivie par un caract�re
appartenant � la classe sp�cifi�e.
Si vous utilisez plus d'une fois cet opcode sur la m�me ligne, l'union des
caract�res de toute la classe est utilis�e.</P>
</DL>
</P>
<H2><A NAME="table-key"></A> <A NAME="ss6.4">6.4</A> <A HREF="BRLTTY.html#toc6.4">Tables de touches</A>
</H2>
<P>Les fichiers aux noms ayant la forme <CODE>*.ktb</CODE> sont des tables de touches, et ceux
aux noms ayant la forme <CODE>*.kti</CODE> sont des sous-tables de touches.
Ils sont utilis�s par BRLTTY pour associer des combinaisons de touches
de l'afficheur braille et du clavier � des commandes BRLTTY.</P>
<P>Les noms de fichier de table de touches de l'afficheur braille commencent par
<CODE>brl-</CODE><EM>xx</EM><CODE>-</CODE>", o� <EM>xx</EM> repr�sente le
<A HREF="BRLTTY-10.html#drivers">code d'identification de pilote</A> � deux lettres. Le reste
du nom identifie le(s) mod�le(s) pour le(s)quel(s) la table de touches est
utilis�e.</P>
<P>Les noms de fichier de table de touches du clavier commencent par <CODE>kbd-</CODE>.
Le reste du nom d�crit le type de clavier pour lequel a �t� con�ue la table
de touches.</P>
<P>Les tables de touches suivantes sont fournies:
<DL>
<DT><B>braille</B><DD>
<P>associations pour les claviers braille</P>
<DT><B>desktop</B><DD>
<P>associations pour les claviers complets</P>
<DT><B>keypad</B><DD>
<P>associations pour la navigation � partir du pav� num�rique</P>
<DT><B>laptop</B><DD>
<P>associations pour les claviers sans pav� num�rique</P>
<DT><B>sun_type6</B><DD>
<P>associations pour les claviers Sun Type 6</P>
</DL>
Voir l'option
<A HREF="BRLTTY-4.html#options-key-table">-k</A> en ligne de commande
et la ligne
<A HREF="BRLTTY-4.html#configure-key-table">key-table</A> du fichier de
configuration pour plus de d�tails concernant la mani�re de s�lectionner
une table de touches de clavier.</P>
<H3>Format des tables de touches</H3>
<P>Une table de touches consiste en une s�quence d'instructions, une par ligne,
qui d�finit comment les touches et les combinaisons de touches seront interpr�t�es.
Vous devez utiliser l'encodage <CODE>UTF-8</CODE>.
Un blanc (espaces, tabs) tant au d�but de la ligne qu'aavant et/ou apr�s n'importe quel op�rateur,
est ignor�.</P>
<P>Les lignes ne contenant que des blancs sont ignor�es.
Si le premier caract�re non blanc d'une ligne est un nombre ("#"), cette ligne est
un commentaire et est ignor�e.</P>
<P>L'ordre de r�solution de chaque appui de touche/�v�nement qui se produit
est le suivant:
<OL>
<LI>Un appui sur une touche de raccourci ou une action d�finie dans le contexte actuel.
Voir la ligne
<A HREF="#key-table-hotkey">hotkey</A>
pour des d�tails.</LI>
<LI>Une combinaison de touches d�finie dans le contexte actuel.
Voir la ligne
<A HREF="#key-table-bind">bind</A>
pour des d�tails.</LI>
<LI>Une commande du clavier braille d�finie dans le contexte actuel.
Voir les lignes
<A HREF="#key-table-map">map</A>
et
<A HREF="#key-table-superimpose">superimpose</A>d
pour des d�tails.</LI>
<LI>Une combinaison de touches d�finie dans le contexte par d�faut.
Voir la ligne
<A HREF="#key-table-bind">bind</A>
pour des d�tails.</LI>
</OL>
</P>
<P>Les lignes suivantes sont fournies:</P>
<H3><A NAME="key-table-assign"></A> La ligne Assign</H3>
<P>Cr�e ou met � jour une variable associ�e au niveau include actuel.
La variable est visible aux niveaux include actuel et inf�rieur, mais pas aux
niveaux include sup�rieurs.</P>
<P><CODE>assign</CODE> <EM>variable</EM> [<EM>valeur</EM>]
<DL>
<DT><B><EM>variable</EM></B><DD>
<P>Le nom de la variable.
Si la variable n'existe pas d�j� au niveau include actuel, elle sera cr��e.</P>
<DT><B><EM>valeur</EM></B><DD>
<P>La valeur qui sera associ�e � la variable.
Si on ne la fournit pas, une valeur z�ro (null) est affect�e.</P>
</DL>
</P>
<P>La s�quence d'�chappement \{variable} est remplac�e par la valeur de la
variable nomm�e dans les accolades. La variable doit �tre d�finie au niveau
include actuel ou sup�rieur.</P>
<P>Exemples:
<UL>
<LI><CODE>assign nullValue</CODE></LI>
<LI><CODE>assign ReturnKey Key1</CODE></LI>
<LI><CODE>bind \{ReturnKey} RETURN</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-bind"></A> La ligne Bind</H3>
<P>D�finit la commande qui est BRLTTY est ex�cut�e quand on appuie sur une ou plusieurs
combinaisons de touches particuli�res.
L'association est d�finie dans le contexte actuel.</P>
<P><CODE>bind</CODE> <EM>touches</EM> <EM>commande</EM>
<DL>
<DT><B><EM>touches</EM></B><DD>
<P>La combinaison de touches � associer.
C'est une s�quence d'un ou plusieurs noms de touches s�par�s par
des signes plus (<CODE>+</CODE>). Le nom de touche � la fin (ou seulement)
peut �tre �ventuellement pr�c�d� d'un point d'exclamation
(<CODE>!</CODE>). Vous pouvez appuyer sur les touches dans
n'importe quel ordre sauf si le nom de la touche � la fin est
pr�c�d� d'un point d'exclamation, alors on doit appuyer dessus
en dernier.
Le pr�fixe du point d'exclamation signifie que la commande est
ex�cut�e d�s qu'on appuie sur cette touche. S'il n'est pas
utilis�, la commande est ex�cut�e d�s qu'on effectue
une des touches.</P>
<DT><B><EM>commande</EM></B><DD>
<P>Le nom d'une commande BRLTTY. Un ou plusieurs modificateurs
peuvent �ventuellement �tre associ� au nom de la commande en
utilisant un signe plus (<CODE>+</CODE>) comme s�parateur.
<UL>
<LI>Pour les commandes qui activent/d�sactivent une fonctionnalit�:
<UL>
<LI>Si vous sp�cifiez le modificateur <CODE>+on</CODE>, la fonctionnalit� est
alors activ�e.</LI>
<LI>Si vous sp�cifiez le modificateur <CODE>+off</CODE>, la fonctionnalit� est
alors d�sactiv�e.</LI>
<LI>Si vous ne sp�cifiez ni <CODE>+on</CODE> ni <CODE>+off</CODE>, l'�tat de la fonctionnalit�
est activable/d�sactivable en bascule.</LI>
</UL>
</LI>
<LI>Pour les commandes qui d�placent la plage braille:
<UL>
<LI>+ </LI>
<LI>Si vous sp�cifiez le modificateur <CODE>+route</CODE>, si n�cessaire,
le curseur est automatiquement rout� afin d'�tre toujours visible
sur l'afficheur braille.</LI>
</UL>
</LI>
<LI>Pour les commandes qui d�placent la plage braille vers une ligne
sp�cifique de l'�cran:
<UL>
<LI>Si vous sp�cifiez le modificateur <CODE>+toleft</CODE>,
la plage braille est alors �galement d�plac�e au d�but de cette
ligne.</LI>
<LI>Si vous sp�cifiez le modificateur <CODE>+scaled</CODE>, l'ensemble de
touches associ� � la commande est interpr�t� comme si c'�tait une
barre de d�filement. Si vous ne le sp�cifiez pas, il y a une
correspondance une � une entre les touches et les lignes.</LI>
</UL>
</LI>
<LI>Pour les commandes qui demandent un compl�ment (offset):
<UL>
<LI>Vous pouvez sp�cifier le modificateur +<EM>offset</EM>, o�
<EM>offset</EM> est un entier non n�gatif.
Si vous ne le fournissez pas, <CODE>+0</CODE> est suppos�.</LI>
</UL>
</LI>
</UL>
</P>
</DL>
</P>
<P>Exemples:
<UL>
<LI><CODE>bind Key1 CSRTRK</CODE></LI>
<LI><CODE>bind Key1+Key2 CSRTRK+off</CODE></LI>
<LI><CODE>bind Key1+Key3 CSRTRK+on</CODE></LI>
<LI><CODE>bind Key4 TOP</CODE></LI>
<LI><CODE>bind Key5 TOP+route</CODE></LI>
<LI><CODE>bind VerticalSensor GOTOLINE+toleft+scaled</CODE></LI>
<LI><CODE>bind Key6 CONTEXT+1</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-context"></A> La ligne Context</H3>
<P>D�finit des fa�ons alternatives d'interpr�ter certains �v�nements et/ou
combinaisons de touches. Un contexte contient des d�finitions cr��es avec les
lignes
<A HREF="#key-table-bind">bind</A>,
<A HREF="#key-table-hotkey">hotkey</A>,
<A HREF="#key-table-map">map</A>,
et
<A HREF="#key-table-superimpose">superimpose</A>.</P>
<P><CODE>context</CODE> <EM>identificateur</EM> [<EM>titre</EM>]
<DL>
<DT><B><EM>identificateur</EM></B><DD>
<P>� l'int�rieur du contexte sous-jacent dans lequel doivent �tre cr��es les d�finitions.
Cela peut �tre:</P>
<P>
<UL>
<LI>Un de ces noms sp�ciaux:
<DL>
<DT><B>default</B><DD>
<P>Le contexte par d�faut. Si une combinaison de touches n'a pas �t� d�finie
dans le contexte actuel, c'est alors sa d�finition dans le contexte
par d�faut qui sera utilis�e. Cela ne s'applique qu'aux d�finitions
cr��es par la ligne
<A HREF="#key-table-bind">bind</A>.</P>
<DT><B>menu</B><DD>
<P>Ce contexte est utilis� quand on est � l'int�rieur du menu des
pr�f�rences de BRLTTY.</P>
</DL>
</LI>
<LI>Un entier compris entre <CODE>0</CODE> et <CODE>252</CODE>.
Le contexte <CODE>0</CODE> est une fa�on alternative de se r�f�rer au contexte
par d�faut. Vous devriez �viter les num�ros de contexte sup�rieurs car
le num�ro le plus �lev� autoris� est susceptible de changer sans signalement,
si, par exemple, on ajoute davantage de contextes nomm�s.
</LI>
</UL>
</P>
<DT><B><EM>titre</EM></B><DD>
<P>Une description lisible par un humain du contexte.
Il peut contenir des espaces et vous devriez utiliser les conventions de
mise en majuscules standards.
Cet op�rande est facultatif. Si on le fournit lors de la s�lection d'un
contexte ayant d�j� un titre, les deux doivent correspondre.
Les contextes nomm�s ont d�j� des titres internes attribu�s.</P>
<P>Les contextes num�riques sont cr��s au d�part sans titres.</P>
</DL>
</P>
<P>Un contexte est cr�� la premi�re fois qu'il est s�lectionn�.</P>
<P>Il peut �tre ensuite s�lectionn� autant de fois que n�cessaire.</P>
<P>Toutes les d�finitions sous-jacentes jusqu'� la prochaine ligne
<A HREF="#key-table-context">context</A> ou � la fin du niveau include
actuel sont cr��es � l'int�rieur du contexte s�lectionn�.</P>
<P>Le contexte initial du premier niveau de la table de touches est <CODE>default</CODE>.
Le contexte initial d'une sous-table de touches incluse est le contexte qui
a �t� s�lectionn� lorsqu'il a �t� inclu.</P>
<P>Les changements de contexte dans les sous-tables de touches incluses n'affectent
pas le contexte de la table de touches qui inclut ou de la sous-table.</P>
<P>Si un contexte a un titre (tous les contextes nomm�s et les contextes num�riques
pour lesquels on a fourni l'op�rande <EM>title</EM>), il demeure en place.</P>
<P>Quand un �v�nement de touches entra�ne l'activation d'un contexte permanent,
ce contexte reste actuel jusqu'� ce qu'un �v�nement de touches subs�quent
entra�ne l'activation d'un contexte permanent diff�rent. </P>
<P>Si un contexte n'a pas de titre (les contextes num�riques pour lesquels on n'a
pas fourni l'op�rande <EM>title</EM>), il est temporaire.</P>
<P>Quand un �v�nement de touche provoque l'activation d'un contexte temporaire,
ce contexte n'est utilis� que pour interpr�ter le tout prochain �v�nement de
touche.</P>
<P>Exemples:
<UL>
<LI><CODE>context menu</CODE></LI>
<LI><CODE>context 1 Braille Input</CODE></LI>
<LI><CODE>context 2</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-hide"></A> La ligne Hide</H3>
<P>Sp�cifie si des d�finitions (voir les lignes
<A HREF="#key-table-bind">bind</A>,
<A HREF="#key-table-hotkey">hotkey</A>,
<A HREF="#key-table-map">map</A>,
et
<A HREF="#key-table-superimpose">superimpose</A>) et les remarques (voir
la ligne
<A HREF="#key-table-note">note</A>) sont incluses ou pas
dans le texte d'aide de la table de touches.</P>
<P><CODE>hide</CODE> <EM>state</EM>
<DL>
<DT><B><EM>state</EM></B><DD>
<P>Un de ces mots-cl�s:
<DL>
<DT><B>on</B><DD>
<P>Elles sont exclues.</P>
<DT><B>off</B><DD>
<P>Elles sont incluses.</P>
</DL>
</P>
</DL>
</P>
<P>L'�tat sp�cifi� s'applique � toutes les d�finitions et les notes qui en d�coulent
jusqu'� la prochaine ligne <CODE>hide</CODE> ou jusqu'� la fin du niveau include actuel.
L'�tat initial du premier niveau de la table de touches est <CODE>off</CODE>.
L'�tat initial d'une sous-table de touches incluse est l'�tat qui a �t�
s�lectionn� quand elle a �t� incluse. </P>
<P>Les changements d'�tat � l'int�rieur des sous-tables de touches incluses
n'affectent pas l'�tat de la table de touche ou de la sous-table qui inclut.</P>
<P>Exemples:
<UL>
<LI><CODE>hide on</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-hotkey"></A> La ligne Hotkey</H3>
<P>Associe l'appui ou la survenance d'un �v�nement d'une touche sp�cifique
� deux commandes BRLTTY distinctes.</P>
<P>Les associations sont d�finies dans le contexte actuel.</P>
<P><CODE>hotkey</CODE> <EM>touche</EM> <EM>appui</EM> <EM>effectuer</EM>
<DL>
<DT><B><EM>touche</EM></B><DD>
<P>Le nom de la touche qui sera associ�e.</P>
<DT><B><EM>appui</EM></B><DD>
<P>Le nom de la commande BRLTTY qui sera ex�cut�e � chaque fois qu'on appuiera
sur la touche. </P>
<DT><B><EM>Effectuer</EM></B><DD>
<P>Le nom de la commande BRLTTY qui sera ex�cut�e � chaque fois qu'on effectuera
la touche. </P>
</DL>
</P>
<P>On peut coller des modificateurs aux noms de commande.</P>
<P>Voir l'op�rande <EM>command</EM> de la ligne
<A HREF="#key-table-bind">bind</A> pour des
d�tails.</P>
<P>Sp�cifiez <CODE>NOOP</CODE> si aucune commande ne sera ex�cut�e.
Sp�cifier <CODE>NOOP</CODE> pour deux commandes d�sactive la touche dans les faits.</P>
<P>Exemples:
<UL>
<LI><CODE>hotkey Key1 CSRVIS+off CSRVIS+on</CODE></LI>
<LI><CODE>hotkey Key2 NOOP NOOP</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-ifkey"></A> La ligne IfKey</H3>
<P>Applique une ligne de la table de touches � la condition que
le p�riph�rique ait une touche particuli�re.</P>
<P><CODE>ifkey</CODE> <EM>touche</EM> <EM>ligne</EM>
<DL>
<DT><B><EM>touche</EM></B><DD>
<P>Le nom de la touche dont la disponibilit� doit �tre test�e.</P>
<DT><B><EM>ligne</EM></B><DD>
<P>La ligne de la table de touches qui doit �tre appliqu�e sous condition.</P>
</DL>
</P>
<P>Exemples:
<UL>
<LI><CODE>ifkey Key1 ifkey Key2 bind Key1+Key2 HOME</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-include"></A> La ligne Include</H3>
<P>Ex�cute les lignes � l'int�rieur d'une sous-table de touches.</P>
<P>Cela est r�cursif, ce qui signifie que n'importe quelle table de touches
peut s'inclure elle-m�me dans une autre sous-table.</P>
<P>Il faut faire attention � bien s'assurer qu'une "boucle d'inclusion" ne soit
pas cr��e.</P>
<P><CODE>include</CODE> <EM>fichier</EM>
<DL>
<DT><B><EM>file</EM></B><DD>
<P>La sous-table de touche qui doit �tre incluse.
Il peut s'agir d'un chemin soit relatif soit absolu.
S'il est relatif, il est ancr� au r�pertoire contenant la table de touches
qui inclut ou la sous-table.</P>
</DL>
</P>
<P>Exemples:
<UL>
<LI><CODE>include common.kti</CODE></LI>
<LI><CODE>include /chemin/vers/mes/touches.kti</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-map"></A> La ligne Map</H3>
<P>Fait correspondre une touche � une fonction de clavier braille.
La correspondance est d�finie � l'int�rieur du contexte actuel.</P>
<P><CODE>map</CODE> <EM>touche</EM> <EM>fonction</EM>
<DL>
<DT><B><EM>touche</EM></B><DD>
<P>Le nom de la touche qui doit �tre associ�e. Vous pouvez associer plus d'une
touche � la m�me fonction de clavier braille.</P>
<DT><B><EM>fonction</EM></B><DD>
<P>Le nom de la fonction de clavier braille. Cela peut �tre un des
mots-cl�s suivants:
<DL>
<DT><B>DOT1</B><DD>
<P>Le point braille standard en haut � gauche.</P>
<DT><B>DOT2</B><DD>
<P>Le point braille standard au milieu � gauche</P>
<DT><B>DOT3</B><DD>
<P>Le point braille standard en bas � gauche.</P>
<DT><B>DOT4</B><DD>
<P>Le point braille standard en haut � droite.</P>
<DT><B>DOT5</B><DD>
<P>Le point braille standard au milieu � droite.</P>
<DT><B>DOT6</B><DD>
<P>Le point braille standard en bas � droite.</P>
<DT><B>DOT7</B><DD>
<P>Le point braille informatique en bas � gauche.</P>
<DT><B>DOT8</B><DD>
<P>Le point braille informatique en bas � droite.</P>
<DT><B>SPACE</B><DD>
<P>La barre d'espace.</P>
<DT><B>SHIFT</B><DD>
<P>La touche shift.</P>
<DT><B>UPPERCASE</B><DD>
<P>Si on doit entrer une lettre minuscule, la traduit alors dans son
�quivalent en majuscule.</P>
<DT><B>CONTROL</B><DD>
<P>La touche contr�le.</P>
<DT><B>META</B><DD>
<P>La touche alt gauche.</P>
</DL>
</P>
</DL>
</P>
<P>Si une combinaison de touches ne consiste qu'en des touches qui ont �t�
associ�es � des fonctions du clavier braille, et si ces fonctions, lorsqu'elles
sont combin�es, constituent une commande de clavier braille valide, la commande
est alors ex�cut�e d�s que les touches sont utilis�es.
Une commande de clavier braille valide doit inclure soit n'importe quelle
combinaison de points, soit la barre d'espace (mais pas les deux).
Si on inclut au moins un point braille, les fonctions du clavier braille
sp�cifi�e par les lignes
<A HREF="#key-table-superimpose">superimpose</A>
dans le m�me contexte sont aussi incluses implicitement.</P>
<P>Exemples:
<UL>
<LI><CODE>map Key1 DOT1</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-note"></A> La ligne Note</H3>
<P>Ajoute une explication lisible par un humain au texte d'aide de la table de
touches. </P>
<P>Les remarques sont utilis�es en g�n�ral, par exemple, pour d�crire la place,
les tailles et les formes des touches d'un p�riph�rique.</P>
<P><CODE>note</CODE> <EM>texte</EM>
<DL>
<DT><B><EM>texte</EM></B><DD>
<P>L'explication qui doit �tre ajout�e.
Elle peut contenir des espaces et devrait �tre grammaticalement correcte.</P>
</DL>
</P>
<P>Chaque remarque comporte exactement une ligne de texte d'explication.
Le grand espace est ignor� donc on ne peut sp�cifier l'indentation.</P>
<P>Il n'y a pas de limite au nombre de remarques que vous pouvez sp�cifier.
Toutes sont regroup�es et pr�sent�es dans un seul bloc au d�but du texte d'aide
de la table de touches.</P>
<P>Exemples:
<UL>
<LI><CODE>note Key1 est la touche ronde tout � gauche de la partie frontale.</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-superimpose"></A> La ligne Superimpose</H3>
<P>Inclut implicitement une fonction de clavier braille � chaque fois qu'une
commande de clavier braille d'au moins un point esst ex�cut�e.</P>
<P>L'inclusion implicite est d�finie dans le contexte actuel.</P>
<P>Vous pouvez sp�cifier n'importe quel num�ro parmi elles.</P>
<P><CODE>superimpose</CODE> <EM>fonction</EM>
<DL>
<DT><B><EM>fonction</EM></B><DD>
<P>Le nom de la fonction de clavier braille. Voir l'op�rande <EM>function</EM>
de la ligne
<A HREF="#key-table-map">map</A> pour des d�tails.</P>
</DL>
</P>
<P>Exemples:
<UL>
<LI><CODE>superimpose DOT7</CODE></LI>
</UL>
</P>
<H3><A NAME="key-table-title"></A> La ligne Title</H3>
<P>Fournit un r�sum� lisible par un humain de l'objectif de la table de touches.</P>
<P><CODE>title</CODE> <EM>texte</EM>
<DL>
<DT><B><EM>texte</EM></B><DD>
<P>Un r�sum� d'une ligne de la raison pour laquelle est utilis�e la table de
touches. Il peut contenir des espaces et vous devriez utiliser les
conventions de mise en majuscules standards.</P>
</DL>
</P>
<P>Le titre d'une table de touches ne peut �tre sp�cifi� qu'une fois.</P>
<P>Exemples:
<UL>
<LI><CODE>title Bindings for Keypad-based Navigation</CODE></LI>
</UL>
</P>
<H3><A NAME="keyboard-properties"></A> Propri�t�s du clavier</H3>
<P>Par d�faut, tous les claviers sont pris en charge.
Un sous-param�tre des claviers peut �tre s�lectionn� en sp�cifiant une ou plusieurs des
propri�t�s suivantes (voir l'option
<A HREF="BRLTTY-4.html#options-keyboard-properties">-K</A>
en ligne de commande et la ligne
<A HREF="BRLTTY-4.html#configure-keyboard-properties">keyboard-properties</A> du fichier de configuration):
<DL>
<DT><B>type</B><DD>
<P>Le type de bus, sp�cifi� en tant que mots-cl�s parmi ceux suivants:
<CODE>any</CODE>,
<CODE>ps2</CODE>,
<CODE>usb</CODE>,
<CODE>bluetooth</CODE>.</P>
<DT><B>vendor</B><DD>
<P>L'identificateur du vendeur, sp�cifi� comme une entier non-sign� 16-bit.</P>
<DT><B>product</B><DD>
<P>L'identificateur du produit, sp�cifi� comme une entier non sign� 16 bits.</P>
</DL>
</P>
<P>Les identificateurs du vendeur et du produit peuvent �tre sp�cifi�s en d�cimal
(pas de pr�fixe), octal (pr�fix� par <CODE>0</CODE>), ou hexac�cimal (pr�fix� par <CODE>0x</CODE>).
La sp�cification de <CODE>0</CODE> signifie que cela correspond � toute valeur (comme si
la propri�t� n'�tait pas sp�cifi�e).</P>
<HR>
<A HREF="BRLTTY-7.html">Page suivante</A>
<A HREF="BRLTTY-5.html">Page pr�c�dente</A>
<A HREF="BRLTTY.html#toc6">Table des mati�res</A>
</BODY>
</HTML>
Mini Shell