Braille Extender

Extension NVDA qui étend la sortie et la saisie braille, le défilement et les commandes propres à l’afficheur.

NVDA minimum : 2024.1

Après l’installation de l’extension, vous pouvez lire ce même guide depuis NVDA : Guide de l’utilisateur dans le menu NVDA sous Braille Extender, ou Aide dans le Gestionnaire d’extensions lorsque Braille Extender est sélectionné.


Table des matières

  1. Documentation dans NVDA
  2. Démarrage rapide
  3. Braille Extender et NVDA
  4. Catégories de paramètres (aperçu)
  5. Sujets détaillés
  6. Fonctionnalités principales
  7. Commandes et profils
  8. Retours et contributions
  9. Remerciements

Documentation dans NVDA

Élément Où le trouver
Ce guide (page web) Menu NVDA → Braille Extender → Guide de l’utilisateur, ou Gestionnaire d’extensions → Braille Extender → Aide.
Gestes pour votre afficheur Menu NVDA → Braille Extender → Gestes pour cet afficheur… — liste basée sur le profil braille actuel et les raccourcis clavier de l’extension.
Tables braille personnalisées Menu NVDA → Braille Extender → Tables braille personnalisées… (NVDA 2024.3+), ou Paramètres Braille Extender → Tables braille → Gérer les tables braille personnalisées….
Dictionnaires de table Menu NVDA → Braille Extender → Dictionnaires de table (Global, Table, Temporaire — pas un onglet des paramètres).
Lancements rapides Menu NVDA → Braille Extender → Lancements rapides… (pas un onglet des paramètres).
Dictionnaire du mode de saisie avancée Menu NVDA → Braille Extender → Dictionnaire du mode de saisie avancée… (pas un onglet des paramètres).
Sur le web Cette page sur GitHub ou le site du projet, si vous la consultez en ligne.

NVDA ouvre le fichier readme.html correspondant à votre langue d’interface : d’abord la langue complète (par ex. fr), puis le code à deux lettres (fr), puis l’anglais (en) si aucune traduction n’est installée. Le fichier se trouve dans le dossier doc de l’extension (doc/fr/readme.html pour le français).


Démarrage rapide

  1. Installez l’extension (fichier .nvda-addon, ou l’Add-on Store NVDA lorsqu’elle y est listée).
  2. Guide de l’utilisateur : Menu NVDA → Braille Extender → Guide de l’utilisateur ouvre ce document dans le navigateur. Utilisez-le en explorant les paramètres et les commandes. Le tableau Documentation dans NVDA liste les autres entrées du menu.
  3. Paramètres : Menu NVDA → Braille Extender → Paramètres… — parcourez les onglets utiles (par ex. Général, Tables braille, Mise en forme des documents).
  4. Commandes : NVDA → Préférences → Touches de commandes → Catégorie : Braille Extender — assignez les commandes que vous utiliserez. Menu NVDA → Braille Extender → Gestes pour cet afficheur… montre ce que définit déjà le profil de votre afficheur.

Braille Extender et NVDA

Braille Extender couvrait autrefois beaucoup de fonctions que NVDA ne proposait pas encore en braille. La première version publique date d’août 2017, la même semaine que NVDA 2017.3.

Les Paramètres → Braille de NVDA (et panneaux associés) ont depuis gagné des options dont beaucoup dépendaient de l’extension. Braille Extender ajoute encore du comportement ; consultez les notes de version NVDA pour le libellé exact de chaque élément ci-dessous.

Depuis NVDA Désormais dans NVDA (résumé)
2022.3 Interruption de la parole lors du défilement de l’afficheur braille.
2024.2 NVDA+Alt+t bascule le mode braille ; nouveau mode sortie parole (le braille reflète ce que NVDA annonce).
2024.3 Normalisation Unicode pour la parole et le braille ; tables braille personnalisées depuis les extensions et le dossier scratchpad NVDA. Braille Extender peut ajouter ses tables et utiliser celles d’autres extensions, pas seulement la liste intégrée NVDA.
2024.4 Annoncer le caractère lors du routage dans le texte ; plus de choix de mise en forme en braille (ex. balises) ; début de paragraphe en braille en lecture par paragraphe ; corrections de routage.
2025.1 Les tables d’entrée et de sortie peuvent suivre la langue de l’interface NVDA ; annoncer la ligne ou le paragraphe avec les touches de navigation braille.

Catégories de paramètres (aperçu)

Correspondance avec les onglets de Paramètres Braille Extender :

