6. Tables

6.1 Tables de texte

Les fichiers ayant un nom sous la forme *.ttb sont des tables de texte, et ceux avec des noms de la forme *.tti 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.

Au départ, BRLTTY est configuré pour utiliser la table de texte North American Braille Computer Code (NABCC) (code informatique braille nord-américain). En plus de celle-ci par défaut, les alternatives suivantes sont fournies:

Voir l'option -t en ligne de commande, la ligne text-table du fichier de configuration, et l'option de compilation --with-text-table pour des détails concernant la façon d'utiliser et de changer de table de texte.

Format des tables de texte

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 UTF-8. 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é.

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.

Instructions des tables de texte

Les instructions suivantes sont fournies:

char caractère points # commentaire

Utilise l'instruction char 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 char - vous devriez définir l'autre avec la ligne glyph (dont la syntaxe est identique). Si plus d'un caractère ayant la même représentation braille est défini avec l'instruction char (ce qui est actuellement possible pour des questions de rétrocompatibilité), c'est la première qui est sélectionnée.

caractère

Le caractère Unicode qui sera défini. Cela peut être:

• Tout caractère différent d'un antislash ou d'un caractère blanc.
• Un caractère spécial précédé d'un anti-slash. Ce sont:

  -

  \b

  Le caractère Effacement -

  \f

  Le caractère formfeed -

  \n

  Le caractère Nouvelle ligne. -

  \o###

  La représentation octale à 3 chiffres d'un caractère. -

  \r

  Le caractère retour chariot -

  \s

  Le caractère Espace -

  \t

  Le caractère Tab horizontal -

  \u####

  La représentation hexadécimale à quatre chiffres d'un caractère. -

  \U########

  La représentation hexadécimale à huit chiffres d'un caractère. -

  \v

  Le caractère tab vertical -

  \x##

  La représentation hexadécimale à deux chiffres d'un caractère. -

  \X##

  ... (la casse du X et des chiffres n'a pas de signification) -

  \#

  Signe d'un nombre littéral. -

  \<name>

  Le nom Unicode d'un caractère (utilisez _ pour l'espace). -

  \\

  Un antislash littéral.

dots

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 1-8 tels que définis par la Standard Braille Dot Numbering Convention (convention standard de numérotation de points brailles). Le numéro de point spécial 0 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.

Exemples:

• char a 1
• char b (12)
• char c ( 4 1 )
• char \\ 12567
• char \s 0
• char \x20 ()
• char \<LATIN_SMALL_LETTER_D> 145

glyph caractère dots # comment

Utilisez l'instruction glyph 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 char pour les détails sur la syntaxe et pour des exemples.

byte byte points # commentaire

Utilisez l'instruction byte 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é.

Les caractères Unicode devraient être définis (via l'instruction char) de telle sorte que la table de texte demeure valide par rapport à l'encodage local.

byte

Le caractère local défini. Il peut être spécifié de la même manière que l'opérateur caractère de l'instruction char sauf que les formes spécifiques à l'Unicode (\u, \U, \<) ne peuvent pas être utilisées.

points

La représentation braille du caractère local. Il peut être spécifié de la même manière que l'opérateur points de l'instruction char.

include fichier # commentaire

Utilisez l'instruction include 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".

fichier

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.

6.2 Tables d'attributs

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 DISPMD). Chacun des huit points braille représente l'un des huit bits d'attributs VGA. Les tables d'attributs suivantes sont fournies:

left_right

La colonne à gauche représente les couleurs de premier plan:

Point 1

Bleu

Point 2

Vert

Point 3

Rouge

Point 7

Brillant

La colonne à droite représente les couleurs de fond:

Point 4

Bleu

Point 5

Vert

Point 6

Rouge

Point 8

Clignotant

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).

invleft_right

La colonne à gauche représente les couleurs de premier plan:

Point 1

Bleu

Point 2

Vert

Point 3

Rouge

Point 7

Brillant

La colonne à droite représente les couleurs de fond:

Point 4

Bleu

Point 5

Vert

Point 6

Rouge

Point 8

Clignotant

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.

upper_lower

Le carré supérieur représente les couleurs de premier plan:

Point 1

Rouge

Point 4

Vert

Point 2

Bleu

Point 5

Brillant

Le carré inférieur représente les couleurs d'arrière-plan:

Point 3

Rouge

Point 6

Vert

Point 7

Bleu

Point 8

Clignotant

Un point s'affiche quand le bit de l'attribut qui y correspond est actif.

