ВАЖНО: это форк дополнения Braille Extender (оригинальный автор: André-Abush Clause). Остальная часть этого документа основана на руководстве пользователя Braille Extender с изменениями, касающимися названия дополнения и деталей использования. Список изменений между выпусками дополнения Braille Essentials см. в журнале изменений для выпусков дополнения.
Дополнение для NVDA, которое расширяет возможности вывода, ввода, прокрутки и специфичных для дисплея жестов для брайлевских дисплеев.
| Что | Где | |------|--------| | Это руководство (в виде веб-страницы) | Магазин дополнений → Braille Essentials → Справка. | | Жесты для вашего дисплея | Меню NVDA → Braille Essentials → Жесты для этого дисплея… — список, основанный на вашем текущем профиле брайлевского дисплея и сочетаниях клавиш дополнения. | | Пользовательские брайлевские таблицы | Меню NVDA → Braille Essentials → Пользовательские брайлевские таблицы… (NVDA 2024.3+), или Настройки Braille Essentials → Брайлевские таблицы → Управление пользовательскими брайлевскими таблицами…. | | Словари таблиц | Меню NVDA → Braille Essentials → Словари таблиц (Глобальный, Таблицы, Временный — не вкладка настроек). | | Быстрый запуск | Меню NVDA → Braille Essentials → Быстрый запуск… (не вкладка настроек). | | Словарь расширенного режима ввода | Меню NVDA → Braille Essentials → Словарь расширенного режима ввода… (не вкладка настроек). | | В Интернете | Эта страница на GitHub или на сайте проекта, если вы читаете онлайн. |
.nvda-addon или из магазина дополнений NVDA, когда оно там появится).Braille Essentials является форком Braille Extender (см. ниже). Он включает большинство функций, описанных ниже, и имеет общую историю и код. Однако Braille Essentials разработан с учетом более новых версий NVDA, включая использование таких функций NVDA, как функция обновления дополнений из магазина дополнений и поддержка тегов форматирования документов, предоставляемых NVDA.
Из документации Braille Extender: Braille Extender когда-то охватывал многое из того, что NVDA еще не умела делать в braille. Первый публичный выпуск состоялся в августе 2017 года, в ту же неделю, что и NVDA 2017.3, версия, которая лучше всего соответствует тому моменту времени.
Собственные Настройки → Брайль (и связанные панели) NVDA с тех пор приобрели опции, на которые многие люди полагались в дополнении. Braille Essentials все еще добавляет дополнительное поведение; проверьте примечания к выпускам NVDA, если вам нужна точная формулировка для каждого пункта ниже.
| Из Braille Essentials | Теперь в ядре NVDA (кратко) |
|-----------|----------------------------|
| 2022.3 | Прерывание речи при прокрутке брайлевского дисплея. |
| 2024.2 | NVDA+Alt+t переключает режим брайля; добавлен новый режим отображения речевого вывода (брайль зеркалирует то, что говорит NVDA). |
| 2024.3 | Нормализация Юникода для речи и брайля; пользовательские брайлевские таблицы из дополнений и папки scratchpad NVDA. Braille Essentials может добавлять свои собственные таблицы и использовать таблицы из других дополнений, а не только из встроенного списка NVDA. |
| 2024.4 | Озвучивание символа при маршрутизации в тексте; больше вариантов форматирования в брайле (например, теги); начало абзаца в брайле при чтении по абзацам; исправления маршрутизации. |
| 2025.1 | Таблицы ввода и вывода могут следовать за языком интерфейса NVDA; озвучивание строки или абзаца при использовании клавиш навигации по брайлю. |
| 2026.1 | Количество элементов списка и ошибки орфографии и грамматики отображаются в брайле. |
| 2026.2 | Добавлена автоматическая прокрутка брайля, включая настройку скорости прокрутки в процентах. |
Они соответствуют вкладкам в Настройках Braille Essentials:
| Категория | Краткое описание | |----------|---------| | Общие | Озвучивание текущей строки при прокрутке, пропуск пустых строк, "умный" Caps Lock, обратная связь по модификаторам/громкости, два избранных дисплея и их перезагрузка, поля, реверсивная прокрутка, табуляция пробелами, терминалы (брайль следует за обзором), поведение маршрутизации курсора, объявление символа при маршрутизации (пока NVDA не обработает это), пост-выходная таблица, быстрые запуски. | | Ротор | Какие элементы ротора существуют и их порядок. | | Автопрокрутка | Задержки и поведение для автоматической прокрутки брайля. | | Режим истории речи | Длина истории, нумерация, опциональное озвучивание при просмотре истории. | | Форматирование документа | Как форматирование (жирный шрифт, ссылки, выравнивание, …) отображается в брайле, в дополнение к форматированию документов NVDA (см. Подробные темы). | | Excel | Отображение значений ячеек и формул в брайле; опциональный обзор строки или столбца с помощью маршрутизации (см. Excel). | | Представление объектов | Порядок имени, состояния, значения и других полей в строке фокуса; выделение выбора точками 7/8; сообщения индикатора выполнения на дисплее. | | Брайлевские таблицы | Предпочтительные списки таблиц ввода/вывода, опциональные автоматические таблицы в NVDA 2025.1+, таблица быстрого ввода, второй проход трансляции, табуляция пробелами, Управление пользовательскими брайлевскими таблицами… (NVDA 2024.3+). | | Представление неопределенных символов | Как символы, отсутствующие в таблице, отображаются (точки, числа, описания, HUC, …). | | Расширенный режим ввода | Символ выхода и выход после одного символа (словарь сокращений находится в отдельном диалоговом окне меню — см. Документация в NVDA). | | Одноручный режим | Включение и выбор одного из трех методов одноручного ввода. | | Метки ролей | Пользовательские брайлевские метки для ролей, ориентиров и состояний. | | Дополнительно | Исправление позиции курсора для символов вариативных селекторов; обновление брайля при изменении имени объекта переднего плана. |
Словари таблиц (не вкладки настроек)
Три уровня работают вместе: Глобальный (применяется ко всем таблицам), Таблицы (для текущей выходной таблицы) и Временный (кратковременные переопределения до перезапуска NVDA). Если файл словаря содержит ошибки, этот уровень пропускается до тех пор, пока вы не исправите его.
Откройте Меню NVDA → Braille Essentials → Словари таблиц → Глобальный словарь, Словарь таблицы или Временный словарь.
Braille Essentials может хранить и использовать ваши собственные брайлевские таблицы, когда вы выбираете их в менеджере. Они применяются к вводу и выводу брайля через дополнение (не через NVDA → Настройки → Брайль или списки ротации таблиц дополнения).
Требование: Файлы таблиц должны быть .utb, .ctb или .tbl (не вспомогательные файлы, такие как .cti или .dis).
Где открыть менеджер
| Местоположение | Использование | |----------|-----| | Меню NVDA → Braille Essentials → Пользовательские брайлевские таблицы… | Выделенный диалог (список и все действия). | | Настройки Braille Essentials → Брайлевские таблицы → Управление пользовательскими брайлевскими таблицами… | Открывает тот же диалог. |
Что вы можете делать
| Действие | Описание |
|--------|-------------|
| Добавить… | Копировать из существующей таблицы или создать пустую таблицу с минимальным стартовым файлом правил. Список копирования включает встроенные таблицы NVDA, таблицы других дополнений и таблицы, уже сохраненные Braille Essentials. Установите отображаемое имя, сокращенную форму и флаги ввода/вывода в следующем диалоге. |
| Удалить | Удаляет метаданные и сохраненный файл .utb / .ctb / .tbl после подтверждения. |
| Редактировать… | Открывает файл таблицы в вашем редакторе по умолчанию (в папке хранения пользовательских данных ниже). |
| Свойства… | Измените отображаемое имя, сокращенную форму и то, используется ли таблица для ввода и/или вывода. |
Чтобы клонировать пользовательскую таблицу, которой вы уже управляете, используйте Добавить… → Копировать из существующей таблицы и выберите ее из списка (то же отображаемое имя, что и в списке пользовательских таблиц).
Диалог добавления
.utb, .ctb или .tbl)..utb или .ctb, если вы отметили таблицу как сокращенную на шаге свойств.Выбор пользовательской таблицы для использования
В верхней части диалога пользовательских брайлевских таблиц:
| Элемент управления | Эффект | |---------|--------| | Активная пользовательская таблица ввода | Нет (по умолчанию) использует вашу обычную таблицу ввода NVDA. Выберите пользовательскую таблицу, чтобы использовать ее для ввода с брайля. | | Активная пользовательская таблица вывода | Нет использует вашу обычную таблицу вывода NVDA. Выберите пользовательскую таблицу, чтобы использовать ее для трансляции в брайль. |
Только таблицы, которые вы выбираете здесь, активны. Они не появляются в NVDA → Настройки → Брайль или в списках ротации таблиц Braille Essentials, поэтому NVDA все равно может нормально запускаться, если дополнение не загружено.
Нажмите OK, чтобы применить ваш выбор. Чтобы прекратить использование пользовательских таблиц, установите оба списка в Нет (файлы сохраняются). Чтобы окончательно удалить таблицы, используйте Удалить в менеджере.
Хранение
Файлы таблиц и небольшой файл настроек сохраняются в вашей папке конфигурации пользователя NVDA (Меню NVDA → Параметры → Общие → Открыть каталог конфигурации пользователя NVDA), в папке brailleEssentials\customBrailleTables\.
После добавления, удаления или изменения таблиц брайль обновляется немедленно.
Использование пользовательских таблиц в повседневной работе
Если вы отключите дополнение
Ваш выбор пользовательской таблицы сохраняется в собственных настройках Braille Essentials, поэтому настройки брайля NVDA остаются на безопасной встроенной таблице. Когда вы снова включите дополнение, ваш выбор вернется.
Таблицы из других дополнений (NVDA 2024.3+)
Вам не нужно копировать таблицу в папку Braille Essentials. Таблицы из другого дополнения (например, Экспериментальные брайлевские таблицы) или из scratchpad NVDA работают как встроенные таблицы: добавьте их в свои списки ротации, переключайтесь на них с помощью команд таблиц или используйте их в качестве дополнительного прохода вывода. В NVDA 2024.1–2024.2 поддерживаются только встроенные таблицы NVDA.
Если файл таблицы отсутствует
Дополнение переключается на безопасную таблицу, где это возможно, и очищает поврежденные записи из ваших списков, чтобы брайль продолжал работать.
Braille Essentials не заменяет диалог Форматирование документа NVDA. Вкладка настроек Форматирование документа добавляет отдельный брайлевский слой:
В NVDA 2024.4+ в NVDA также есть глобальные опции форматирования брайля; эта вкладка остается построчным управлением дополнения.
Эта вкладка изменяет то, что отображается на брайлевском дисплее, когда NVDA показывает один объект за раз — сводную строку для элемента с фокусом (кнопка, ссылка, ячейка таблицы и т.п.). Это не изменяет то, как NVDA озвучивает информацию об объекте; используйте Настройки → Представление объектов NVDA для речевых опций.
Откройте Представление объектов → Порядок свойств… чтобы установить какие части идут первыми, читая слева направо на дисплее. Части без содержимого для текущего объекта пропускаются.
Вы можете изменить порядок этих полей (метки соответствуют диалогу):
3/10 в брайле, не "3 из 10")lv 2)Сбросить к порядку NVDA по умолчанию — тот же порядок, что и в NVDA без этого дополнения (имя, затем значение, состояние, текст роли и т.д.).
Сбросить к порядку дополнения по умолчанию — помещает состояние и координаты ячейки перед именем (по умолчанию для новых профилей).
Что все еще следует за NVDA
Заголовки строк и столбцов из приложения все еще могут добавляться после основной сводки, когда доступны.
Выбранные элементы управляет тем, как выбранный элемент отмечается в этой сводной строке объекта:
| Выбор | Эффект | |--------|--------| | ничего | Нет дополнительной отметки от этого дополнения | | точка 7, точка 8 или точки 7 и 8 | Добавляет точки 7 и/или 8 к брайлевским ячейкам, составляющим имя объекта | | теги | Не рисует символы тегов на имени; влияет только на текст состояния, как описано ниже |
Когда выбор не "ничего" и объект имеет имя, слова выбран и выбираемый опускаются из текста состояния, чтобы вам не сообщали "выбран" дважды. Выделение внутри текущего текста по-прежнему следует за собственной настройкой NVDA показывать выделение.
Когда значение индикатора выполнения изменяется, дополнение может показывать короткое сообщение на брайлевском дисплее (речь не изменяется — используйте Настройки → Представление объектов → Обновления индикатора выполнения NVDA для речевых опций):
| Опция | Что вы видите | |--------|----------------| | отключено (исходное поведение) | Нет дополнительных брайлевских сообщений от этого дополнения | | включено, показывать сырое значение | Текст значения индикатора (по умолчанию) | | включено, показывать индикатор выполнения с помощью ⣿ | Ряд заполненных ячеек по ширине дисплея, длина основана на проценте |
Три варианта (Следовать форматированию документа NVDA, включено, отключено) используют ту же формулировку, что и на вкладке Форматирование документа, но здесь они определяют только для каких окон индикаторы выполнения могут запускать вышеуказанные брайлевские сообщения:
| Выбор | Эффект | |--------|--------| | Следовать форматированию документа NVDA | Следует за настройкой NVDA Сообщать о фоновых индикаторах выполнения или показывает индикаторы в окне, в котором вы работаете | | включено | Индикаторы выполнения в фоновых и передних окнах | | отключено | Только индикаторы выполнения в окне переднего плана |
Символы, не определенные в активной выходной таблице (включая многие эмодзи), используют выбранный метод: использовать поведение брайлевской таблицы, полную ячейку 1–8 или 1–6, пусто, пользовательский шаблон точек (например, 6-123456), вопросительный знак, пользовательский знак (например, ??), шестнадцатеричный (стиль таблицы, HUC8, HUC6), десятичный, восьмеричный, двоичный.
Описания: опциональное описание символа, расширенное описание, полное расширенное, опциональная строка размера, опциональные данные Юникода как последнее средство и список исключений (коды символов или диапазоны), чтобы описание пропускалось для диапазонов, которые вы считаете шумными.
Приоритет: правила таблицы и словари таблиц имеют приоритет над описаниями; описания имеют приоритет над общим шаблоном для неопределенных символов.
Подробнее о HUC: danielmayr.at/huc
Вкладка настроек: escape-символ для числового/юникодного ввода и выход после одного символа.
Диалог меню: Меню NVDA → Braille Essentials → Словарь расширенного режима ввода… — записи сокращений для каждой таблицы ввода (отдельно от словарей таблиц).
Переключение расширенного ввода (сочетания по умолчанию включают NVDA+Windows+i или ⡊+пробел). В активном состоянии:
Ввод HUC6 не реализован.
| Символ | HUC8 | Hex | Decimal | Octal | Binary | |-----------|------|-----|---------|-------|--------| | 👍 большой палец вверх | ⣭⢤⡙ | 1F44D | 128077 | 372115 | 11111010001001101 | | 😀 улыбающееся лицо | ⣭⡤⣺ | 1F600 | 128512 | 373000 | 11111011000000000 | | 🍑 персик | ⣭⠤⠕ | 1F351 | 127825 | 371521 | 11111001101010001 | | 🌊 волна | ⣭⠤⠺ | 1F30A | 127754 | 371412 | 11111001100001010 |
Составление ячейки в несколько шагов — полезно, если вы печатаете одной рукой. В Настройках Braille Essentials три метода появляются в этом порядке: Заполнить ячейку в два этапа, используя только одну сторону, Заполнить ячейку в два этапа, используя обе стороны, Заполнить ячейку точка за точкой. Переключите одноручный режим с помощью NVDA+Windows+h (часто ⡂+пробел на поддерживаемых дисплеях). Если сохраненный метод неизвестен, дополнение произносит не поддерживается и очищает частично набранную ячейку.
Первый шаг: точки 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 циклически переключает свои режимы брайля, включая дисплей vs речевой вывод. Это по-прежнему не является отдельным списком истории речи и рабочим процессом маршрутизации Braille Essentials.Что вместо этого делает Braille Essentials
Пока Режим истории речи включен, дополнение записывает то, что говорит NVDA, как строки простого текста, которые вы можете просматривать, использует прокрутку строк на дисплее для перемещения по этому списку и переключает брайлевскую строку для отображения этих строк вместо обычного текста фокуса или обзора. Выключение режима возвращает брайль в обычное состояние и обновляет дисплей.
NVDA+Alt+t, если только вы не хотите заменить команду NVDA переключения режима брайля на эту клавишу.# и номер записи (с ведущими нулями, чтобы все числа имели одинаковую ширину), затем : и текст — например #3: или #0003: в зависимости от вашего лимита истории.Ротор переключает активную категорию быстрой навигации / обзора. Категории включают навигацию по тексту, выделение, объект/обзор, ссылки (посещенные/непосещенные), ориентиры, заголовки (по уровням), списки, элементы управления форм, таблицы, одинаковое/разное форматирование, списки таблиц ввода/вывода и многое другое.
Когда автопрокрутка включена, дисплей продвигается сам по таймеру, пока вы остаетесь в обычном брайлевском представлении. Если вы переключаетесь на другое представление (например, историю речи), автопрокрутка приостанавливается до вашего возвращения.
Когда установлен флажок Использовать пользовательские метки ролей, вы можете редактировать метки для ролей, ориентиров и положительных/отрицательных состояний на каждом языке на этой панели (хранятся с другими вашими настройками Braille Essentials). Когда флажок снят, применяются метки NVDA по умолчанию.
Сообщения об ошибках, предложения и запросы на включение изменений приветствуются на GitHub — BrailleExtender. Если вы изменяете видимый пользователю текст или поведение, пожалуйста, обновите это руководство и любые ваши переводы, чтобы все были в курсе.
Если вы работаете над исходным кодом, шаги сборки и инструменты разработчика описаны в репозитории на GitHub (не в этом руководстве пользователя).
Спасибо также Daniel Cotto, Daniel Mayr, Dawid Pieper, Corentin, Louis и всем, кто сообщал об отзывах.