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

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

Возможности

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 💻 Репозиторий GitHub :
  SpeakDecoratedText на
  GitHub

• 📧 Email :
  abdullahashraf4846@gmail.com

• WhatsApp :
  Связаться через WhatsApp

• Telegram :
  @abdullahashraf4846

• YouTube-канал :
  Abdullah Ashraf на YouTube