Format des tables d'attributs

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 VGA. Vous devez utiliser un encodage de caractères UTF-8. 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.

Lignes de commande des tables d'attributs

Les lignes de commande suivantes sont fournies:

dot point etat # commentaire

Utilisez l'instruction dot pour spécifier ce que représente un point particulier.

point

Le point qui est défini. C'est une seule case allant de 1 à 8 comme défini par la Convention standard du nombre de points brailles.

état

Ce que représente le point. Il peut s'agir:

on

D'un point élevé si l'attribut nommé est actif.

off

D'un point enfoncé si l'attribut nommé est inactif.

Les noms des bits des attributs sont:

0X01

bleu premier plan

0X02

vert premier plan/

0X04

rouge premier plan/

0X08

brillant premier plan/

0X10

fond bleu

0X20

fond vert

0X40

fond rouge

0X80

fond clignotant

Exemples:

• dot 1 =fg-red
• dot 2 ~bg-blue

include fichier # commentaire

Utilisez la ligne include 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".

fichier

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.

6.3 Tables de braille abrégé

Les fichiers aux noms sous la forme *.ctb sont des tables de braille abrégé et ceux aux noms sous la forme *.cti 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é.

BRLTTY présente du braille abrégé si:

• Une table de braille abrégé a été sélectionnée. Voir l'option -c en ligne de commande et la ligne contraction-table du fichier de configuration pour des détails.
• La fonction braille 6 points a été activée. Voir la commande SIXDOTS et la préférence Text Style pour des détails.

Les tables d'abrégé suivantes sont fournies:

Format des tables de braille abrégé

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 UTF-8.

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.

Le format d'une entrée de table de braille abrégé est:

directive opérateur ... [commentaire]

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.

Opérateurs des tables de braille abrégé

characters

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:

• Tout caractère différent d'un antislash (barre oblique inversée) ou d'un caractère blanc.
• Un caractère spécial précédé d'une barre oblique inversée. Ce sont:

  -

  \b

  Le caractère Effacement -

  \f

  Le caractère formfeed -

  \n

  Le caractère Nouvelle ligne. -

  \o###

  La représentation octale à 3 chiffres d'un caractère. -

  \r

  Le caractère retour chariot -

  \s

  Le caractère Espace -

  \t

  Le caractère Tab horizontale -

  \u####

  La représentation hexadécimale à quatre chiffres d'un caractère. -

  \U########

  La représentation hexadécimale à huit chiffres d'un caractère. -

  \v

  Le caractère tab verticale -

  \x##

  La représentation hexadécimale à deux chiffres d'un caractère. -

  \X##

  ... (la casse du X et des chiffres n'a pas de signification) -

  \#

  Signe d'un nombre littéral. -

  \<name>

  Le nom Unicode d'un caractère (utilisez _ pour l'espace). -

  \\

  Un antislash littéral.

representation

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 1-8 tels que définis par la Standard Braille Dot Numbering Convention (convention standard de numérotation de points brailles). Le numéro de point spécial 0 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.

Opcodes

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.

Administration de la table

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.

include chemin

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.

locale locale

Définit la locale pour l'interprétation d'un caractère (minuscule, majuscule, numérique, etc). La locale peut être définie comme:

langue[_pays][.charset][@modifier]

La composante langue est requise et devrait être un code de langue à deux lettres ISO-639. La composante pays est facultative et devrait être un code de pays à deux lettres ISO-3166. La composante charset est optionnelle et devrait être le nom d'une table de caractères, comme ISO-8859-1.

C

7-bit ASCII.

-

Aucune locale.

La dernière spécification de locale s'applique à toute la table. Si vous n'utilisez pas cet opcode, la locale C est utilisée.

Définition d'un symbole spécial

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.

capsign points

Le symbole qui met en majuscule une seule lettre.

begcaps points

Le symbole qui commence un bloc de lettres en majuscule à l'intérieur d'un mot.

endcaps points

Le symbole qui termine un bloc de lettres en majuscules à l'intérieur d'un mot.

letsign points

Le symbole qui désigne une lettre ne faisant pas partie du mot.

numsign points

Le symbole marquant le début d'un nombre.

lastlargesign points

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".

Traduction de caractère

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.

Chacun de ces opcodes a un opérateurs caractères (qui doit être spécifié comme une chaîne), 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).

