Les fichiers ayant un nom de 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 sur l'écran
dans les représentations braille qui correspond à leur ordinateur 8 points.
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:
autosélection à partir de la locale
Arabe (générique)
Assamese
Awaïen
Bulgare
Bihari
Bengali
Tibétin
Braj
pour voir des fichiers .brf
dans un éditeur ou un visualiseur
Tchèque
Gallois
Danois
Allemand
Dravidian
Grec
Anglais
Anglais (Canada)
Anglais (Royaume-Uni)
Anglais (États-Unis)
Anglais (Code informatique braille nord-américain)
Esperanto
Espagnol
Estonien
Finnois
Français
Français (Canada)
Français (France)
Français (unifié)
Français (Code Braille Informatique Français Standard)
Irlandais
Gaélique
Gondi
Gujarati
Hébreux
Hindou
Croate
Hongrois
Arménien
Islandais
Italien
Khasi
Kannada
Konkani
Kurukh
Lituanien
Letton
Malgache
Maori
Malayalam
Manipuri
Marathi
Maltais
Mundari
Marwari
Népalais
Newari
Néerlandais
Néerlandais (Belge)
Néerlandais (Pays-Bas)
Norvégien
Newari ancien
Oriya
Panjabi
Pali
Polonais
Portugais
Roumain
Russe
Sanskrit
Santali
Sindhi
Slovaque
Suédois
Swahili
Tamil
Telugu
Turc
Vietnamien
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.
Les instructions suivantes sont fournies:
char
caractère points # commentaireUtilise l'instruction char
pour spécifier la façon dont un caractère
Unicode sera représenté en braille.
Le caractère Unicode qui sera défini. Cela peut être:
-
Le caractère Effacement -
Le caractère formfeed -
Le caractère Nouvelle ligne. -
La représentation octale à 3 chiffres d'un caractère. -
Le caractère retour chariot -
Le caractère Espace -
Le caractère Tab horizontale -
La représentation hexadécimale à quatre chiffres d'un caractère. -
La représentation hexadécimale à huit chiffres d'un caractère. -
Le caractère tab vertical -
La représentation hexadécimale à deux chiffres d'un caractère. -
... (la casse du X et des chiffres n'a pas de signification) -
Signe d'un nombre littéral. -
Le nom Unicode d'un caractère (utilisez _ pour l'espace). -
Un antislash littéral.
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
de numérotation de points standard). 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
byte
byte points # commentaireUtilise 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.
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.
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 # commentaireUtilise 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".
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.
Les fichiers aux noms de la forme *.atb sont des tables d'attributs et ceux
aux noms de 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:
La colonne à gauche représente les couleurs de premier plan:
Rouge
Vert
Bleu
Brillant
Rouge
Vert
Bleu
Clignotant
La colonne à gauche représente les couleurs de premier plan:
Rouge
Vert
Bleu
Brillant
Rouge
Vert
Bleu
Clignotant
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.
Les lignes de commande suivantes sont fournies:
dot
point etat # commentaireUtilisez l'instruction dot
pour spécifier ce que représente un point
particulier.
Le point qui est défini. C'est une seule case allant de
1
à 8
comme défini par la
Convention du nombre de points braille standard.
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:
bleu premier plan
vert premier plan
/
rouge premier plan
/
brillant premier plan
/
fond bleu
fond vert
fond rouge
fond clignotant
Exemples:
dot 1 =fg-red
dot 2 ~bg-blue
include
fichier # commentaireUtilise 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".
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.
Les fichiers aux noms de la forme *.ctb
sont des tables d'abrégé et ceux
aux noms de la forme *.cti
sont des sous-tables d'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:
Les tables d'abrégé suivantes sont fournies:
Africains (abrégé)
Amharic (désabrégé)
Allemand (désabrégé)
Allemand (abrégé - standard 1998)
Allemand (abréviations de base)
Braille anglais unifié (degré 2)
Anglais américain (degré 2)
Espagnol (degré 2)
Français (abrégé)
Français (désabrégé)
Hausa (abrégé)
Indonésien (abrégé)
Japonais (désabrégé)
Coréen (degré 1)
Coréen (degré 2)
Coréen (désabrégé)
Malgache (abrégé)
Munda (abrégé)
Néerlandais (abrégé)
Chichewa (abrégé)
Alphabet phonétique international
Portugais (degré 2)
Sinhalese (désabrégé)
Swahili (abrégé)
Thai (abrégé)
Chinois thaiwanais (désabrégé)
Chinois thaiwanais (braille chinois unique)
Zulu (abrégé)
Une table d'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 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.
Le format d'une entrée de table de braille abrégé est:
directive opérateur ... [commentaire]
Chaque ligne a un nombre d'opérateurs spécifiques.
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 d'abrégé est, en général, selon la
convenance de son/ses mainteneur(s).
Une entrée qui définit une entité, comme class
,
doit précéder toutes les références de cette entité.
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.
Le premier opérateur d'une séquence de caractères correspondant à une ligne est la séquence de caractère à laquelle elle doit correspondre. Chaque caractère dans la séquence peut être:
-
Le caractère Effacement -
Le caractère formfeed -
Le caractère Nouvelle ligne. -
La représentation octale à 3 chiffres d'un caractère. -
Le caractère retour chariot -
Le caractère Espace -
Le caractère Tab horizontale -
La représentation hexadécimale à quatre chiffres d'un caractère. -
La représentation hexadécimale à huit chiffres d'un caractère. -
Le caractère tab vertical -
La représentation hexadécimale à deux chiffres d'un caractère. -
... (la casse du X et des chiffres n'a pas de signification) -
Signe d'un nombre littéral. -
Le nom Unicode d'un caractère (utilisez _ pour l'espace). -
Un antislash littéral.
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
de numérotation de points standard). 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.
+
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.
Ces opérateurs facilitent l'écriture des tables d'abrégé. Ils n'ont pas d'effet direct sur la traduction de caractère.
include
path
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 incluS.
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:
_
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 est devrait être le nom
d'une table de caractères, comme ISO-8859-1
.
7-bit ASCII.
Aucune locale.
C
est utilisée.
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.
Le symbole marquant le début d'un nombre.
lastlargesign
points
Traduit les caractères quelque 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".
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 d'abrégé. Ces entrées peuvent être définit 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.
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, quelque 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 quelque 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 quelque 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 quelque 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 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.
Ces opcodes définissent et utilisent des classes de caractère. Une classe de caractère 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.
Caractères numériques.
Les caractères alphabétiques majuscule ou minuscule. Certaines locales ont des lettres supplémentaires qui ne sont ni en majuscule ni en minuscule.
Les caractères alphabétiques minuscules.
Caractères imprimables qui ne sont ni des espaces ni alphanumériques.
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.
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.
Les fichiers aux noms de la forme *.ktb
sont des tables de touches, et ceux
aux noms de la forme *.kti
sont des sous-tables de touches.
Ils sont utilisés par BRLTTY pour associer des combinaisons de touches de clavier
à des commandes BRLTTY.
Les tables de touches suivantes sont fournies:
associations pour les claviers complets
associations pour la navigation à partir du pavé numérique
associations pour les claviers sans pavé numérique
Une table de touche 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.
Les lignes suivantes sont fournies:
bind
touches commande # commentaireUtilisez la ligne bind
pour associer une combinaison de touches
à une commande.
La combinaison de touches à associer.
C'est une séquence d'un ou plusieurs noms de touches (voir le
fichier ktb_keynames.h
dans le sous-répertoire Programs
de l'arborescence des sources de BRLTTY) séparés par des
signes plus (+
). Les touches initiales sont connues comme
des modificateurs et peuvent être pressées dans n'importe quel
ordre. La dernière touche doit être appuyée avec tous les modifieurs maintenus.
Le nom d'une commande BRLTTY (voir la section Commandes pour plus de détails). Pour les commandes listées dans la section Activation de fonctionnalités:
+on
est appliqué, la fonctionnalité
est activée.+off
est appliqué, la
fonctionnalité est désactivée.Pour les commandes listées dans la section Commandes de caractère: La commande agit sur le caractère où est le curseur.
Pour les commandes listées dans la section
Commandes de base:
Le modificateur +
n, où n est un entier non négatif, peut être
appliqué.
Si ce modificateur n'est pas spécifié, 0
est supposé.
Exemples:
bind CapsLock+Enter CsrTrk
bind CapsLock+O CsrTrk+off
bind CapsLock+P CsrTrk+on
bind KPInsert+1 GoToMark+1
include
file # commentUtilisez la ligne include
pour inclure le contenu d'une sous-table de
touche. Elle est récursive, ce qui signifie que toute sous-table de texte peut
inclure elle-même une autre sous-table de touche. Prenez soin de vous
assurer de ne pas créer une "inclusion en boucle".
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.
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):
Le type de bus, spécifié en tant qu'un des mots-clés suivants:
any
,
ps2
,
usb
,
bluetooth
.
L'identificateur du vendeur, spécifié comme une entier non-signé 16-bit.
L'identificateur du produit, spécifié comme une entier non-signé 16-bit.
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).