Помощник по вводу Брайля

Версия 2.4

Введение

Braille IME Helper (BrlIMEHelper) позволяет пользователям вводить китайские иероглифы непосредственно с клавиатуры Брайля на брайлевский дисплей. При отсутствии клавиатуры Брайля аддон также может имитировать ее с помощью компьютерной клавиатуры. Благодаря тому, что аддон преобразует брайлевский ввод в IME-операции, пользователи, знакомые с правилами Брайля, могут вводить китайские иероглифы без изучения других методов ввода и раскладок клавиатуры. На данный момент аддон представляет собой реализацию, основанную на bopomofo braille и 微軟注音 IME, широко используемых на Тайване, и в будущем его концепция может быть расширена на другие системы Брайля и IME.

Характеристики

1. Ввод китайского языка (включая пунктуацию и математические символы) через клавиатуру Брайля.
2. Имитация клавиатуры Брайля компьютерной клавиатурой.
3. Разрешение использования системных и NVDA клавиатурных сокращений.
4. Различные режимы работы со шрифтом Брайля для разных окон.
5. Разрешение ввода пароля в веб-браузере с помощью клавиатуры Брайля.
6. Различные варианты настройки по отзывам пользователей.

Требования к системе и окружению

Перед установкой проверьте следующие параметры среды:

• NVDA 2017.3 или более поздняя версия.
• IME должен быть правильно настроен, подробности представлены в следующем параграфе.
• Если вы хотите имитировать клавиатуру Брайля с помощью компьютерной клавиатуры, проверьте, поддерживает ли она NKRO (N-key rollover). См. также: Какие клавиатуры ПК позволяют вводить данные по Брайлю 6-ю клавишами?
• Пожалуйста, не допускайте работы Braille IME Helper с другими приложениями или аддонами, связанными с вводом данных по Брайлю, такими как аддон PC Keyboard Braille Input for NVDA и аддон Braille Chewing.
• Рекомендуется отключить опцию "Сообщать об изменениях в строке чтения" в настройках композиции ввода NVDA, чтобы получить больше удовольствия от быстрого набора текста.
• Рекомендуется установить для таблицы ввода Брайля значение "English (U.S.) 8 dot computer braille", чтобы поведение NVDA было ближе к привычному для тайваньских пользователей.

В данном аддоне предполагается, что пользователь настроит IME следующим образом, но он также может изменить соответствующие параметры в зависимости от обстоятельств.

Манипуляции

Жесты

В аддоне предусмотрены жесты для работы как с компьютерной клавиатурой, так и с клавиатурой Брайля. Перед введением ознакомьтесь со следующими терминами:

1. Компьютерная клавиатура: Состоит из основной и цифровой клавиатуры. Названия ее клавиш в данном разделе заключены в скобки.
2. Клавиши Брайля: 9 клавиш, сопоставленных с точками 1-8 и пробелом Брайля. В соответствии с правилами, заданными таблицей перевода ввода, пользователь может набирать с их помощью символы.
3. Клавиатура Брайля: Физическая брайлевская клавиатура, состоящая из 9 брайлевских клавиш, обычно входит в состав брайлевского дисплея. Однако аддон также предлагает виртуальную клавиатуру Брайля, эмулируемую компьютерной клавиатурой, что облегчает работу пользователей, предпочитающих брайлевский ввод.
4. Шаблон Брайля: Внешний вид строки ячеек шрифта Брайля. Более четко это означает, из каких точек состоит ячейка (ячейки).

Общий режим ввода

Общий режим ввода также помогает пользователю, особенно знакомому с клавиатурой компьютера, но не адаптировавшемуся к отображению клавиатуры IME, набирать текст по Брайлю. Его отличие от режима ввода по Брайлю заключается в соответствии между клавишами и брайлевскими рисунками. Клавише (с Shift или без него) соответствует брайлевский шаблон, который определяется таблицей перевода OUTPUT. Приведем два примера, чтобы читатель мог понять, как он используется и действует.

Пример 1:

1. Установите для выходной таблицы перевода и входной таблицы перевода значения "Китайский (Тайвань, Мандарин)" и "Шрифт Брайля Юникод" соответственно.
2. В общем режиме ввода переключите 微軟注音 в режим алфавитно-цифрового ввода.
3. На элементе управления редактированием наберите любой текст, как будто эмуляция клавиатуры Брайля не запущена.

После выполнения этих трех действий вы обнаружите, что брайлевский шаблон выходного текста совпадает с вашими входными символами, но на самом деле текст состоит из символов Брайля Unicode, которые показывают процесс вашего брайлевского ввода. То есть, если в таблице трансляции входного текста не стоит "Unicode braille", то перед выводом эти символы Unicode braille будут переведены обратно в обычные буквенно-цифровые символы.

