BRLTTY: Utilisation de BRLTTY

Page suivante Page précédente Table des matières

## 4. Utilisation de BRLTTY

Avant de démarrer BRLTTY, vous avez besoin d'installer votre afficheur braille. Dans la plupart des cas, cela se fait simplement en le connectant sur un port série disponible, puis en le mettant sous tension. Après avoir installé votre afficheur, exécutez simplement BRLTTY en tapant la commande BRLTTY sur une invite du shell (vous devez faire cela en tant que root). Intéressez-vous à l'option -d en ligne de commande, à la ligne braille-device du fichier de configuration, et à l'option de compilation --with-braille-device pour d'autres moyens de dire à BRLTTY à quel périphérique votre afficheur est connecté. Regardez l'option -b en ligne de commande, la ligne braille-driver du fichier de configuration, et l'option de compilation --with-braille-driver pour d'autres possibilités concernant la manière de dire à BRLTTY quel type d'afficheur braille vous avez. Observez l'option -B en ligne de commande, et la ligne de commande braille-parameters du fichier de configuration pour d'autres possibilités concernant la manière de passer les paramètres au pilote de votre afficheur braille. Un message donnant le nom du programme (BRLTTY) et son numéro de version apparaîtront brièvement (voir l'option -M en ligne de commande) sur l'afficheur braille. L'afficheur montrera alors une petite zone de l'écran contenant le curseur. Par défaut, le curseur est représenté par les points 7 et 8 superposés sur le caractère où il est.

Toute activité de l'écran sera affichée sur l'afficheur braille. L'afficheur suivra aussi la progression du curseur sur l'écran. Cette caractéristique est connue en tant que cursor tracking.

Toutefois, le fait de simplement taper sur le clavier et lire l'afficheur ne suffit pas. Essayez d'entrer une commande qui provoquera une erreur, et de taper `entrée`. L'erreur apparaît sur l'écran mais, sauf si vous avez un afficheur à plusieurs lignes, il y a des chances qu'elle ne soit pas visible sur l'afficheur braille. Vous n'y voyez qu'un invite du shell. Vous avez donc besoin, à présent, d'un moyen de déplacer la `fenêtre` braille à travers l'écran. Les touches de l'afficheur braille lui-même peuvent être utilisées pour envoyer les commandes à BRLTTY qui, entre autres choses, peut s'en occuper.

## 4.1 Commandes

Malheureusement, les différents afficheurs braille n'offre pas des touches de contrôle standard. Certains ont des touches standard six points, certains en ont huit, et d'autres n'en ont pas. Certains ont des touches au niveau des pouces, mais il n'y en a pas beaucoup en standard. Certains ont un bouton au-dessus de chaque cellule braille. Certains ont des boutons qu'il faut pousser. D'autres ont une barre facile d'accès fonctionnant beaucoup comme une manette de jeu. La plupart ont des combinaisons variées des éléments ci-dessus. A cause de la nature et de la disposition si différente entre chaque afficheur, reportez-vous à la documentation de votre afficheur personnel pour trouver ce que fait exactement chaque touche.

Les commandes de BRLTTY sont identifiées par leur nom dans ce manuel. Si vous oubliez la/les touche(s) de votre afficheur braille à utiliser pour une commande particulière, reportez-vous à la page d'aide de son pilote. Par conséquent, la touche que vous devriez mémoriser immédiatement est celle de la commande HELP. Utilisez les routines habituelles (comme décrit ci-dessous) pour naviguer dans la page d'aide, puis pressez de nouveau la touche d'aide pour quitter.

### Déplacement vertical

Voir aussi les commandes de routines PRINDENT/NXINDENT.

LNUP/LNDN

  Monte/descend d'une ligne. Si le saut des lignes identiques a été activée (voir la commande SKPIDLNS), ces commandes, au lieu de se déplacer exactement d'une ligne à l'autre, sont des alias pour les commandes PRDIFLN/NXDIFLN.

WINUP/WINDN

  Monte/descend d'un écran. Si l'écran n'est plus haut qu'une ligne, elle déplace alors de 5 lignes.

PRDIFLN/NXDIFLN

  Monte/descend à la ligne la plus proche ayant un contenu différent. Si le saut de lignes identique a été activé (voir les commandes SKPIDLNS), ces commandes, plutôt que de sauter des lignes identiques, sont des alias pour les commandes LNUP/LNDN commands.

ATTRUP/ATTRDN

  Monte/descend à la ligne la plus proche avec des attributs différents (mise en valeur de caractère).

TOP/BOT

  Va au début ou à la fin de la ligne.

TOP_LEFT/BOT_LEFT

  Va au coin en haut à gauche ou en bas à gauche.

PRPGRPH/NXPGRPH

  Va à la ligne la plus proche du paragraphe précédent/suivant (la première ligne non vide après la ligne vide la plus proche). La ligne courante est incluse dans la recherche de l'espace entre les paragraphes.

PRPROMPT/NXPROMPT

  Va à l'invite de commande suivant/précédent.

PRSEARCH/NXSEARCH

  Recherche avant/arrière de l'occurrence la plus proche de la chaîne de caractères du tampon coupé (voir Couper-coller) qui n'est pas dans la fenêtre braille. La recherche se fait à gauche/droite, et commence au caractère immédiatement à gauche/droite de la fenêtre, et en englobant le bord de l'écran. La recherche ne tient pas compte de la casse.

### Déplacement horizontal

Voir aussi la commande de la routine SETLEFT.

CHRLT/CHRRT

  Va à gauche/droite d'un caractère.

HWINLT/HWINRT

  Va à gauche/droite de la moitié de la fenêtre.

FWINLT/FWINRT

  Va à gauche/droite d'une fenêtre. Ces commandes sont particulièrement utile parce qu'elles débordent automatiquement quand elles atteignent le bord de l'écran. Les autres caractéristiques, comme celles de sauter les fenêtres vides (voir la commande SKPBLNKWINS), accroissent leur maniabilité.

FWINLTSKIP/FWINRTSKIP

  Va à gauche/droite à la fenêtre non-vide la plus proche.

LNBEG/LNEND

  Va au début/fin de la ligne.

### Déplacement implicite

Voir aussi la commande de routine GOTOMARK.

HOME

  Va à l'endroit où se trouve le curseur d'écran.

BACK

  Revient là où la commande de déplacement la plus récente a mis la fenêtre braille. C'est une façon facile de retourner à droite de là où vous lisiez, après un événement imprévu (comme une poursuite du curseur) qui déplace la fenêtre braille à un moment inapproprié.

RETURN

  - Si le déplacement le plus récent de la fenêtre braille était automatique, comme le résultat d'une poursuite du curseur, revient là où la commande de déplacement la plus récente l'a mise (voir la commande BACK).
  - Si le curseur n'est pas dans la fenêtre braille, va où se trouve le curseur (voir la commande HOME).

### Caractéristiques de l'activation

Chacune de ces commandes a trois modes: activate (déclenche la fonction), deactivate (annule la fonction), et toggle (si la fonction est inhibée, la déclenche, et vis versa). Sauf si cela est explicitement dit, chacune de ces fonctions est initiallement à `off`, et, quand elle est on, cela agit sur l'exécution de BRLTTY tout entier. Le paramètre initial de certaines des fonctionnalités peut être changée par le menu préférences.

FREEZE

  Gèle l'image de l'écran. BRLTTY fait une copie de l'écran (contenu et attributs) comme au moment où l'image de l'écran est raffraîchie, et ignore dès lors toute mise à jour de l'écran jusqu'à ce qu'il soit réactualisé. Par exemple, cette fonctionnalité facilite la lecture de la sortie d'une application qui écrit beaucoup trop rapidement.

DISPMD

  Montre les mises en relief (attributs) de chaque caractère dans la fenêtre braille, plutôt que les caractères eux-mêmes (le contenu). Par exemple, cette fonctionnalité est utile si vous devez mettre en valeur un item. Quand elle montre le contenu de l'écran, la table de traduction de texte est utilisée (voir l'option -t en ligne de commande, la ligne text-table du fichier de configuration et l'option de compilation --with-text-table). Quand elle montre les attributs de l'écran, la table de traduction des attributs est utilisée (voir l'option ``-a'' en ligne de commande, la ligne attributes-table du fichier de configuration, et l'option de compilation ``--with-attributes-table''). Cette fonctionnalité ne s'applique qu'au terminal virtuel courant.

SIXDOTS

  Montre les caractères brailles sous la forme 6-points et non 8-points. Les points 7 et 8 sont encore utilisés par d'autres fonctionnalités telles que la représentation du curseur et le soulignement des caractères mis en relief. 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), elle est utilisée. Vous pouvez aussi changer ce paramètre avec la préférence Text Style.

SLIDEWIN

  Si le suivit (tracking) du curseur (voir la commande CSRTRK) est on, chaque fois que le curseur se déplace de façon trop limitée (ou pas assez) au-delà de la fin de la fenêtre braille, elle repositionne horizontalement la fenêtre braille, de sorte que le curseur, tant qu'il reste de ce côté, soit plus proche du centre. Si cette caractéristique est off, la fenêtre braille est toujours positionné de façon à ce que sont côté gauche soit un multiple de de sa largeur depuis le bord gauche de l'écran.

  Vous pouvez aussi modifier ce paramètre avec la préférence Sliding Window.

SKPIDLNS

  Au lieu de déplacer exactement d'une ligne en haut ou en bas, saute les lignes déjà lues qui ont le même contenu que la ligne courante. Cette caractéristiques influence les commandes LNUP/LNDN, autant que la ligne englobant la caractéristique des commandes FWINLT/FWINRT et FWINLTSKIP/FWINRTSKIP. Vous pouvez aussi changer ce paramètre avec la préférence Skip Identical Lines.

SKPBLNKWINS

  Saute les lignes vides déjà passées lors d'une lecture en avant ou en arrière. Cette caractéristique influence les commandes FWINLT/FWINRT. Vous pouvez aussi changer ce paramètre avec la préférence Skip Blank Windows.

CSRVIS

  Montre le curseur en superposant un modèle de point (voir la commande CSRSIZE) au-dessus du caractère où il se trouve. A l'origine, cette caractéristique est on. Vous pouvez aussi changer ce paramètre avec la préférence Show Cursor.

CSRHIDE

  Rend le curseur invisible (voir la commande CSRVIS ) de façon à lire précisément le caractère sous lui. Cette caractéristique n'affecte que la console virtuelle courante.

CSRTRK

  Poursuite du curseur. Si le curseur se déplace à un endroit qui n'est pas à l'intérieur de la fenêtre braille, il déplace automatiquement la fenêtre braille vers la nouvelle position du curseur. Vous voudrez en principe que cette caractéristique soit active, puisque cela minimise les effets du défilement de l'écran, et puisque, lorsque vous entrez quelque chose, la région à l'intérieur de laquelle vous écrivez actuellement est toujours visible. Si cette option fait sauter la fenêtre braille à un moment inadéquat, utilisez la commande BACK pour revenir là où vous étiez en train de lire. Il se peut que vous deviez désactiver cette option lorsque vous utilisez une application qui raffraîchit en permanence l'écran tant qu'est maintenu une base d'organisation réparée. A l'origine, cette caractéristique est on.

CSRSIZE

  Représente le curseur avec les huit points (un bloc complet), au lieu de n'afficher que les points 7 et 8 (un soulignement). Vous pouvez aussi changer ce paramètre avec la préférence Cursor Style.

CSRBLINK

  Cache (active et la désactive en fonction d'un intervalle prédéfini) le symbole représentant le curseur (voir la commande CSRVIS). Vous pouvez changer ce paramètre avec la préférence Blinking Cursor.

ATTRVIS

  Souligne (avec la combinaison des points 7 et 8) les caractères à mettre en évidence.

  no underline

    Blanc sur noir (normal), Gris sur noir, Blanc sur bleu, Noir sur cyan.

  dots 7 and 8

    Noir sur blanc (vidéo inversée).

  dot 8

    Tout le reste.

  Vous pouvez aussi changer ce paramètre avec la préférence Show Attributes.
ATTRBLINK

  Masque (active ou désactive selon un intervalle prédéfini) l'attribut souligné (voir la commande ATTRVIS command). A l'origine, cette caractéristique est on. Vous pouvez aussi changer ce paramètre avec la préférence Blinking Attributes.

CAPBLINK

  Masque (active ou désactive selon un intervalle prédéfini) les lettres en majuscule. Vous pouvez aussi changer ce paramètre avec la préférence Blinking Capitals.

TUNES

  Joue un son court prédéfini (voir Alert Tunes) chaque fois qu'un événement significatif se produit. A l'origine, cette caractéristique est on. Vous pouvez aussi changer ce paramètre avec la préférence Alert Tunes.

AUTOREPEAT

  Répète automatiquement une commande à un intervalle régulier après un délai initial tant que sa touche (combinaison) reste appuyée. Seuls certains pilotes supportent cette fonctionnalité, la principale limite étant que la plupart des afficheurs braille ne signalent pas en même temps les touches pressées et les touches exécutées comme des événements distinctement séparés. A l'origine, cette caractéristique est off. Vous pouvez aussi changer ce paramètre avec la préférence Autorepeat.

AUTOSPEAK

  Dit automatiquement:

  - la nouvelle ligne quand la fenêtre braille est déplacée verticalement
  - les caractères que vous entrez ou que vous effacez.
  - le caractère vers lequel vous déplacez le curseur.
  A l'origine, cette caractéristique est off. Vous pouvez aussi changer ce paramètre avec la préférence Autospeak.

### Mode Sélection

HELP

  Se déplace à la page d'aide du pilote d'un afficheur braille. C'est là que vous pouvez trouver un résumé en ligne de choses telles que ce que font les touches de votre afficheur braille, et comment interpréter ses cellules d'état. Utilisez les commandes vertical et horizontal pour naviguer dans la page d'aide. Appelez la commande `help` de nouveau pour revenir à l'écran.

INFO

  Va à l'affichage des états (voir la section Affichage des Statuts pour des détails complets). Cela présente un résumé comprenant la position du curseur, la position de la fenêtre braille, et l'état d'un certain nombre de caractéristiques de BRLTTY. Appelez de nouveau cette commande pour revenir à l'écran.

LEARN

  Entre dans le mode d'apprentissage de commande (voir la section Mode Appresntissage Commande pour des détails complets). C'est ainsi que vous pouvez apprendre de façon interactive ce que font les touches de votre afficheur braille. Rappelez cette commande pour revenir à l'écran. Cette commande n'est pas disponible si l'option de compilation --disable-learn-mode a été spécifiée.

### Maintenance des préférences

PREFMENU

  Accès au menu des préférences (voir Le Preferences Menu pour des détails complets). Rappelez cette commande pour revenir à l'écran. Cette commande n'est pas disponible si l'option de compilation --disable-preferences-menu a été spécifiée.

PREFSAVE

  Enregistre les paramètres de préférence courants (voir Preferences pour des détails complets).

PREFLOAD

  Recharge les derniers paramètres de préférence sauvegardés (voir Preferences pour des détails complets).

### Navigation dans le menu

MENU_FIRST_ITEM/MENU_LAST_ITEM

  Va au premier/dernier élément du menu.

MENU_PREV_ITEMMENU_NEXT_ITEM/

  Va à l'élément précédent/suivant du menu.

MENU_PREV_SETTING/MENU_NEXT_SETTING

  Remonte/descend le paramètre des éléments du menu courant.

### Contrôles de la verbosité

SAY_LINE

  Dit la ligne courante. La préférence Say-Line Mode détermine si le message en attente est proposé en premier.

SAY_ABOVE

  Dit la portion en haut de l'écran (fin à la ligne courante).

SAY_BELOW

  Dit la portion en bas de l'écran (début à la ligne courante).

MUTE

  Arrête immédiatement la parole.

SPKHOME

  Va où se trouve le curseur parlant.

SAY_SLOWER/SAY_FASTER

  Diminue/accélère le débit de parole (voir aussi la péférence Débit de parole). Cette commande n'est disponible que si un pilote qui la supporte est utilisé.

SAY_SOFTER/SAY_LOUDER

  Diminue/augmente le volume de la parole (voir aussi la préférence Volume de la parole). Cette commande n'est disponible que si un pilote qui la supporte est utilisé.

### Aller à un terminal virtuel

Voir aussi la commande de touche de chemin SWITCHVT.

SWITCHVT_PREV/SWITCHVT_NEXT

  Va à la console précédente/suivante.

### Autres Commandes

CSRJMP_VERT

  Amène le curseur n'importe où sur la première ligne de la fenêtre braille (voir Déplacement du Curseur pour des détails complets). Le curseur se déplace grâce à la simulation de l'appui sur les touches de direction verticales. Cette commande ne fonctionne pas toujours car certaines applications, soit déplace le curseur sans vraiment avertir, soit utilisent les flèches de direction à d'autres fins que le déplacement du curseur. C'est toutefois un peu plus sûr que les autres commandes de déplacement du curseur car cette commande ne tente pas de simuler les flèches gauche et droite.

PASTE

  Insère les caractères du tampon coupé à la place courante du curseur. (voir Couper-coller pour des détails complets).

RESTARTBRL

  Arrête puis relance le pilote de l'afficheur braille.

RESTARTSPEECH

  Arrête puis relance le pilote de la synthèse vocale.

### Les routines

ROUTE

  Déplace le curseur au caractère associé à la routine (voir Déplacement du Curseur pour des détails complets). Le curseur se déplace grâce à la simulation de l'appui sur les touches de direction verticales. Cette commande ne fonctionne pas toujours car certaines applications, soit déplace le curseur sans vraiment avertir, soit utilisent les flèches de direction à d'autres fins que le déplacement du curseur.

CUTBEGIN

  Positionne le début du bloc coupé au caractère associé à la routine-curseur. (voir Copier-coller pour des détails complets). Cette commande vide le tampon coupé.

CUTAPPEND

  Positionne le début du bloc coupé au caractère associé à la routine (voir Copier-coller pour des détails complets). Cette commande ne vide pas le tampon coupé.

CUTRECT

  Fixe la fin du bloc coupé au caractère associé à la touche de direction, et place la région rectangulaire sur le tampon coupé (voir Cut and Paste pour des détails complets).

CUTLINE

  Fixe la fin du bloc coupé au caractère associé à la touche de direction, et place la partie linéaire sur le bloc coupé (voir Cut and Paste pour des détails complets).

SWITCHVT

  Va au terminal virtuel dont le numéro (démarrant à 1) correspond à celui de la routine. Voir aussi les commandes de déplacement dans les terminaux virtuels SWITCHVT_PREV/SWITCHVT_NEXT.

PRINDENT/NXINDENT

  Monte/descend à la ligne la plus proche qui n'est pas indentée plus que la colonne associée à la routine.

DESCCHAR

  Affiche momentanément (voir l'option -M en ligne de commande) un message décrivant le caractère associé à la routine. Cela montre les valeurs décimales et hexadécimales du caractère, les couleurs de fond et de premier plan, et, lorsqu'ils sont présents, les attributs spéciaux (`bright` et `blink`). Le message ressemble à cela:

  > `char 65 (0x41): white on black bright blink`

SETLEFT

  Replace horrizontalement la fenêtre braille de façon à ce que son côté gauche soit à la colonne associée à la touche de déplacement. Cette caractéristique rend très facile l'action de mettre la fenêtre précisément là où il faut et, donc, pour les afficheurs qui ont des touches routines, élimine presque la nécessité pour beaucoup de déplacement élémentaires de la fenêtre (comme les commandes CHRLT/CHRRT et HWINLT/HWINRT).

SETMARK

  Marque la position courante de la fenêtre braille dans une mémoire associée à la routine. Voir la commande GOTOMARK. Cette caractéristique n'affecte que le terminal virtuel courant.

GOTOMARK

  Déplace la fenêtre braille à la position précédemment marquée (voir la commande SETMARK) avec la même routine. Cette caractéristique n'affecte que le terminal virtuel courant.

## 4.2 The fichier de configuration

Des valeurs système par défaut pour certains paramètres peuvent être établis dans un fichier de configuration. Le nom par défaut de ce fichier est `/etc/brltty.conf`, même s'il peut être contourné par l'option en ligne de commande -f. Son existence n'est pas indispensable. Vous pouvez trouver un ficher type dans le sous-répertoire `DOCS`

Les lignes vides sont ignorées. Un commentaire commence par un signe nombre (`#`), et continue jusqu'à la fin de la ligne. Les lignes de commande suivantes sont reconnues:

`api-parameters` name`=`valeur`,`...

  Spécifie les paramètres pour l'API. Si vous spécifiez le même paramètre plus d'une fois, sa valeur située le plus à droite est utilisée. Pour une description des paramètres acceptés par l'interface, voyez le manuel de référence BrlAPI. Voir l'option de compilation --with-api-parameters pour les paramètres par défaut établis lors de la procédure de compilation. Cette ligne de commande peut être évitée avec l'option de ligne de commande -A.

`attributes-table` fichier

  Spécifie la table de traduction des attributs (voir la section Translation Tables pour des détails). Si vous fournissez un chemin relatif, il est déterminé par rapport à `/etc/brltty` (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails). L'extension `.tbl` est facultative. Voir l'option de compilation --with-attributes-table pour les paramètres par défaut établis pendant la procédure de compilation. Vous pouvez vous passer de cette ligne de commande avec l'option en ligne de commande -a.

`braille-device` device`,`...

  Spécifie le périphérique auquel l'afficheur braille est connecté (voir la section Spécification du périphérique braille). Voir l'option de compilation --with-braille-device pour les paramètres par défaut établis durant la procédure de compilation. Vous pouvez vous passer de cette ligne de commande avec l'option -d.

`braille-driver` driver`,`...|`auto`

  Spécifie le pilote de l'afficheur braille (voir la section Spécification du pilote). Voir l'option de compilation --with-braille-driver pour les paramètres par défaut établis lors de la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -b.

`braille-parameters` [pilote`:`]nom`=`valeur`,`...

  Spécifie les paramètres pour les pilotes de l'afficheur braille. Si vous spécifiez le même paramètre plus d'une fois, c'est sa valeur placée le plus à droite qui est utilisée. Si le nom d'un paramètre est qualifié par celui d'un pilote (voir la section Codes d'identification de pilote) ce paramètre ne s'applique qu'à ce pilote; sinon il s'applique à tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir l'option de compilation --with-braille-parameters pour les paramètres par défaut établis lors de la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -B.

`contraction-table` fichier

  Spécifie la table abrégé (voir la section Braille abrégé pour des détails). Si vous fournissez un chemin relatif, il est fdéterminé par rapport à `/etc/brltty` (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails. L'extension `.ctb` est facultative. La table d'abrégé est utilisée quand la caractéristique braille 6-points est activée (voir la commande SIXDOTS et la préférence Text Style). Par défaut, affiche le braille 6 points intégral. Vous pouvez éviter cette ligne avec l'option en ligne de commande -c. Elle n'est pas disponible si l'option de compilation --disable-contracted-braille a été spécifiée.

`midi-device` device

  Spécifie le périphérique à utiliser pour l'interface MIDI (voir la section Spécification du périphérique MIDI). Vous pouvez éviter cette ligne avec l'option en ligne de commande -m. Elle n'est pas disponible si vous avez spécifié l'option de compilation --disable-midi-support.

`pcm-device` device

  Spécifie le périphérique à utiliser pour l'audio (voir la section Spécification du périphérique PCM). Vous pouvez éviter cette ligne avec l'option en ligne de commande -p. Elle n'est pas disponible si vous avez spécifié l'option de compilation --disable-pcm-support.

`screen-parameters` name`=`value`.`...

  Spécifie les paramètres pour le pilote d'écran. Si le même paramètre est spéciié plus d'une fois, sa valeur la plus à droite est utilisée. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir l'option de compilation --with-screen-parameters pour les paramètres par défaut établis pendant la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -X.

`speech-driver` driver`.`...|`auto`

  Spécifie le pilote de synthèse vocales (voir la section Spécification du pilote de synthèse). Voir l'option de compilation --with-speech-driver pour les paramètres par défaut établis lors de la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -s. Elle n'est pas disponible si vous avez spécifié l'option de compilation --disable-speech-support.

`speech-fifo` file

  Spécifie le FIFO (un fichier spécial qui fonctionne comme un tuyau en mode "first in first out", premier entré premier sorti) qui doit être utilisé par les autres applications voulant accéder au pilote de la synthèse de BRLTTY. Vous pouvez éviter cette ligne avec l'option en ligne de commande -F. Elle n'est pas disponible si vous avez spécifié --disable-speech-support.

`speech-parameters` [driver`:`]name`=`value`.`...

  Spécifie les paramètres pour les pilotes de synthèse vocale. Si vous spécifiez plus d'une fois le paramètre, c'est sa valeur le plus à droite qui est utilisée. Si le nom d'un paramètre est qualifié par le nom d'un pilote (voir la section Codes d'identification de pilote) ce paramètre s'applique seulement à ce pilote; sinon il s'applique pour tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir l'option de compilation --with-speech-parameters pour les paramètres par défaut établis durant la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -S.

`text-table` file

  Spécifie la table de traduction de texte (voir la section Tables de traduction pour les détails). Si vous fournissez un chemin relatif, il est déterminé par rapport à `/etc/brltty` (voir les options de compilation --with-data-directory et --with-execute-root. pour plus de détails). L'extension `.tbl` est facultative. Pour un nom de fichier simple, le préfixe `text.` est facultatif. Voir l'option de compilation --with-text-table pour les paramètres par défaut établis lors de la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -t.

## 4.3 Options en ligne de commande

Un grand nombre de paramètres peuvent être spécifiés explicitement lorsque vous appelez BRLTTY. La commande `brltty` accepte les options suivantes:

`-a`file `--attributes-table=`fichier

  Spécifie la table de traduction des attributs (voir la section Tables de traduction pour les détails). Si vous fournissez un chemin relatif, il est déterminé par rapport à `/etc/brltty` (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails). L'extension `.tbl` est facultative. Voir la ligne attributes-table du fichier de configuration pour la sélection des paramètres par défaut lors de l'exécution. Vous pouvez changer ce paramètre avec la préférence Attributes Table.

`-b`driver`.`...|`auto` `--braille-driver=`driver`.`...|`auto`

  Spécifie le pilote de l'afficheur braille (voir la section Spécification du pilote). Voir la ligne braille-driver du fichier de configuration pour les paramètres par défaut à l'exécution.

`-c`fichier `--contraction-table=`fichier

  Spécifie la table d'abrégé (voir la section Braille abrégé pour les détails). Si vous fournissez un chemin relatif, il est rattaché à `/etc/brltty`. (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails). L'extension `.ctb` est facultative. La table d'abrégé est utilisée lorsque la caractéristiques braille 6 points est activée (voir la commande SIXDOTS et la préférence Text Style). Voir la ligne contraction-table du fichier de configuration pour les paramètres par défaut à l'exécution. Vous pouvez changer ce paramètre avec la préférence Contraction Table. Cette option n'est pas disponible si l'option de compilation --disable-contracted-braille a été spécifiée.

`-d`peripherique`.`... `--braille-device=`device`.`...

  Spécifie le périphérique auquel l'afficheur braille est connecté (voir la section Spécification du périphérique braille). Voir la ligne braille-device du fichier de configuration pour les paramètres par défaut à l'exécution.

`-e` `--standard-error`

  Ecrit les messages de diagnostic sur la console d'erreur standard (stderr). Par défaut, ils s'enregistrent dans `syslog`.

`-f`fichier `--configuration-file=`file

  Spécifie l'emplacement du fichier de configuration qui doit être utilisé pour l'établissement des paramètres par défaut à l'exécution.

`-h` `--help`

  Affiche un résumé des options de la ligne de commande acceptées par BRLTTY, puis quitte.

`-l`niveau `--log-level=`level

  Spécifie le niveau de sécurité pour l'émission des messages de diagnostique. Les niveaux suivants sont reconnus.

  0

    emergency (urgence)

  1

    alert (alerte)

  2

    critical (critique)

  3

    error (erreur)

  4

    warning (attention)

  5

    notice (note)

  6

    information

  7

    debug (mise au point)

  Vous pouvez fournir soit le numéro soit le nom, et vous pouvez abréger le nom. Si vous ne spécifiez pas cela, c'est `information` qui est utilisé (voir l'option -q pour plus de détails).
`-m`périphérique `--midi-device=`device

  Spécifie le pilote à utiliser pour l'interface MIDI. (voir la section Spécification du périphérique MIDI). Voir la ligne midi-device du fichier de configuration pour les paramètres par défaut à l'exécution. Cette option n'est pas disponible si vous avez spécifié l'option de compilation --disable-midi-support.

`-n` `--no-daemon`

  Indique à BRLTTY qu'il doit rester au premier plan. Si cette option n'est pas spéciiée, BRLTTY devient un processus en arrière-plan (démon) après s'être initialisé mais avant de démarrer tous les pilotes sélectionnés.

`-p`périphérique `--pcm-device=`device

  Spécifie le périphérique à utiliser pour l'audio (voir la section ( Spécification du périphérique PCM). Voir la ligne pcm-device du fichier de configuration pour les paramètres par défaut à l'exécution. Cette option n'est pas disponible si vous avez spécifié l'option de compilation --disable-pcm-support.

`-q` `--quiet`

  Met moins d'informations dans le log. Cette option passe le niveau de journalisation (voir l'option -l à `notice` si vous avez spécifié l'option -v ou -V, et, sinon, à `warning`.

`-s`périphérique`.`...|`auto` `--speech-driver=`driver`.`...|`auto`

  Spécifie le pilote de la synthèse vocale (voir la section Spécification de pilote). Voir la ligne speech-driver du fichier de configuration pour les paramètres par défaut à l'exécution. Cette option n'est pas disponible si vous avez spécifié l'option de compilation --disable-speech-support.

`-t`fichier `--text-table=`file

  Spécifie la table de traduction de texte (voir la section Tables de traduction pour les détails). Si vous fournissez un chemin relatif, il est rattaché à `/etc/brltty` (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails). L'extension `.tbl` est facultative. Pour un nom de fichier simple, le péfixe `text.` est facultatif. Voir la ligne text-table du fichier de configureation pour les paramètres par défaut à l'exécution. Vous pouvez changer ce paramètre avec la préférence Text Table.

`-v` `--verify`

  Affiche les versions courantes de BRLTTY, du côté serveur de son API, et des pilotes de synthèse et de braille sélectionnés, puis quitte. Si l'option -q n'est pas spéciifiée, affiche aussi les informations légales, ainsi que les valeurs des options après que toutes les sources aient été examinées. Si vous avez spécifié plus d'un pilote braille (voir l'option en ligne de commande -b) et/ou plus d'un périphérique braille (voir l'option en ligne de commande -d), une autodétection de l'afficheur braille est entreprise. Si vous avez spécifié plus d'un pilote de synthèse (voir l'option en ligne de commande -s), une autodétection de la synthèse vocale est entreprise.

`-A`nom`=`valeur`.`... `--api-parameters=`name`=`value`.`...

  Spécifie les paramètres pour l'API. Si vous spécifiez le même paramètre plus d'une fois, c'est sa valeur la plus à droite qui est utilisée. Pour une description des paramètres acceptés par l'interface, reportez-vous au manuel de référence BrlAPI. Voir la ligne api-parameters du fichier de configuration pour les paramètres par défaut à l'exécution.

`-B`[pilote`:`]nom`=`valeur`.`... `--braille-parameters=`[driver`:`]name`=`value`.`...

  Spécifie les paramètres pour les pilotes des afficheurs braille. Si vous spécifiez le même paramètre plus d'une fois, c'est sa valeur le plus à droite qui est utilisée. Si vous qualifiez le nom d'un paramètre par un pilote, (voir la section Codes d'identification des pilotes) ce paramètre ne s'applique qu'à ce pilote; sinon il s'applique à tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, reportez-vous à la documentation de ce pilote. Voir la ligne braille-parameters du fichier de configuration pour les paramètres par défaut à l'exécution.

`-E` `--environment-variables`

  Reconnaît les variables d'environnement quand les paramètres par défaut pour des options en ligne de commande non spécifiées sont déterminés. (voir la section Options en ligne de commande). Si vous spécifiez cette option, et si vous définissez une variable d'environnement associée à une option non spécifiée, c'est la valeur de cette variable d'environnement qui est utilisée. Les noms de ces variables d'environnement sont basés sur les noms longs des options auxquelles elles correspondent:

  - Toutes les lettres sont en majuscule.
  - Les soulignements (`_`) sont utilisés au lieu du signe moins (`-`).
  - Le préfixe `BRLTTY_` est ajouté.
  Cette option est particulièrement utile sur les systèmes d'exploitation Linux dans le sens où elle permet de passer des paramètres par défaut à BRLTTY via les paramètres du boot. Les variables d'environnement suivantes sont supportées:
  `BRLTTY_API_PARAMETERS`

    Paramètres pour l'API (voir l'option en ligne de commande -A).

  `BRLTTY_ATTRIBUTES_TABLE`

    La table de traduction des attributs (voir l'option en ligne de commande -a).

  `BRLTTY_BRAILLE_DEVICE`

    Le périphérique de l'afficheur braille (voir l'option en ligne de commande -d).

  `BRLTTY_BRAILLE_DRIVER`

    Le pilote de l'afficheur braille (voir l'option en ligne de commande -b).

  `BRLTTY_BRAILLE_PARAMETERS`

    Paramètres pour le pilote de l'afficheur braille (voir l'option en ligne de commande -B).

  `BRLTTY_CONFIGURATION_FILE`

    Le fichier de configuration (voir l'option -f de la ligne de commande).

  `BRLTTY_CONTRACTION_TABLE`

    La table d'abrégé (voir l'option -c en ligne de commande).

  `BRLTTY_MIDI_DEVICE`

    Le périphérique pour l'interface MIDI (voir l'option -m en ligne de commande).

  `BRLTTY_PCM_DEVICE`

    Le périphérique audio (voir l'option -p en ligne de commande).

  `BRLTTY_SCREEN_PARAMETERS`

    Paramètres pour le pilote d'écran (voir l'option -X en ligne de commande).

  `BRLTTY_SPEECH_DRIVER`

    Le pilote de la synthèse vocale (voir l'option -s en ligne de commande).

  `BRLTTY_SPEECH_FIFO`

    Le pont de passage de la synthèse FIFO (voir l'option -F en ligne de commande).

  `BRLTTY_SPEECH_PARAMETERS`

    Paramètres pour le pilote de la synthèse vocale (voir l'option -S en ligne de commande).

  `BRLTTY_TEXT_TABLE`

    La table de traduction de texte (voir l'optien -a en ligne de commande).

`-F`fichier `--speech-fifo=`file

  Spécifie le FIFO (un fichier spécial qui fonctionne comme un tube) qui doit être utilisé par les autres applications souhaitant avoir accès au pilote de synthèse de BRLTTY. Si ce n'est pas spécifié, aucun FIFO n'est créé. Voir la ligne speech-fifo du fichier de configuration pour les paramètres par défaut à l'exécution. Cette option n'est pas disponible si vous avez spécifié l'option de compilation --disable-speech-support.

`-M`csecs `--message-delay=`csecs

  Spécifie le temps (en centièmes de seconde) que prend ÁRLTTY pour afficher ses propres messages internes sur l'afficheur braille. Si ce n'est pas spécifié, c'est `400` (4 secondes) qui est utlisé.

`-N` `--no-speech`

  Ne démarre pas automatiquement les pilotes de synthèse vocale. Malheureusement, cette option est parfois nécessaire sur certains systèmes, quand BRLTTY démarre avant que le son du système à l'intérieur du noyau n'ait été initialisé.

`-P`fichier `--pid-file=`fichier

  Spécifie le fichier à l'intérieur duquel BRLTTY doit écrire ses identifiants de processus (pid). Si cela n'est pas spécifié, BRLTTY écrit ses identifiants de processus nulle part.

`-S`[driver`:`]name`=`value`.`... `--speech-parameters=`[driver`:`]name`=`value`.`...

  Spécifie les paramètres pour les pilotes de synthèse vocale. Si vous spécifiez plus d'une fois le même paramètre, c'est sa valeur la plus à droite qui est utilisée. Si un nom de paramètre est qualifié par un pilote (voir la section Code d'identification de pilote) ce paramètre ne s'applique qu'à ce pilote; sinon il s'applique à tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir la ligne speech-parameters du fichier de configuration pour les paramètres par défaut à l'exécution.

`-U`csecs `--update-interval=`csecs

  Spécifie l'intervalle (en centièmes de secondes) auquel la fenêtre braille est synchronisée avec le nouveau contenu de l'écran. Si ce n'est pas spécifié, c'est `4` (40 millisecondes) qui est utilisé.

`-V` `--version`

  Affiche les versions courantes de BRLTTY lui-même, de la partie serveur de son API, et des pilotes qui ont été liés à son binaire, puis quitte. Si vous ne spécifiez pas l'option -q, affiche aussi les informations légales.

`-X`nom`=`valeur`.`... `--screen-parameters=`name`=`value`.`...

  Spécifie les paramètres pour le pilote d'écran. Si vous spécifiez plus d'une fois le même paramètre, c'est sa valeur la plus à droite qui est utilisé. Pour une description des paramètres acceptés par un pilote en particulier, reportez-vous à sa documentation. Voir la ligne screen-parameters du fichier de configuration pour la sélection des paramètres par défaut à l'exécution.

Page suivante Page précédente Table des matières