Catégorie Résumé
Général Canal de mise à jour, annoncer la ligne courante au défilement, ignorer les lignes vides, Caps Lock intelligent, retour modificateurs/volume, deux afficheurs favoris et rechargement, marge droite, inversion du défilement, terminaux (braille suit la revue), comportement du curseur au routage, annoncer le caractère au routage (jusqu’à prise en charge par NVDA).
Rotor Éléments du rotor et leur ordre.
Défilement automatique Délais et comportement du défilement braille automatique.
Mode historique de parole Taille de l’historique, numérotation, parole optionnelle en parcourant l’historique.
Mise en forme des documents Apparence en braille du gras, liens, alignement, etc., en complément de la mise en forme NVDA (voir Mise en forme des documents).
Excel Valeurs et formules des cellules en braille ; aperçu ligne/colonne optionnel avec routage (voir Excel).
Présentation des objets Ordre nom, état, valeur, etc. sur la ligne focalisée ; surbrillance de la sélection avec points 7/8 ; barres de progression sur l’afficheur.
Tables braille Listes préférées entrée/sortie, tables automatiques sur NVDA 2025.1+, table d’entrée pour raccourcis, seconde passe de traduction, tabulations en espaces, Gérer les tables braille personnalisées… (NVDA 2024.3+).
Représentation des caractères non définis Caractères absents de la table (points, nombres, descriptions, HUC, …).
Mode de saisie avancée Signe d’échappement et sortie après un caractère (le dictionnaire d’abréviations est un dialogue menu séparé — voir Documentation dans NVDA).
Mode unimanuel Activation et choix parmi trois méthodes de saisie unimanuelle.
Libellés de rôles Libellés braille personnalisés pour rôles, repères et états.
Avancé Correction curseur avec sélecteurs de variation ; actualiser le braille quand le nom de l’objet au premier plan change.

Sujets détaillés

Général

Tables braille

Dictionnaires de table (pas dans les onglets paramètres)

Trois niveaux : Global (toutes les tables), Table (table de sortie courante), Temporaire (surcharges jusqu’au redémarrage de NVDA). Si un fichier est erroné, ce niveau est ignoré jusqu’à correction.

Menu NVDA → Braille Extender → Dictionnaires de tableDictionnaire global, Dictionnaire de table ou Dictionnaire temporaire.

Tables braille personnalisées (NVDA 2024.3+)

Braille Extender peut stocker et utiliser vos tables lorsque vous les sélectionnez dans le gestionnaire. Elles s’appliquent à l’entrée et à la sortie via l’extension (pas via NVDA → Paramètres → Braille ni les listes de rotation de l’extension).

Prérequis

Où ouvrir le gestionnaire

Emplacement Usage
Menu NVDA → Braille Extender → Tables braille personnalisées… Dialogue dédié.
Paramètres Braille Extender → Tables braille → Gérer les tables braille personnalisées… Même dialogue.

Actions possibles

Action Description
Ajouter… Copier une table existante ou créer une table vide avec un fichier minimal. La liste inclut les tables NVDA, celles d’autres extensions et celles déjà stockées. Nom d’affichage, abrégée, entrée/sortie dans le dialogue suivant.
Supprimer Supprime les métadonnées et le fichier .utb / .ctb / .tbl après confirmation.
Modifier… Ouvre le fichier dans l’éditeur par défaut (dossier utilisateur ci-dessous).
Propriétés… Nom, abrégée, utilisation entrée et/ou sortie.

Pour cloner une table déjà gérée, Ajouter… → Copier une table existante et choisissez-la dans la liste.

Dialogue Ajouter

Choisir la table personnalisée active

En haut du dialogue :

Contrôle Effet
Table d’entrée personnalisée active Aucune (défaut) : table d’entrée NVDA normale. Sinon la table choisie pour la saisie braille.
Table de sortie personnalisée active Aucune : table de sortie NVDA normale. Sinon la table choisie pour la traduction.

Seules les tables sélectionnées ici sont actives. Elles n’apparaissent pas dans NVDA → Paramètres → Braille ni dans les listes de rotation Braille Extender, pour que NVDA démarre normalement si l’extension n’est pas chargé.

OK applique le choix. Pour arrêter : Aucune pour les deux listes (les fichiers restent). Pour supprimer définitivement : Supprimer dans le gestionnaire.

Stockage

Fichiers et petit fichier de paramètres dans le dossier de configuration utilisateur NVDA (Menu NVDA → Préférences → Général → Ouvrir le répertoire de configuration utilisateur de NVDA), sous *brailleExtender\customBrailleTables*.

Après ajout, suppression ou modification, le braille se met à jour immédiatement.