Пример 2: (пока не реализован)

1. Установить для выходной таблицы перевода значение "Китайский (Тайвань, Мандарин)" без ограничения входной таблицы перевода.
2. В общем режиме ввода переключить 微軟注音 в режим ввода "родной".
3. На пульте управления наберите 5 символов следующим образом: a&'=1

После выполнения этих трех действий в окне композиции отобразится 中文 или другие китайские иероглифы, читаемые как ㄓㄨㄥㄨㄣˊ. То есть шрифт Брайля для a&'=1 имеет вид ⠁⠯⠄⠿⠂, что совпадает со шрифтом 中文.

Некоторые пользователи привыкли вводить шрифт Брайля, но недостаточная гибкость суставов пальцев заставляет их допускать множество ошибок в процессе работы с физической клавиатурой Брайля или режимом ввода Брайля. В конструкции общего режима ввода сделана попытка облегчить им процесс ввода. Прикасаясь к ячейкам Брайля, читатель обычно думает не о количестве точек, а о символах, которые они обозначают. И наоборот, пользователю так же легко выразить нужные ячейки Брайля символами. В этом режиме аддон переводит нажатия клавиш компьютерной клавиатуры в сообщения брайлевского ввода в соответствии с текущей таблицей перевода брайлевского вывода. Например, "f" переводится в ⠋, что определяется текущей таблицей перевода Брайля. Тогда нажатие клавиши на клавиатуре компьютера, генерирующей строчную букву f, представляет собой брайлевский ввод ⠋. Другими словами, ввод буквы "f" с помощью компьютерной клавиатуры эквивалентен одновременному нажатию точек 1, 2 и 4 на клавиатуре Брайля.

Как видно из пояснений к двум примерам, общий режим ввода не имеет эффекта в режиме алфавитно-цифрового ввода IME с обычной конфигурацией. Поэтому до версии 2.3 аддона он является расширением "Отключить имитацию клавиатуры Брайля в алфавитно-цифровом режиме IME".

Примечание: Способ генерации жеста Брайля в этом режиме аналогичен способу генерации жеста Брайля в режиме ввода, т.е. одновременное нажатие пробела Брайля и других точек от 1 до 8.

Замечание: Если при нажатии клавиши пробела не образуется пробел Брайля Unicode (⠀), то это связано с ошибкой старых версий NVDA. Пожалуйста, обновите NVDA для устранения этой проблемы.

Способ ввода "точка за точкой

Способ ввода "точка за точкой" не зависит от двух других режимов эмуляции клавиатуры Брайля. Если он включен, то пользователь может вводить номера точек каждой ячейки Брайля с помощью нумпада при включенной Num Lock. Например, [1][2][.] [1][2][3][5][.] [1][2][3][.] приводит к тому, что в текстовом редакторе отображается "brl". Функции клавиш нумпада представлены кратким описанием в начале этого раздела. Манера позволяет пользователю передавать брайлевские жесты, состоящие более чем из 6 точек (или пробелов), независимо от физических ограничений компьютерной клавиатуры.

Жесты Брайля

Жест Брайля состоит из пробела и другой точки (точек) Брайля. Он позволяет пользователю выполнить определенную функцию или эмулировать нажатие клавиши на клавиатуре Брайля. С помощью таких жестов Брайля пользователь может уменьшить вероятность отведения рук от клавиш Брайля, что повышает эффективность работы.

В последующих двух подразделах представлены жесты Брайля. В первом подразделе описаны некоторые распространенные жесты Брайля и рекомендации по их быстрому запоминанию. Во втором подразделе приведена таблица, в которой перечислены все жесты Брайля, определяемые данным аддоном. Отметим, что жесты Брайля, выполняющие функции BrlIMEHelper, доступны как для физической, так и для виртуальной клавиатуры Брайля, однако другие жесты Брайля могут быть использованы только для виртуальной клавиатуры Брайля.

Для упрощения дальнейшего содержания раздела жест Брайля описывается только его брайлевской точкой (точками), без упоминания брайлевского пробела.

Предупреждение о совместимости: В NVDA версий ранее 2018.3 запрещен ввод шрифта Брайля из "No braille", поэтому источником жестов, предоставляемых аддоном, является "клавиатура Брайля". Если запущенный драйвер дисплея Брайля не определяет такой жест, то ввод Брайля, генерируемый его физической клавиатурой Брайля, может привести к их выполнению, чего не происходит в более новых версиях NVDA.

Распространенные жесты, написанные шрифтом Брайля

