Дополнение для NVDA, расширяющее возможности вывода, ввода, прокрутки по шрифту Брайля и жестов для конкретных дисплеев.
Минимальная версия NVDA: 2024.1
После установки дополнения вы можете прочитать это же руководство из NVDA: используйте Руководство пользователя в меню NVDA → Braille Extender, или откройте Справку в менеджере дополнений, выбрав Braille Extender.
| Что | Где найти |
|---|---|
| Это руководство (в виде веб-страницы) | Меню NVDA → Braille Extender → Руководство пользователя, или Менеджер дополнений → Braille Extender → Справка. |
| Жесты для вашего дисплея | Меню NVDA → Braille Extender → Жесты для этого дисплея… — список, основанный на вашем текущем профиле дисплея Брайля и сочетаниях клавиш дополнения. |
| Пользовательские таблицы Брайля | Меню NVDA → Braille Extender → Пользовательские таблицы Брайля… (NVDA 2024.3+), или Настройки Braille Extender → Таблицы Брайля → Управление пользовательскими таблицами Брайля…. |
| Словари таблиц | Меню NVDA → Braille Extender → Словари таблиц (Глобальный, таблицы, временный — не вкладка настроек). |
| Быстрые запуски | Меню NVDA → Braille Extender → Быстрые запуски… (не вкладка настроек). |
| Словарь расширенного режима ввода | Меню NVDA → Braille Extender → Словарь расширенного режима ввода… (не вкладка настроек). |
| В интернете | Эта страница на GitHub или на сайте проекта, если вы читаете онлайн. |
.nvda-addon или через магазин дополнений NVDA, когда оно там появится).Ранее Braille Extender покрывал многие возможности, которых в NVDA ещё не было. Первый публичный выпуск состоялся в августе 2017, в ту же неделю, что и NVDA 2017.3.
Собственные Настройки → Брайль NVDA (и связанные панели) с тех пор получили опции, на которые многие полагались в дополнении. Braille Extender всё ещё добавляет дополнительное поведение; сверяйтесь с журналом изменений NVDA для точных формулировок по каждому пункту ниже.
| Версия NVDA | Теперь в ядре NVDA (кратко) |
|---|---|
| 2022.3 | Прерывание речи при прокрутке дисплея Брайля. |
| 2024.2 | NVDA+Alt+t переключает режим Брайля; новый режим вывод речи на дисплей (Брайль отражает то, что говорит NVDA). |
| 2024.3 | Нормализация Юникода для речи и Брайля; пользовательские таблицы Брайля из дополнений и папки scratchpad NVDA. Braille Extender может добавлять свои таблицы и использовать таблицы из других дополнений, не только из встроенного списка NVDA. |
| 2024.4 | Озвучивание символа при маршрутизации в тексте; больше параметров форматирования в Брайле (например, теги); начало абзаца в Брайле при чтении по абзацам; исправления маршрутизации. |
| 2025.1 | Таблицы ввода и вывода могут следовать за языком интерфейса NVDA; озвучивание строки или абзаца при использовании клавиш навигации по Брайлю. |
Эти категории соответствуют вкладкам в Настройках Braille Extender:
| Категория | Краткое описание |
|---|---|
| Основные | Канал обновлений, озвучивание текущей строки при прокрутке, пропуск пустых строк, умный Caps Lock, обратная связь по модификаторам/громкости, два избранных дисплея и их перезагрузка, правый отступ, обратная прокрутка, терминалы (Брайль следует за обзорным курсором), поведение маршрутизации в полях ввода, озвучивание символа при маршрутизации (пока NVDA не обрабатывает это). |
| Ротор | Какие элементы ротора существуют и их порядок. |
| Автопрокрутка | Задержки и поведение для автоматической прокрутки Брайля. |
| Режим истории речи | Длина истории, нумерация, возможность озвучивания при просмотре истории. |
| Форматирование документов | Как форматирование (жирный, ссылки, выравнивание и т.д.) отображается в Брайле, в дополнение к форматированию документов NVDA (см. Подробные темы). |
| Excel | Показывать значения и формулы ячеек в Брайле; обзор строки или столбца с помощью маршрутизации (см. Excel). |
| Представление объектов | Порядок имени, состояния, значения и других полей в строке фокуса; выделение выбора точками 7/8; сообщения о ходе выполнения на дисплее. |
| Таблицы Брайля | Предпочтительные списки таблиц ввода/вывода, автоматические таблицы в NVDA 2025.1+, таблица для быстрых команд, второй проход трансляции, табуляция как пробелы, Управление пользовательскими таблицами Брайля… (NVDA 2024.3+). |
| Представление неопределённых символов | Как отображаются символы, отсутствующие в таблице (точки, числа, описания, HUC и т.д.). |
| Расширенный режим ввода | Символ выхода и выход после одного символа (словарь сокращений находится в отдельном диалоге меню — см. Документация в NVDA). |
| Режим одной руки | Включение и выбор одного из трёх методов ввода одной рукой. |
| Метки ролей | Пользовательские метки Брайля для ролей, ориентиров и состояний. |
| Дополнительно | Исправление позиции курсора для символов-вариаций; обновление Брайля при изменении имени объекта на переднем плане. |
Словари таблиц (не во вкладках настроек)
Три уровня работают вместе: Глобальный (применяется ко всем таблицам), Таблицы (для текущей выходной таблицы) и Временный (кратковременные переопределения до перезапуска NVDA). Если файл словаря содержит ошибки, этот уровень пропускается до исправления.
Откройте Меню NVDA → Braille Extender → Словари таблиц → Глобальный словарь, Словарь таблицы или Временный словарь.
Braille Extender может хранить и использовать ваши собственные таблицы Брайля, когда вы выбираете их в менеджере. Они применяются к вводу и выводу Брайля через дополнение (не через NVDA → Настройки → Брайль или списки вращения таблиц дополнения).
Требования
.utb, .ctb или .tbl (не вспомогательные файлы, такие как .cti или .dis).Где открыть менеджер
| Расположение | Использование |
|---|---|
| Меню NVDA → Braille Extender → Пользовательские таблицы Брайля… | Специализированный диалог (список и все действия). |
| Настройки Braille Extender → Таблицы Брайля → Управление пользовательскими таблицами Брайля… | Открывает тот же диалог. |
Что вы можете делать
| Действие | Описание |
|---|---|
| Добавить… | Копировать из существующей таблицы или создать пустую таблицу с минимальным начальным файлом правил. Список для копирования включает встроенные таблицы NVDA, таблицы из других дополнений и таблицы, уже сохранённые Braille Extender. Установите отображаемое имя, контрактность и флаги ввода/вывода в следующем диалоге. |
| Удалить | Удаляет метаданные и сохранённый файл .utb / .ctb / .tbl после подтверждения. |
| Редактировать… | Открывает файл таблицы в вашем редакторе по умолчанию (в папке хранения пользователя, указанной ниже). |
| Свойства… | Изменить отображаемое имя, контрактность и то, используется ли таблица для ввода и/или вывода. |
Чтобы клонировать пользовательскую таблицу, которой вы уже управляете, используйте Добавить… → Копировать из существующей таблицы и выберите её в списке (то же отображаемое имя, что и в списке пользовательских таблиц).
Диалог добавления
.utb, .ctb или .tbl)..utb или .ctb, если вы отметите таблицу как контрактную на этапе свойств.Выбор пользовательской таблицы для использования
В верхней части диалога пользовательских таблиц Брайля:
| Элемент управления | Действие |
|---|---|
| Активная пользовательская таблица ввода | Нет (по умолчанию) использует обычную таблицу ввода NVDA. Выберите пользовательскую таблицу, чтобы использовать её для ввода Брайля. |
| Активная пользовательская таблица вывода | Нет использует обычную таблицу вывода NVDA. Выберите пользовательскую таблицу, чтобы использовать её для трансляции Брайля. |
Активны только те таблицы, которые вы выбрали здесь. Они не отображаются в NVDA → Настройки → Брайль или в списках вращения таблиц Braille Extender, поэтому NVDA может нормально запускаться, даже если дополнение не загружено.
Нажмите ОК, чтобы применить ваш выбор. Чтобы перестать использовать пользовательские таблицы, установите оба списка в Нет (файлы сохраняются). Чтобы полностью удалить таблицы, используйте Удалить в менеджере.
Хранение
Файлы таблиц и небольшой файл настроек сохраняются в вашей папке конфигурации пользователя NVDA ( Меню NVDA → Настройки → Общие → Открыть папку конфигурации пользователя NVDA ), в папке *brailleExtender\customBrailleTables*.
После добавления, удаления или изменения таблиц Брайль обновляется немедленно.
Использование пользовательских таблиц в повседневной работе
Если вы отключаете дополнение
Ваш выбор пользовательской таблицы сохраняется в собственных настройках Braille Extender, поэтому настройки Брайля NVDA остаются на безопасной встроенной таблице. Когда вы снова включите дополнение, ваш выбор вернётся.
Таблицы из других дополнений (NVDA 2024.3+)
Вам не нужно копировать таблицу в папку Braille Extender. Таблицы из другого дополнения (например, Экспериментальные таблицы Брайля) или из scratchpad NVDA работают как встроенные таблицы: добавьте их в ваши списки вращения, переключайтесь на них с помощью команд таблиц или используйте их как дополнительный проход вывода. В NVDA 2024.1–2024.2 поддерживаются только встроенные таблицы NVDA.
Если файл таблицы отсутствует
Дополнение переключается на безопасную таблицу, где это возможно, и очищает повреждённые записи из ваших списков, чтобы Брайль продолжал работать.
Braille Extender не заменяет диалог Форматирование документов NVDA. Вкладка настроек Форматирование документов добавляет отдельный слой Брайля:
В NVDA 2024.4+ NVDA также имеет глобальные параметры форматирования Брайля; эта вкладка остаётся пошаговым управлением дополнения.
Эта вкладка изменяет то, что отображается на дисплее Брайля, когда NVDA показывает один объект за раз — сводную строку для элемента с фокусом (кнопка, ссылка, ячейка таблицы и т.п.). Она не изменяет то, как NVDA озвучивает информацию об объекте; для речевых параметров используйте Настройки → Представление объектов NVDA.
Откройте Представление объектов → Порядок свойств…, чтобы установить какие части идут первыми, при чтении слева направо на дисплее. Части, не имеющие содержимого для текущего объекта, пропускаются.
Вы можете изменить порядок этих полей (метки соответствуют диалогу):
3/10 в Брайле, а не «3 из 10»)ур 2)Сбросить на порядок NVDA по умолчанию — такой же порядок, как в NVDA без этого дополнения (имя, затем значение, состояние, текст роли и т.д.).
Сбросить на порядок дополнения по умолчанию — помещает состояние и координаты ячейки перед именем (по умолчанию для новых профилей).
Что по-прежнему следует за NVDA
Заголовки строк и столбцов из приложения могут добавляться после основной сводки, когда они доступны.
Выделенные элементы управляет тем, как выбранный элемент отмечается в этой сводной строке объекта:
| Выбор | Действие |
|---|---|
| ничего | Нет дополнительной разметки от этого дополнения |
| точка 7, точка 8 или точки 7 и 8 | Добавляет точки 7 и/или 8 к ячейкам Брайля, составляющим имя объекта |
| теги | Не рисует символы тегов в имени; влияет только на текст состояния, как показано ниже |
Когда выбор не ничего и объект имеет имя, слова выбран и выбираемый опускаются из текста состояния, чтобы не сообщать «выбран» дважды. Выделение внутри текста по-прежнему следует собственному параметру NVDA показывать выделение.
Когда значение индикатора выполнения изменяется, дополнение может показывать короткое сообщение на дисплее Брайля (речь не изменяется — для речевых параметров используйте NVDA Настройки → Представление объектов → Обновления индикатора выполнения):
| Опция | Что вы видите |
|---|---|
| отключено (исходное поведение) | Нет дополнительных сообщений Брайля от этого дополнения |
| включено, показывать необработанное значение | Текст значения индикатора (по умолчанию) |
| включено, показывать индикатор выполнения с помощью ⣿ | Ряд заполненных ячеек по всей ширине дисплея, длина зависит от процента |
Три варианта (Следовать форматированию документов NVDA, включено, отключено) используют ту же формулировку, что и на вкладке «Форматирование документов», но здесь они определяют только в каких окнах индикаторы выполнения могут вызывать вышеуказанные сообщения Брайля:
| Выбор | Действие |
|---|---|
| Следовать форматированию документов NVDA | Следует NVDA Сообщать о фоновых индикаторах выполнения или показывает индикаторы в окне, в котором вы работаете |
| включено | Индикаторы выполнения в фоновых и активных окнах |
| отключено | Только индикаторы выполнения в активном окне |
Откройте Настройки Braille Extender → Excel для управления тем, как ячейки Microsoft Excel отображаются в Брайле. Эти параметры предназначены для настольной версии Excel, когда NVDA может читать ячейки на листе так же, как при перемещении с помощью клавиш со стрелками. Они не применяются к другим программам работы с электронными таблицами (например, LibreOffice Calc или таблицам в веб-браузере).
Если вы ранее использовали Форматирование документов → Формула ячейки, эта опция перемещена сюда. При обновлении дополнения ваш предыдущий выбор (вкл/выкл) автоматически копируется в Excel → Сообщать формулы ячеек в Брайле.
Когда этот флажок установлен (по умолчанию), дополнение может показывать формулы на дисплее Брайля, а не только значение, отображаемое в ячейке. Когда он снят, ячейки Excel ведут себя как стандартный Брайль NVDA без дополнительной строки формулы.
Без дополнения NVDA часто показывает краткую подсказку frml, когда ячейка содержит формулу. С опцией Только текущая ячейка (ниже) вы по-прежнему получаете обычную строку ячейки (значение, координаты и т.д.), а полная формула добавляется после неё — поэтому вы читаете саму формулу вместо только frml.
Этот параметр определяет какая часть листа отображается на дисплее Брайля одновременно:
| Выбор | Что вы видите |
|---|---|
| Только текущая ячейка (по умолчанию) | Ячейка, в которой вы находитесь, как обычно, плюс её формула, если она есть. Та же раскладка, что и в обычном Брайле NVDA для этой ячейки. |
| Диапазон строк в одной строке | Часть строки вокруг вашей ячейки в одной строке Брайля — не вся строка листа. Количество ячеек с каждой стороны задаётся в Ячеек с каждой стороны фокуса (по умолчанию 9). Строка может быть короче: от первой до последней непустой ячейки в этом окне. |
| Диапазон столбцов в одной строке | То же самое для столбца вокруг вашей ячейки (опять же ограниченный диапазон, а не весь столбец). |
Представления диапазона строк и столбцов предназначены для просмотра соседних ячеек без перемещения по ячейкам по одной.
Вы также можете изменить Вид Брайля с клавиатуры, пока запущен Excel: в NVDA → Настройки → Жесты ввода назначьте Циклическое переключение вида Брайля Excel (только текущая ячейка, диапазон строк или столбцов в одной строке) (находится в категории Braille Extender). Сочетания клавиш по умолчанию нет; каждое нажатие переключает между Только текущая ячейка, Диапазон строк в одной строке, затем Диапазон столбцов в одной строке и обратно. Жест работает только когда Сообщать формулы ячеек в Брайле включено.
В режиме Только текущая ячейка прокрутка Брайля ведёт себя как обычно (ваша позиция в строке сохраняется при перемещении между ячейками). В режиме Диапазон строк в одной строке или Диапазон столбцов в одной строке текущая ячейка удерживается слева на дисплее Брайля при перемещении в другую ячейку, поэтому строка обзора остаётся выровненной.
Этот список применяется только когда Вид Брайля установлен в Диапазон строк в одной строке или Диапазон столбцов в одной строке:
| Выбор | Значение |
|---|---|
| Только текущая ячейка (по умолчанию) | Соседние ячейки показывают только значения; текущая ячейка может показывать свою формулу в своей части строки. |
| Каждая ячейка в строке | Значения и формулы для каждой ячейки, отображаемой в этой строке. |
| Только значения (без формул) | Каждая ячейка в строке показывает только своё значение; формулы скрыты в этом обзоре. |
Когда Вид Брайля установлен в Диапазон строк в одной строке или Диапазон столбцов в одной строке, это число определяет максимальное количество ячеек слева и справа от вашей ячейки (в строке) или сверху и снизу (в столбце), которое может отображаться в строке. По умолчанию 9 (до 19 позиций: 9 + ваша ячейка + 9). Вы можете установить от 0 до 50.
Строка обычно короче этого максимума: она начинается с первой и заканчивается последней непустой ячейкой в окне. Пустые ячейки между двумя ячейками с содержимым отображаются как пустые промежутки в строке.
Текст, помещаемый между каждой ячейкой в строке или столбце. По умолчанию пробел, вертикальная черта, пробел: |. Вы можете изменить его (например, на - или ,) в соответствии со своим стилем чтения.
Когда Вид Брайля установлен в Диапазон строк в одной строке или Диапазон столбцов в одной строке, короткий префикс отображается в начале строки Брайля, перед адресом текущей ячейки. NVDA автоматически добавляет один пробел после префикса — не ставьте завершающий пробел в настройке.
| Поле | По умолчанию (английский) | Роль |
|---|---|---|
| Префикс строки | row |
Строки диапазона строк (пример: row A2: Hello | …) |
| Префикс столбца | col |
Строки диапазона столбцов (пример: col A2: Hello | …) |
Оставьте поле пустым, чтобы использовать переведённое значение по умолчанию для вашего языка NVDA. Введите свою собственную короткую метку (например, Стр или Стб), если вы предпочитаете что-то другое на дисплее.
Примеры (разделитель и префиксы по умолчанию):
Hello, пустые B2–F2, значение 99 в G2:row A2: Hello | | | | | | 99row или col по умолчанию, или ваш пользовательский текст) показывает, является ли строка диапазоном строк или столбцов; адрес текущей ячейки (A2:) следует сразу после этого префикса и одного пробела.A2: Hello). Другие ячейки показывают только своё значение (или ничего, если пусто).| |).Когда Вид Брайля установлен в Диапазон строк в одной строке или Диапазон столбцов в одной строке, каждая часть строки привязана к одной ячейке:
Hello в A2: Hello), чтобы редактировать эту ячейку, как при маршрутизации на обычной ячейке Excel в NVDA.Таким образом, вы можете переходить по строке или столбцу с дисплея Брайля, не перемещаясь по каждой ячейке с помощью стрелок.
Если несколько столбцов или строк объединены в одну ячейку:
B2 через D2), и вы по-прежнему видите её значение или формулу, когда находитесь в любой части этого объединения.Символы, не определённые в активной выходной таблице (включая многие эмодзи), используют выбранный метод: использовать поведение таблицы Брайля, полная ячейка 1–8 или 1–6, пусто, пользовательский рисунок точек (например, 6-123456), вопросительный знак, пользовательский знак (например, ??), шестнадцатеричный (стиль таблицы, HUC8, HUC6), десятичный, восьмеричный, двоичный.
Описания: дополнительное описание символа, расширенное описание, полное расширенное, дополнительная строка размера, дополнительные данные Юникода в качестве последнего средства и список исключений (коды символов или диапазоны), чтобы описание пропускалось для диапазонов, которые вы считаете шумными.
Приоритет: правила таблицы и словари таблиц имеют приоритет над описаниями; описания имеют приоритет над общим шаблоном неопределённых.
Подробнее о HUC: danielmayr.at/huc
Вкладка настроек: escape-символ для числового/Юникод ввода и выход после одного символа.
Диалог меню: Меню NVDA → Braille Extender → Словарь расширенного режима ввода… — записи сокращений для каждой таблицы ввода (отдельно от словарей таблиц).
Переключение расширенного ввода (по умолчанию включает NVDA+Windows+i или ⡊+space). В активном режиме:
Ввод HUC6 не реализован.
| Символ | HUC8 | Шестнадцатеричное | Десятичное | Восьмеричное | Двоичное |
|---|---|---|---|---|---|
| 👍 большой палец вверх | ⣭⢤⡙ | 1F44D | 128077 | 372115 | 11111010001001101 |
| 😀 улыбающееся лицо | ⣭⡤⣺ | 1F600 | 128512 | 373000 | 11111011000000000 |
| 🍑 персик | ⣭⠤⠕ | 1F351 | 127825 | 371521 | 11111001101010001 |
| 🌊 волна | ⣭⠤⠺ | 1F30A | 127754 | 371412 | 11111001100001010 |
Составление ячейки в несколько шагов — полезно, если вы печатаете одной рукой. В Настройках Braille Extender три метода отображаются в таком порядке: Заполнить ячейку в два этапа, используя только одну сторону, Заполнить ячейку в два этапа, используя обе стороны, Заполнить ячейку по точкам. Переключите режим одной руки с помощью NVDA+Windows+h (часто ⡂+space на поддерживаемых дисплеях). Если сохранённый метод неизвестен, дополнение произносит неподдерживается и очищает частично введённую ячейку.
Первый шаг: точки 1–2–3–7. Второй шаг: 4–5–6–8. Пробел означает «эта половина пуста». Двойной пробел даёт полностью пустую ячейку.
Введите точки левой панели, затем правой. Если одна сторона пуста, нажмите те же точки дважды или введите непустую сторону в два шага.
Каждое нажатие клавиши переключает точку. Нажмите Пробел, когда ячейка станет нужной.
⠛ можно построить как: 1–2 затем 4–5 затем Пробел; или 1–2–3, снова точка 3 для исправления, затем 4–5, Пробел; или 1, затем 2–4–5, Пробел; и другие пути.
Не путайте с сочетанием NVDA для переключения режима Брайля (NVDA+Alt+t).
В текущей версии NVDA (см. Краткий справочник команд → Брайль и Справку по вводу):
NVDA+Alt+t — Переключение режима Брайля (сочетание задокументировано с NVDA 2024.2, в котором был добавлен режим вывод речи на дисплей: Брайль может отражать то, что говорит NVDA). NVDA циклически переключает свои режимы Брайля, включая дисплей против речевого вывода. Это по-прежнему не отдельный список истории речи Braille Extender и соответствующий рабочий процесс маршрутизации.Что вместо этого делает Braille Extender
Когда Режим истории речи включён, дополнение записывает то, что говорит NVDA в виде строк обычного текста, которые вы можете просматривать, использует прокрутку строк на дисплее для перемещения по этому списку и переключает строку Брайля на отображение этих строк вместо обычного текста фокуса или обзора. Выключение режима возвращает Брайль в обычное состояние и обновляет дисплей.
NVDA+Alt+t, если вы не намерены заменить команду NVDA переключения режима Брайля на эту клавишу.# и номер записи (дополненный ведущими нулями, чтобы все номера имели одинаковую ширину), затем : и текст — например, #3: или #0003: в зависимости от вашего лимита истории.Ротор переключает активную категорию быстрой навигации / обзора. Категории включают навигацию по тексту, выделение, объект / обзор, ссылки (посещённые/непосещённые), ориентиры, заголовки (по уровням), списки, элементы форм, таблицы, одинаковое/разное форматирование, списки таблиц ввода/вывода и другие.
Когда автопрокрутка включена, дисплей продвигается сам по таймеру, пока вы находитесь в обычном представлении Брайля. Если вы переключитесь в другое представление (например, историю речи), автопрокрутка приостанавливается до возврата.
Когда флажок Использовать пользовательские метки ролей установлен, вы можете редактировать метки ролей, ориентиров и положительных / отрицательных состояний для каждого языка на этой панели (сохраняются вместе с другими настройками Braille Extender). Когда флажок снят, применяются метки NVDA по умолчанию.
Сообщения об ошибках, предложения и запросы на включение (pull requests) приветствуются на GitHub — BrailleExtender. Если вы изменяете видимый пользователю текст или поведение, пожалуйста, обновите это руководство и все поддерживаемые вами переводы, чтобы все были синхронизированы.
Если вы работаете с исходным кодом, шаги сборки и инструменты разработчика описаны в репозитории на GitHub (не в этом руководстве пользователя).
Особая благодарность Daniel Cotto, Daniel Mayr, Dawid Pieper, Corentin, Louis и всем, кто сообщал об ошибках и предлагал улучшения.