Utilisation au quotidien

  1. Ajoutez la table (Ajouter… → Copier ou créer vide).
  2. Dans Propriétés, autorisez entrée et/ou sortie.
  3. Définissez Table d’entrée et/ou de sortie personnalisée active (ou Aucune pour une direction).
  4. OK. Les nouvelles tables sont sélectionnées automatiquement pour les directions activées à l’ajout.

Si vous désactivez l’extension

Le choix de table personnalisée est conservé dans les paramètres Braille Extender pour que NVDA reste sur une table intégrée sûre. En réactivant l’extension, la sélection personnalisée revient.

Tables d’autres extensions (NVDA 2024.3+)

Pas besoin de copier dans le dossier Braille Extender. Les tables d’une autre extension (ex. Experimental braille tables) ou du scratchpad NVDA fonctionnent comme les tables intégrées : listes de rotation, commandes de table, ou passe de sortie supplémentaire. Sur NVDA 2024.1–2024.2, seules les tables intégrées NVDA sont prises en charge.

Fichier de table manquant

L’extension revient à une table sûre si possible et retire les entrées cassées de vos listes.

Mise en forme des documents

Braille Extender ne remplace pas le dialogue Mise en forme des documents de NVDA. L’onglet Mise en forme des documents ajoute une couche braille distincte :

Sur NVDA 2024.4+, NVDA a aussi des options globales de mise en forme braille ; cet onglet reste le contrôle ligne par ligne de l’extension.

Présentation des objets

Cet onglet modifie ce qui apparaît sur l’afficheur quand NVDA montre un objet à la fois — la ligne récapitulative du contrôle focalisé (bouton, lien, cellule de tableau, etc.). Il ne change pas ce que NVDA dit ; utilisez Paramètres NVDA → Présentation des objets pour la parole.

Ordre des propriétés…

Présentation des objets → Ordre des propriétés… (dialogue Ordre des propriétés) définit l’ordre des parties, de gauche à droite sur l’afficheur. Les parties sans contenu pour l’objet courant sont ignorées.

Champs réordonnables (libellés du dialogue) :

Réinitialiser à l’ordre NVDA par défaut — comme sans cette extension.

Réinitialiser l’ordre par défaut de l’extensionétat et coordonnées de cellule avant nom (défaut des nouveaux profils).

Ce qui suit encore NVDA

Les en-têtes de ligne/colonne de l’application peuvent encore être ajoutés après le résumé principal lorsqu’ils sont disponibles.

Éléments sélectionnés

Éléments sélectionnés marque un élément sélectionné sur la ligne récapitulative :

Choix Effet
rien Pas de marquage supplémentaire
point 7, point 8, ou points 7 et 8 Ajoute les points 7 et/ou 8 aux cellules du nom
balises Pas de caractères de balise sur le nom ; affecte seulement le texte d’état comme ci-dessous

Si le choix n’est pas rien et l’objet a un nom, les mots sélectionné et sélectionnable sont omis du texte d’état pour éviter la redondance. La surbrillance dans le texte courant suit le paramètre NVDA afficher la sélection.

Messages braille pour les barres de progression

Quand la valeur d’une barre change, l’extension peut afficher un court message braille (la parole est inchangée — utilisez Paramètres NVDA → Présentation des objets → Mises à jour de la barre de progression pour la parole) :

Option Affichage
désactivé (comportement d’origine) Pas de message braille supplémentaire
activé, valeur brute Texte de la valeur (défaut)
activé, barre avec ⣿ Rangée de cellules remplies selon le pourcentage

Signaler les barres de progression en arrière-plan

Les trois choix (Suivre la mise en forme des documents de NVDA, activé, désactivé) décident quelles fenêtres peuvent déclencher les messages ci-dessus :

Choix Effet
Suivre la mise en forme des documents de NVDA Suit Signaler les barres de progression en arrière-plan NVDA, ou les barres de la fenêtre de travail
activé Barres en arrière-plan et au premier plan
désactivé Seulement les barres de la fenêtre au premier plan

Excel

Paramètres Braille Extender → Excel contrôle l’affichage braille des cellules Microsoft Excel lorsque NVDA peut les lire comme avec les flèches. Ne s’applique pas à d’autres tableurs (LibreOffice Calc, feuilles dans le navigateur, etc.).

Si vous utilisiez Mise en forme des documents → Formule de cellule, l’option est déplacée ici. À la mise à jour, votre choix précédent est copié dans Excel → Signaler les formules de cellule en braille.

Signaler les formules de cellule en braille

Si coché (défaut), l’extension peut afficher les formules en braille, pas seulement la valeur visible. Si décoché, comportement braille Excel standard NVDA sans ligne formule de cette extension.