Функции BrlIMEHelper

То, что пользователь просто вводит в режиме встроенного ввода, сохраняется в буфере шрифта Брайля до завершения композиции. Например, 135 126 недостаточно для композиции, но проверка буфера брайля показывает, что был введен ㄅㄛ.

2, 4, 5 + пробел дает дополнительный эффект. Это заставляет NVDA отклонять сообщение шрифтом Брайля без обновления любого контрольного содержимого.

После нажатия точек 1, 3, 6 + пробел таблица перевода ввода шрифтом Брайля немедленно становится "Unicode braille". Следующее нажатие позволит ей стать исходной таблицей, выбранной пользователем. Однако, если исходной таблицей перевода ввода шрифтом Брайля является "Unicode braille", то она станет "Английский (АМЕРИКАНСКИЙ) компьютерный шрифт Брайля с 8 точками".

Редактирование документа

Система Windows Сочетания клавиш

Операции NVDA

Все жесты Брайля

Здесь приведена таблица, в которой перечислены все поддерживаемые жесты Брайля.

Прежде чем приступить к работе, отметим, что функции большинства жестов Брайля могут быть вызваны точками 7 и 8. Точка 7 означает, что эмулируемое сочетание клавиш содержит [Ctrl], либо является одной из функциональных клавиш от [F1] до [F12]. Точка 8 означает, что эмулируемое сочетание клавиш содержит либо клавишу [Alt], либо клавишу [NVDA]. Обе точки 7 и 8 означают, что эмулируемое сочетание клавиш содержит одну из [Ctrl]+[Alt] и [Win]. В любом случае, правильное понимание принципа построения поможет читателю быстро запомнить множество брайлевских жестов.

Оригинальное предложение по дизайну на китайском языке доступно в сообщении №3664 группы nvda-tw.

Функции без предопределенного жеста ввода

Заставьте NVDA показывать текущее сообщение Брайля бесконечно долго.

Большинство пользователей настраивают NVDA на автоматическое удаление текущего сообщения Брайля в течение нескольких секунд. Если необходимо внимательно прочитать какое-либо сообщение, то пользователь может выполнить эту функцию с помощью предопределенного жеста ввода. При этом сообщение останется на брайлевском дисплее, как если бы в настройках предпочтений NVDA был установлен флажок "Показывать бесконечно". Таким образом, предлагается привязать функцию к удобному жесту, который может быть выполнен в течение нескольких секунд.

Опции

Автоматически включать имитацию клавиатуры Брайля при запуске NVDA

Если флажок установлен, то имитация клавиатуры Брайля включается автоматически при запуске NVDA.

Сочетание клавиш для переключения алфавитно-цифрового/нативного ввода IME.

Определяет ключевую команду, посылаемую аддоном, когда пользователь нажимает точки 4, 5 и 6 вместе с пробелом Брайля. Для сохранения единообразия поведения по умолчанию используется левый шифт.

Примечание: Пользователи Windows XP, если вы хотите использовать [Ctrl]+[Space] для переключения между 美式鍵盤 и 新注音, пожалуйста, настройте режим ввода по умолчанию 新注音 на "родной" ввод.

Использовать режим ASCII по умолчанию при алфавитно-цифровом вводе IME.

Опция является расширением опции "Отключить имитацию клавиатуры Брайля по умолчанию в алфавитно-цифровом режиме IME" версии, более ранней, чем 2.3. Если флажок установлен, то по умолчанию при алфавитно-цифровом вводе IME эмулируется клавиатура Брайля в режиме ASCII. Подробнее о режимах см. раздел "Компьютерная клавиатура" спецификации жеста.

"Клавиши Брайля" и "Игнорируемые клавиши".

В диалоге настроек BrlIMEHelper пользователь может определить положение точек Брайля, пробелов Брайля и игнорируемых (зарезервированных) клавиш для имитации клавиатуры Брайля. Имитация клавиатуры Брайля автоматически отключается, если один из элементов управления "Клавиши Брайля" или "Игнорируемые клавиши" находится в фокусе. Требуется указать ровно 9 клавиш Брайля, а количество игнорируемых клавиш не ограничено. Если клавиша присутствует в обоих вариантах, то приоритет отдается "Клавишам Брайля". После ввода всех позиций клавиш одним нажатием клавиш компьютерной клавиатуры необходимо нажать кнопку [Apply] или [OK] для вступления в силу. Иногда опция "Клавиши Брайля" может работать не полностью, так как одновременная передача некоторых ключевых команд не поддерживается внутренним устройством клавиатуры компьютера (или ноутбука). Пожалуйста, измените конфигурацию, чтобы найти подходящий набор брайлевских клавиш.

