Документация дополнения SpeakDecoratedText

Дополнение SpeakDecoratedText улучшает работу скринридера NVDA, преобразуя декорированный или сложный текст в упрощённый ASCII-текст для более лёгкого чтения и копирования. Также включает функции для очистки арабского текста и управления историей преобразований.

Возможности

• Преобразование декорированного текста в простой ASCII с копированием в буфер обмена. Это особенно важно, поскольку текст с нестандартными символами Unicode по умолчанию плохо читается в NVDA.
• Очистка арабского текста с копированием результата в буфер обмена.
• Восстановление ранее преобразованных текстов из истории с помощью повторных команд.

Горячие клавиши (жесты)

• NVDA + Shift + Z:
  Однократное нажатие — озвучивание преобразованного текста скринридером.
  Двойное быстрое нажатие — копирование последнего преобразованного текста в буфер обмена.

• NVDA + Shift + A:
  Очистка выделенного арабского текста с копированием в буфер обмена. Улучшает читаемость, удаляя диакритики и декоративные символы.

• NVDA + Shift + H:
  Восстановление ранее преобразованных текстов (повторные нажатия позволяют вернуться дальше в истории).

Принцип работы

Дополнение использует библиотеку anyascii для транслитерации декорированных или не-ASCII символов в их ASCII-эквиваленты.
Для арабского текста применяется пользовательская функция нормализации (decoratedarabic.normalize_text), очищающая и упрощающая текст.

Примечание: Библиотека anyascii требуется и автоматически включается в папку дополнения.

Обзор реализации

class GlobalPlugin(globalPluginHandler.GlobalPlugin):
  # Хранит краткую историю преобразованных текстов (до 3).
  # Использует проверку времени для определения повторных нажатий клавиш.
  # Копирует преобразованный или очищенный текст напрямую в буфер обмена.
  # Обеспечивает обратную связь через интерфейс NVDA.

## Советы по использованию

  * Используйте сочетание для преобразования дважды быстро (в течение 0,5 секунды), чтобы повторно скопировать текст.

  * Нажимайте сочетание для восстановления несколько раз, чтобы перемещаться по недавним преобразованиям.

  * Убедитесь, что текст выделен или курсор обзора находится на целевом тексте перед использованием горячих клавиш.  
Работает на веб-сайтах и в Microsoft Word в режиме обзора.

## Используемые библиотеки

Библиотека| Назначение  
---|---  
`globalPluginHandler`| Регистрация дополнения как Global Plugin в системе
плагинов NVDA  
`ui`| Отображение сообщений и обратной связи через интерфейс NVDA  
`sys`| Изменение `sys.path` для импорта локальных модулей и библиотеки
`anyascii`  
`os`| Работа с путями к файлам для папки дополнения  
`time`| Измерение времени между нажатиями для распознавания жестов  
`re`| Поиск и замена символов с использованием шаблонов  
`unicodedata`| Нормализация и очистка текста от декораций  
`api`| Доступ к функциям NVDA и копированию в буфер обмена  
`from scriptHandler import script`| Определение скриптов как горячих клавиш
NVDA  

## Контакты и поддержка

  * 💻 **Репозиторий GitHub** :  
[SpeakDecoratedText на
GitHub](https://github.com/Abdullahashraf32/SpeakDecoratedText)

  * 📧 **Email** :  
[abdullahashraf4846@gmail.com](https://mailto:abdullahashraf4846@gmail.com/)

  * **WhatsApp** :  
[Связаться через WhatsApp](https://wa.me/+201148467527)

  * **Telegram** :  
[@abdullahashraf4846](https://t.me/abdullahashraf4846)

  * **YouTube-канал** :  
[Abdullah Ashraf на YouTube](https://www.youtube.com/@AbdullahAshraf-zc5dx)

• SpeakDecoratedText-V.1.1.nvda-addon