Sans l’extension, NVDA affiche souvent frml pour une cellule avec formule. Avec Cellule focalisée uniquement (ci-dessous), vous gardez la ligne cellule habituelle et la formule complète s’ajoute — vous lisez la formule, pas seulement frml.

Vue braille

Contrôle combien de la feuille apparaît sur l’afficheur :

Choix Affichage
Cellule focalisée uniquement (défaut) La cellule courante, plus sa formule si présente. Comme le braille Excel NVDA habituel.
Plage de ligne sur une ligne Une portion de la ligne autour de la cellule — pas toute la ligne de la feuille. Nombre de cellules de chaque côté : Cellules de chaque côté de la focalisation (ligne de plage ligne/colonne) (défaut 9). La ligne peut être plus courte : du premier au dernier non vide dans la fenêtre.
Plage de colonne sur une ligne Idem pour la colonne autour de la cellule (plage limitée, pas toute la colonne).

Les vues ligne/colonne servent à parcourir les cellules voisines sans déplacer la focalisation cellule par cellule.

Vous pouvez aussi changer la Vue braille au clavier dans Excel : NVDA → Préférences → Touches de commandes, assignez Parcourir la vue braille Excel (cellule focalisée, plage de ligne ou de colonne sur une ligne) (catégorie Braille Extender). Pas de raccourci par défaut ; chaque appui passe par Cellule focalisée uniquement, Plage de ligne sur une ligne, Plage de colonne sur une ligne, puis recommence. La commande ne fonctionne que si Signaler les formules de cellule en braille est activé.

En vue Cellule focalisée uniquement, le défilement braille est comme NVDA (votre position sur la ligne est conservée entre cellules). En Plage de ligne sur une ligne ou Plage de colonne sur une ligne, la cellule focalisée reste à gauche de l’afficheur en changeant de cellule.

Formules sur la ligne de plage (ligne ou colonne)

S’applique seulement si Vue braille est Plage de ligne sur une ligne ou Plage de colonne sur une ligne :

Choix Signification
Cellule focalisée uniquement (défaut) Les voisines montrent leurs valeurs ; la cellule focalisée peut encore montrer sa formule.
Chaque cellule de la ligne Valeurs et formules pour chaque cellule de la ligne.
Valeurs uniquement (pas de formules) Valeurs seulement ; formules masquées sur l’aperçu.

Cellules de chaque côté de la focalisation (ligne de plage ligne/colonne)

En vue Plage de ligne sur une ligne ou Plage de colonne sur une ligne, nombre maximal de cellules à gauche et à droite (ligne) ou au-dessus et en dessous (colonne). Défaut 9 (jusqu’à 19 positions : 9 + cellule + 9). De 0 à 50.

La ligne est en général plus courte que ce maximum : du premier au dernier non vide dans la fenêtre. Les cellules vides entre deux cellules avec contenu apparaissent comme espaces vides.

Séparateur entre cellules sur la ligne

Texte entre chaque cellule sur une ligne ligne ou colonne. Défaut : espace, barre verticale, espace : |. Modifiable (ex. - ou ,).

Préfixes de ligne (plage ligne) et de colonne (plage colonne)

En vue Plage de ligne sur une ligne ou Plage de colonne sur une ligne, court préfixe au début de la ligne braille, avant l’adresse de la cellule courante. NVDA ajoute un espace après le préfixe — ne mettez pas d’espace final dans le paramètre.

Champ Défaut (français) Rôle
Préfixe de ligne (plage ligne) lig Lignes de plage de ligne (ex. lig A2: Bonjour | …)
Préfixe de colonne (plage colonne) col Lignes de plage de colonne (ex. col A2: Bonjour | …)

Laissez vide pour le défaut traduit selon la langue NVDA. Saisissez votre libellé court (ex. L ou Ln) si vous préférez.

Aspect d’une ligne ligne ou colonne

Exemples (séparateur et préfixes par défaut) :

Touches de routage sur une ligne ligne ou colonne

En vue Plage de ligne sur une ligne ou Plage de colonne sur une ligne, chaque partie de la ligne correspond à une cellule :

Vous pouvez ainsi parcourir la ligne ou la colonne depuis l’afficheur sans flèches cellule par cellule.

Cellules fusionnées

Si plusieurs colonnes ou lignes sont fusionnées :

Représentation des caractères non définis

Les caractères non définis dans la table de sortie active (dont beaucoup d’emoji) utilisent la méthode choisie : comportement de la table, cellule 1–8 ou 1–6, vide, motif de points personnalisé (ex. 6-123456), point d’interrogation, signe personnalisé (ex. ??), hex (style table, HUC8, HUC6), décimal, octal, binaire.