Освободить все небрайлевские клавиши при имитации клавиатуры Брайля в режиме алфавитно-цифрового ввода IME.

Если флажок установлен, то все клавиши, кроме клавиш Брайля, игнорируются при имитации клавиатуры Брайля в режиме алфавитно-цифрового ввода IME.

Сопоставление клавиатур

Опция соответствует настройке раскладки клавиатуры в режиме ввода IME native.

Разрешить точечный ввод Брайля через нумпад при имитации клавиатуры Брайля

Если флажок установлен, пользователь может вводить ячейки Брайля точка за точкой с помощью нумпада при включенной Num Lock.

Индикация ручного/автоматического переключения имитации клавиатуры Брайля

Эти две опции определяют индикацию переключения имитации клавиатуры Брайля. В частности, автоматическое переключение может происходить после смены окна переднего плана и/или опций аддона.

Единое состояние переключения имитации клавиатуры Брайля для всех процессов

Если флажок установлен, то состояние тумблера имитации клавиатуры Брайля будет только одно, что соответствует поведению всех версий ранее 2.0. В противном случае аддон регистрирует состояние каждого процесса независимо. Пользователь, разрешающий использовать разные IME для разных окон, может снять флажок с этой опции, чтобы сократить время переключения имитации клавиатуры Брайля. Обратите внимание, что все состояния переключения процессов становятся состоянием по умолчанию при запуске NVDA, если эта опция изменена с не отмеченной на отмеченную.

Поведение имитируемой клавиатуры Брайля

Клавиатура компьютера может эмулировать ввод шрифта Брайля как с текущего рабочего дисплея Брайля, так и с дисплея "Нет Брайля". При возникновении конфликта приоритет определяется этой опцией. По умолчанию приоритет имеют жесты, предоставляемые аддоном.

Формат для копирования содержимого брайлевского дисплея

Формат Брайля, включая Unicode Braille Pattern, Braille ASCII и North American Braille Computer Code (NABCC), копируемого содержимого брайлевского дисплея.

• Unicode Braille Pattern: Набор символов, которые отображаются в виде 8 точек Брайля.
• Braille ASCII: Формат файлов брайлевских документов с расширением .brf.
• North American Braille Computer Code (NABCC): См. справочную веб-страницу. Обратите внимание, что успешно скопировать можно только те образцы Брайля, которые соответствуют символам от 0 до 127.

Замечания

1. В режиме алфавитно-цифрового ввода IME эффект ввода Брайля определяется таблицей перевода ввода Брайля NVDA.
2. Оригинальное поведение NVDA для точек 7, 8 и 7 + 8 сохраняется в обоих режимах.
3. Аддон не влияет на другие кнопки брайлевского дисплея, такие как кнопки прокрутки и позиционирования.
4. Пользователи могут управлять всеми вышеперечисленными ярлыками через диалог ввода жестов NVDA и диалог настроек BrlIMEHelper.
5. Если после завершения композиции не произносится ни один составленный символ, то IME может застрять из-за необоснованного (фонетического) ввода.

Проблемы и пути развития

• Известные ошибки:
  • Шрифт Брайля NVDA не сразу отражается как пользовательский ввод в элементах управления редактированием "Клавиши Брайля" и "Игнорируемые клавиши".
  • При некоторых обстоятельствах аддон не может успешно обновить конфигурацию пользователя.
• Возможные улучшения в будущем:
  • Предоставить пользователям возможность настраивать состояние аддона по умолчанию.
  • Предоставить пользователям возможность настраивать точечные шаблоны символов и/или загружать точечные шаблоны из таблиц перевода Брайля.
  • Обеспечить работу аддона с другими IME.

Соавторы

• Bo-Cheng Jhan <school510587@yahoo.com.tw>
• 黃偉豪 <hurt.nzsmr@gmail.com>

Благодарность

• BrlIMEHelper был спонсирован Taiwan Visually Impaired People Association <vipastaiwan@gmail.com> с 2020/01/01 по 2021/12/31, настоящим выражаем нашу искреннюю благодарность.

История изменений

Версия 0.0

• Начальная версия.

Версия 0.1

• Рефакторинг документации, чтобы она стала более читаемой для пользователей.
• Сброс буфера Брайля при смене окна переднего плана.

Версия 0.2

• Исправлено неправильное поведение имитации точки 7 (A) в проводнике.
• Разделен init.py на два файла.

Версия 0.3

• Включена локализация сообщений.
• Реализована новая схема разбора шрифта Брайля.
• Добавлена информация о "addon_lastTestedNVDAVersion".
• Добавлены правила, обеспечивающие ввод одного символа bopomofo.
• Исправлено несколько шаблонов ввода математических символов.