Beaucoup de ces opcodes ont un opérateur points qui définit la représentation braille de son opérateur caractères. Il peut être aussi spécifié comme un signe égal (=), 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 -t en ligne de commande et la ligne text-table 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 always) dans une séquence doit être utilisée.

Certains termes spéciaux sont utilisés à l'intérieur des descriptions de ces opcodes.

word

Une séquence maximale d'une ou plusieurs lettres à la suite.

Enfin, voici maintenant la description des opcodes eux-mêmes:

literal caractères

Traduit ce qui est lié à l'espace et qui contient une séquence de caractères en braille informatique (voir l'option -t en ligne de commande et la ligne text-table du fichier de configuration).

replace caractères caractères

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.

always caractères points

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.

repeatable caractères points

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.

largesign caractères points

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.

word caractères points

Traduit les caractères s'ils forment un mot.

joinword caractères points

Traduit les caractères s'ils forment un mot. Supprime l'espace suivant si le premier caractère qui le suit est une lettre.

lowword caractères points

Traduit les caractères s'ils forment un mot lié à un espace.

contraction caractères

Fait précéder les caractères d'un signe-lettre (voir letsign) s'ils forment un mot.

sufword caractères points

Traduit les caractères s'ils forment soit un mot, soit s'ils sont au début d'un mot.

prfword caractères points

Traduit les caractères s'ils forment soit un mot, soit s'ils sont à la fin d'un mot.

begword caractères points

Traduit les caractères s'ils sont au début d'un mot.

begmidword caractères points

Traduit les caractères s'ils sont au début ou au milieu d'un mot.

midword caractères points

Traduit les caractères s'ils sont au milieu d'un mot.

midendword caractères points

Traduit les caractères s'ils sont au milieu ou à la fin d'un mot.

endword caractères points

Traduit les caractères s'ils sont à la fin d'un mot.

prepunc caractères points

Traduit les caractères s'ils font partie de la ponctuation au début d'un mot.

postpunc caractères points

Traduit les caractères s'ils font partie de la ponctuation à la fin d'un mot.

begnum caractères points

Traduit les caractères s'ils sont au début d'un nombre.

midnum caractères points

Traduit les caractères s'ils sont au milieu d'un nombre.

endnum caractères points

Traduit les caractères s'ils sont à la fin d'un nombre.

Classes de caractère

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.

Les classes de caractère suivantes sont automatiquement prédéfinies, basées sur la locale sélectionnée.

digit

Caractères numériques.

letter

Les caractères alphabétiques majuscule ou minuscule. Certaines locales ont des lettres supplémentaires qui ne sont ni en majuscule ni en minuscule.

lowercase

Les caractères alphabétiques minuscules.

punctuation

Caractères imprimables qui ne sont ni des espaces ni alphanumériques.

space

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.

uppercase

Caractères alphabétiques en majuscules.

Les opcodes qui définissent et utilisent des classes de caractères sont:

class nom caractères

Définit une nouvelle classe de caractère. L'opérateur caractères doit être spécifié comme une chaîne. Une classe de caractère ne peut pas être utilisée tant qu'elle n'est pas définie.

after class opcode ...

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.

before class opcode ...

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.

6.4 Tables de touches

Les fichiers aux noms ayant la forme *.ktb sont des tables de touches, et ceux aux noms ayant la forme *.kti 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.

Les noms de fichier de table de touches de l'afficheur braille commencent par brl-xx-", où xx représente le code d'identification de pilote à deux lettres. Le reste du nom identifie le(s) modèle(s) pour le(s)quel(s) la table de touches est utilisée.

Les noms de fichier de table de touches du clavier commencent par kbd-. Le reste du nom décrit le type de clavier pour lequel a été conçue la table de touches.

Les tables de touches suivantes sont fournies:

braille

associations pour les claviers braille

desktop

associations pour les claviers complets

keypad

associations pour la navigation à partir du pavé numérique

laptop

associations pour les claviers sans pavé numérique

sun_type6

associations pour les claviers Sun Type 6

Format des tables de touches

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 UTF-8. Un blanc (espaces, tabs) tant au début de la ligne qu'aavant et/ou après n'importe quel opérateur, est ignoré.

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.

L'ordre de résolution de chaque appui de touche/événement qui se produit est le suivant:

1. Un appui sur une touche de raccourci ou une action définie dans le contexte actuel. Voir la ligne hotkey pour des détails.
2. Une combinaison de touches définie dans le contexte actuel. Voir la ligne bind pour des détails.
3. Une commande du clavier braille définie dans le contexte actuel. Voir les lignes map et superimposed pour des détails.
4. Une combinaison de touches définie dans le contexte par défaut. Voir la ligne bind pour des détails.