Descriptions : description de caractère optionnelle, étendue, étendue complète, ligne de taille optionnelle, données Unicode en dernier recours, liste d’exclusion (codes ou plages) pour ignorer les plages trop verbeuses.

Priorité : règles de table et dictionnaires de table avant les descriptions ; descriptions avant le motif générique non défini.

Plus sur HUC : danielmayr.at/huc

Mode de saisie avancée

Onglet paramètres : signe d’échappement pour saisie numérique/Unicode et quitter après un caractère.

Dialogue menu : Menu NVDA → Braille Extender → Dictionnaire du mode de saisie avancée… — abréviations par table d’entrée (séparé des dictionnaires de table).

Basculez le mode de saisie avancée (défauts : NVDA+Windows+i ou ⡊+espace). Pendant l’activation :

Saisie HUC6 non implémentée.

Caractère HUC8 Hex Décimal Octal Binaire
👍 pouce levé ⣭⢤⡙ 1F44D 128077 372115 11111010001001101
😀 visage rieur ⣭⡤⣺ 1F600 128512 373000 11111011000000000
🍑 pêche ⣭⠤⠕ 1F351 127825 371521 11111001101010001
🌊 vague ⣭⠤⠺ 1F30A 127754 371412 11111001100001010

Mode unimanuel

Composez une cellule en plusieurs étapes — utile si vous tapez d’une seule main. Dans Paramètres Braille Extender, les trois méthodes apparaissent dans cet ordre : Remplir une cellule en deux étapes d’un seul côté, Remplir une cellule en deux étapes des deux côtés, Remplir une cellule point par point. Basculez avec NVDA+Windows+h (souvent ⡂+espace sur les afficheurs pris en charge). Si la méthode enregistrée est inconnue, l’extension annonce non prise en charge et efface toute cellule partiellement saisie.

Un seul côté (deux étapes sur une moitié ; Espace = moitié vide)

Première étape : points 1–2–3–7. Deuxième : 4–5–6–8. Espace = « cette moitié est vide ». Espace deux fois = cellule entièrement vide.

Les deux côtés (moitié gauche, puis droite)

Tapez la moitié gauche, puis la droite. Si un côté est vide, appuyez deux fois sur les mêmes points, ou saisissez le côté non vide en deux étapes.

Point par point (bascule)

Chaque touche inverse un point. Espace quand la cellule convient.

peut se construire : 1–2 puis 4–5 puis Espace ; ou 1–2–3, point 3 à nouveau pour corriger, puis 4–5, Espace ; etc.

Mode historique de parole

Ne pas confondre avec le raccourci NVDA de bascule du mode braille (NVDA+Alt+t).

Dans NVDA actuel (voir Référence des commandes → Braille et Aide à la saisie) :

Ce que fait Braille Extender

Quand le Mode historique de parole est activé, l’extension enregistre ce que NVDA annonce en lignes de texte consultables, utilise le défilement par ligne pour parcourir la liste, et remplace la ligne braille par ces lignes au lieu de la focalisation ou de la revue habituelles. Désactiver le mode restaure le braille normal.

Rotor

Le rotor change la catégorie de navigation rapide / revue active. Catégories : navigation texte, sélection, objet / revue, liens (visités/non visités), repères, titres (par niveau), listes, contrôles de formulaire, tableaux, mise en forme identique/différente, listes tables entrée/sortie, etc.

Défilement automatique

Quand le défilement automatique est activé, l’afficheur avance seul sur un minuteur en vue braille habituelle. En passant à une autre vue (ex. historique de parole), le défilement automatique se met en pause jusqu’au retour.

Libellés de rôles

Si Utiliser des libellés de rôles personnalisés est coché, vous pouvez modifier les libellés rôle, repère et états positifs / négatifs par langue (stockés avec les autres paramètres Braille Extender). Si décoché, les libellés NVDA par défaut s’appliquent.

Avancé


Fonctionnalités principales


Commandes et profils


Retours et contributions

Signalements de bogues, suggestions et pull requests sont les bienvenus sur GitHub — BrailleExtender. Si vous modifiez du texte visible ou le comportement, mettez à jour ce guide et les traductions que vous maintenez.

Le code source, la compilation et les outils de développement sont décrits sur le dépôt GitHub (pas dans ce guide utilisateur).


Remerciements

Traducteurs

Code et tiers

Merci aussi à Daniel Cotto, Daniel Mayr, Dawid Pieper, Corentin, Louis, et à tous ceux qui ont fait des retours.