Версия 0.4

• Реализована совместимость префиксов брайлевских шаблонов путем отложенной отправки ввода.
• Попытка замены последнего брайлевского ввода при отказе от брайлевского ввода.
• Заменен брайлевский шаблон ∠ на ⠫⠪ (1246-246), т.е. на префикс ←.

Версия 0.5

• Рефакторинг кода.
• Прекращена имитация клавиатуры Брайля клавиатурой компьютера в режиме просмотра.
• Присвоить каждому скрипту соответствующую документацию и категорию.

Версия 0.6

• Реализован тумблер для включения/выключения имитации ввода шрифта Брайля в буквенно-цифровом режиме IME.
• Обработка пути bopomofo.json в типе str.
• Не имитировать ввод шрифта Брайля, если при загрузке клавиатурных хуков BrlIMEHelper все еще удерживается какая-либо клавиша-модификатор.

Версия 0.7

• Добавлены точечные варианты некоторых символов.
• Обеспечена возможность управления ярлыками Брайля менеджером жестов ввода NVDA.
• Скорректирован стиль кодирования командных скриптов.

Версия 1.0

• Поддержка NVDA 2019.3 на базе Python 3.
• Реализован диалог для пользовательских настроек.

Версия 1.1

• Использован более корректный звуковой эффект для предупреждения об опечатке.
• Позволяет настраивать положение клавиш Брайля и игнорируемых клавиш на клавиатуре компьютера.
• Добавлена кнопка [Применить] в диалог настроек.

Версия 1.2

• Позволяет игнорировать все небрайлевские клавиши при имитации клавиатуры Брайля в алфавитно-цифровом режиме.
• Добавлена опция "Сопоставление клавиатуры", соответствующая опции сопоставления клавиатуры в 微軟注音 IME.
• Разрешить ввод рифм с префиксом ⡼ по Брайлю.

Версия 2.0

• Разрешен точечный ввод шрифта Брайля с помощью клавиш нумпада.
• Добавлены способы обратной связи - звуковой и без звукового сопровождения - для индикации переключения имитации клавиатуры Брайля.
• Разрешить независимое состояние тумблера имитации клавиатуры Брайля для каждого процесса.
• Изменена комбинация клавиш NVDA+X на NVDA+Ctrl+6.
• Добавить спецификацию всех опций в readme.md.
• Рефакторинг кода.

Версия 2.1

• Добавлены различные жесты Брайля для повышения эффективности работы пользователей, использующих виртуальную клавиатуру Брайля.
• Отказ от использования NVDA winVersion API во избежание проблем с совместимостью, вызванных обновлением API в NVDA 2021.1.
• Добавлена опция "Сочетание клавиш для переключения алфавитно-цифрового/нативного режима IME".
• Избежать предупреждения gettext в keyboard.py.
• Обновление файлов, полученных из AddonTemplate.
• Различные исправления и улучшения данной документации.

Версия 2.2

• Реализовано быстрое переключение между двумя таблицами перевода Брайля, оригинальной и Unicode Брайля, по точкам 1, 3, 6 + пробел.
• Разрешить ⡀ и ⢀ при вводе Unicode BRL с клавиатуры компьютера.
• Правильно удалять сообщения Брайля NVDA, даже если включена опция "Показывать сообщения бесконечно".
• Отказаться от устаревшего использования модуля "collections", вместо него использовать "collections.abc".
• Реализована функция "print screen" для брайлевского дисплея.

Версия 2.3

• Назначение различных сочетаний клавиш для двух режимов работы функции "копирование содержимого дисплея Брайля".
• Добавлена возможность заставить NVDA показывать текущее сообщение бесконечно долго без жеста по умолчанию.
• Загрузка клавиатурно-символьных отображений IME из JSON-файлов.
• При установке спрашивать пользователя, нужно ли автоматически менять таблицу перевода на "английский (американский) 8-точечный компьютерный шрифт Брайля".
• Принять новое правило для определения строки версии аддона.
• Дизайн брайлевского ввода и общих режимов ввода, а также реализация в IME алфавитно-цифрового ввода.

Версия 2.4

• Поддержка NVDA версии 2023.1.
• Добавлена опция "Формат для копирования содержимого брайлевского дисплея".
• Рефакторинг кода и разделение файлов данных и кода.
• Добавление модуля msctf, который может способствовать развитию последующих возможностей.

• BrlIMEHelper-V.2.4-2023.1.nvda-addon
• BrlIMEHelper-V.2.3-2022.2.nvda-addon
• BrlIMEHelper-V.2.2.nvda-addon