Les lignes suivantes sont fournies:

La ligne Assign

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.

assign variable [valeur]

variable

Le nom de la variable. Si la variable n'existe pas déjà au niveau include actuel, elle sera créée.

valeur

La valeur qui sera associée à la variable. Si on ne la fournit pas, une valeur zéro (null) est affectée.

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.

Exemples:

• assign nullValue
• assign ReturnKey Key1
• bind \{ReturnKey} RETURN

La ligne Bind

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.

bind touches commande

touches

La combinaison de touches à associer. C'est une séquence d'un ou plusieurs noms de touches séparés par des signes plus (+). Le nom de touche à la fin (ou seulement) peut être éventuellement précédé d'un point d'exclamation (!). 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.

commande

Le nom d'une commande BRLTTY. Un ou plusieurs modificateurs peuvent éventuellement être associé au nom de la commande en utilisant un signe plus (+) comme séparateur.

• Pour les commandes qui activent/désactivent une fonctionnalité:
  • Si vous spécifiez le modificateur +on, la fonctionnalité est alors activée.
  • Si vous spécifiez le modificateur +off, la fonctionnalité est alors désactivée.
  • Si vous ne spécifiez ni +on ni +off, l'état de la fonctionnalité est activable/désactivable en bascule.
• Pour les commandes qui déplacent la plage braille:
  • +
  • Si vous spécifiez le modificateur +route, si nécessaire, le curseur est automatiquement routé afin d'être toujours visible sur l'afficheur braille.
• Pour les commandes qui déplacent la plage braille vers une ligne spécifique de l'écran:
  • Si vous spécifiez le modificateur +toleft, la plage braille est alors également déplacée au début de cette ligne.
  • Si vous spécifiez le modificateur +scaled, 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.
• Pour les commandes qui demandent un complément (offset):
  • Vous pouvez spécifier le modificateur +offset, où offset est un entier non négatif. Si vous ne le fournissez pas, +0 est supposé.

Exemples:

• bind Key1 CSRTRK
• bind Key1+Key2 CSRTRK+off
• bind Key1+Key3 CSRTRK+on
• bind Key4 TOP
• bind Key5 TOP+route
• bind VerticalSensor GOTOLINE+toleft+scaled
• bind Key6 CONTEXT+1

La ligne Context

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 bind, hotkey, map, et superimpose.

context identificateur [titre]

identificateur

À l'intérieur du contexte sous-jacent dans lequel doivent être créées les définitions. Cela peut être:

• Un de ces noms spéciaux:

  default

  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 bind.

  menu

  Ce contexte est utilisé quand on est à l'intérieur du menu des préférences de BRLTTY.

• Un entier compris entre 0 et 252. Le contexte 0 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.

titre

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.

Les contextes numériques sont créés au départ sans titres.

Un contexte est créé la première fois qu'il est sélectionné.

Il peut être ensuite sélectionné autant de fois que nécessaire.

Toutes les définitions sous-jacentes jusqu'à la prochaine ligne context ou à la fin du niveau include actuel sont créées à l'intérieur du contexte sélectionné.

Le contexte initial du premier niveau de la table de touches est default. Le contexte initial d'une sous-table de touches incluse est le contexte qui a été sélectionné lorsqu'il a été inclu.

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.

