nvda-translate с DeepL

Заставьте NVDA переводить любой разговорный текст на нужный язык с помощью DeepL. Этот аддон в значительной степени основан на отличной работе Янника Плассиара. Хотя аддон вполне функционален, я - программист-хоббист, создающий вещи, которые нужны мне самому. Требуется значительная чистка кода.

ВАЖНО: ТРЕБУЕТСЯ API КЛЮЧ!

Если вы попытаетесь включить перевод, не указав действительный ключ API, с вами произойдут плохие вещи. Однако есть и хорошая новость: получить API-ключ можно бесплатно, доступно и просто. Требуется действительная кредитная карта, но это только для того, чтобы предотвратить создание нескольких учетных записей. Деньги с нее не будут сниматься без предупреждения. Чтобы получить ключ API:

• Посетите этот сайт.
• Нажмите кнопку с надписью «Зарегистрироваться бесплатно».
• Заполните адрес электронной почты, задайте пароль и введите данные кредитной карты (помните: с вас не будет взиматься плата).
• После создания учетной записи найдите вкладку «Учетная запись» и выберите ее.
• На этой странице должен появиться ключ авторизации. Скопируйте его в надежное место, он понадобится вам через минуту!

Установка

Это дополнение устанавливается так же, как и любое другое: Нажмите Enter на файле «translate-x.y.nvda-addon» и ответьте «Да» на все заданные вопросы. После перезапуска NVDA вам нужно ввести действительный ключ API, который вы получили в разделе выше. Для этого перейдите в диалог настроек NVDA (nvda+n, preferences, settings). Прокрутите список вниз и найдите раздел «Перевести». В этом разделе есть только одна опция: текстовое поле для ввода вашего DeepL API-ключа.

Использование

При первой установке дополнение определит язык, на котором установлена NVDA, или получит активный язык Windows в качестве запасного варианта. Этот язык будет использоваться для перевода любого разговорного текста, когда функция активирована. После ввода API-ключа в диалоге настроек NVDA и нажатия кнопки OK для его сохранения, при следующем открытии настроек станет доступно комбинированное поле «Код языка». Если DeepL не поддерживает ваш язык NVDA в качестве цели перевода, вы можете выбрать другой код языка из этого окна.

Затем, чтобы включить или отключить перевод, нажмите NVDA+Shift+Control+T. Этот жест можно изменить в меню NVDA Параметры -> Диалоговое окно Жесты ввода.

Жесты

Следующие жесты определены ( но могут быть изменены в диалоге Жесты ввода):

• NVDA+Shift+Control+T: Включает / выключает перевод.
• NVDA+Shift+F (дважды быстро): Очищает кэш для текущего приложения.
• NVDA+Shift+Control+F (дважды быстро): Очистка всех кэшей для всех переводов для всех приложений.

О кэше

Для повышения производительности (см. ниже) каждый переведенный текст хранится в файле кэша. Файл кэша создается для каждого приложения, в котором был активирован перевод, и находится в директории «translation-cache» в каталоге пользовательской конфигурации NVDA.

Как это работает

Когда дополнение активировано, оно перехватывает любой произнесенный текст и подключается к системе DeepL, чтобы перевести его на нужный язык. Это означает, что можно перевести любой текст, от любого приложения или игры, использующей NVDA для произнесения текста, до веб-сайтов.

Конфиденциальность

Пожалуйста, имейте в виду, что когда функция активна, любой произнесенный текст отправляется на сервис DeepL. Это означает, что будет отправлена любая произнесенная информация, что бы это ни было (простое предложение, имена файлов в проводнике Windows, содержимое почты, контакты, номера телефонов или даже номера кредитных карт). Поэтому важно активировать эту функцию только тогда, когда вы точно знаете, какой текст будет произносить ваш NVDA. Этот модуль разрабатывался в первую очередь для использования в играх, поэтому никаких проблем с конфиденциальностью не возникает. Вы можете использовать его с чем угодно, но на свой страх и риск.

О производительности

Вы можете заметить, что когда функция активна, между каждым произнесенным текстом есть задержка. Это связано с API перевода: поскольку дополнение должно подключаться к серверам DeepL через Интернет, каждый раз, когда текст должен быть переведен, устанавливается HTTP-соединение. Поэтому для корректной работы этой функции рекомендуется подключение к Интернету на скорости 8 мбит/с. Конечно, чем больше пропускная способность, тем быстрее будет происходить перевод. Кроме того, приобретение pro-аккаунта на сайте DeepL (за семь долларов в месяц) может привести к ускорению перевода.

Контакты и сообщения об ошибках

• Если вы столкнулись с какой-либо проблемой при использовании этого дополнения, пожалуйста, создайте проблему на GitHub, чтобы ее можно было легко отследить.
• Конечно, Pull Requests также приветствуются, если вы хотите расширить дополнение или исправить какую-либо проблему.
• Чтобы связаться со мной, вы можете использовать адрес: contact author

Соавторы

Спасибо всем, кто сделал это расширение реальностью, включая всех, кто потратил некоторое время на тестирование и сообщение об ошибках.

Среди прочих, я хотел бы выразить особую благодарность Hxebolax, который нашел и исправил ошибку, из-за которой дополнение не работало в течение нескольких месяцев в 2020 году.

Перевод

• Валентин Куприянов: Русский язык

• NVDATranslate-V.2024.03.12.nvda-addon
• NVDATranslate-V.2024.03.10.nvda-addon