Si un contexte a un titre (tous les contextes nommés et les contextes numériques pour lesquels on a fourni l'opérande title), il demeure en place.

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.

Si un contexte n'a pas de titre (les contextes numériques pour lesquels on n'a pas fourni l'opérande title), il est temporaire.

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.

Exemples:

• context menu
• context 1 Braille Input
• context 2

La ligne Hide

Spécifie si des définitions (voir les lignes bind, hotkey, map, et superimpose) et les remarques (voir la ligne note) sont incluses ou pas dans le texte d'aide de la table de touches.

hide state

state

Un de ces mots-clés:

on

Elles sont exclues.

off

Elles sont incluses.

L'état spécifié s'applique à toutes les définitions et les notes qui en découlent jusqu'à la prochaine ligne hide ou jusqu'à la fin du niveau include actuel. L'état initial du premier niveau de la table de touches est off. L'état initial d'une sous-table de touches incluse est l'état qui a été sélectionné quand elle a été incluse.

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.

Exemples:

• hide on

La ligne Hotkey

Associe l'appui ou la survenance d'un événement d'une touche spécifique à deux commandes BRLTTY distinctes.

Les associations sont définies dans le contexte actuel.

hotkey touche appui effectuer

touche

Le nom de la touche qui sera associée.

appui

Le nom de la commande BRLTTY qui sera exécutée à chaque fois qu'on appuiera sur la touche.

Effectuer

Le nom de la commande BRLTTY qui sera exécutée à chaque fois qu'on effectuera la touche.

On peut coller des modificateurs aux noms de commande.

Voir l'opérande command de la ligne bind pour des détails.

Spécifiez NOOP si aucune commande ne sera exécutée. Spécifier NOOP pour deux commandes désactive la touche dans les faits.

Exemples:

• hotkey Key1 CSRVIS+off CSRVIS+on
• hotkey Key2 NOOP NOOP

La ligne IfKey

Applique une ligne de la table de touches à la condition que le périphérique ait une touche particulière.

ifkey touche ligne

touche

Le nom de la touche dont la disponibilité doit être testée.

ligne

La ligne de la table de touches qui doit être appliquée sous condition.

Exemples:

• ifkey Key1 ifkey Key2 bind Key1+Key2 HOME

La ligne Include

Exécute les lignes à l'intérieur d'une sous-table de touches.

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.

Il faut faire attention à bien s'assurer qu'une "boucle d'inclusion" ne soit pas créée.

include fichier

file

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.

Exemples:

• include common.kti
• include /chemin/vers/mes/touches.kti

La ligne Map

Fait correspondre une touche à une fonction de clavier braille. La correspondance est définie à l'intérieur du contexte actuel.

map touche fonction

touche

Le nom de la touche qui doit être associée. Vous pouvez associer plus d'une touche à la même fonction de clavier braille.

fonction

Le nom de la fonction de clavier braille. Cela peut être un des mots-clés suivants:

DOT1

Le point braille standard en haut à gauche.

DOT2

Le point braille standard au milieu à gauche

DOT3

Le point braille standard en bas à gauche.

DOT4

Le point braille standard en haut à droite.

DOT5

Le point braille standard au milieu à droite.

DOT6

Le point braille standard en bas à droite.

DOT7

Le point braille informatique en bas à gauche.

DOT8

Le point braille informatique en bas à droite.

SPACE

La barre d'espace.

SHIFT

La touche shift.

UPPERCASE

Si on doit entrer une lettre minuscule, la traduit alors dans son équivalent en majuscule.

CONTROL

La touche contrôle.

META

La touche alt gauche.

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 superimpose dans le même contexte sont aussi incluses implicitement.

Exemples:

• map Key1 DOT1

La ligne Note

Ajoute une explication lisible par un humain au texte d'aide de la table de touches.

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.

note texte

texte

L'explication qui doit être ajoutée. Elle peut contenir des espaces et devrait être grammaticalement correcte.

Chaque remarque comporte exactement une ligne de texte d'explication. Le grand espace est ignoré donc on ne peut spécifier l'indentation.

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.

Exemples:

• note Key1 est la touche ronde tout à gauche de la partie frontale.

La ligne Superimpose

Inclut implicitement une fonction de clavier braille à chaque fois qu'une commande de clavier braille d'au moins un point esst exécutée.

L'inclusion implicite est définie dans le contexte actuel.

Vous pouvez spécifier n'importe quel numéro parmi elles.

superimpose fonction

fonction

Le nom de la fonction de clavier braille. Voir l'opérande function de la ligne map pour des détails.

Exemples:

• superimpose DOT7

La ligne Title

Fournit un résumé lisible par un humain de l'objectif de la table de touches.

title texte

texte

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.

Le titre d'une table de touches ne peut être spécifié qu'une fois.

Exemples:

• title Bindings for Keypad-based Navigation

Propriétés du clavier

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 -K en ligne de commande et la ligne keyboard-properties du fichier de configuration):

type

Le type de bus, spécifié en tant que mots-clés parmi ceux suivants: any, ps2, usb, bluetooth.

vendor

L'identificateur du vendeur, spécifié comme une entier non-signé 16-bit.

product

L'identificateur du produit, spécifié comme une entier non signé 16 bits.

Les identificateurs du vendeur et du produit peuvent être spécifiés en décimal (pas de préfixe), octal (préfixé par 0), ou hexacécimal (préfixé par 0x). La spécification de 0 signifie que cela correspond à toute valeur (comme si la propriété n'était pas spécifiée).