/online_translate

Primary LanguagePython

Онлайн-словарь для Goldendict

Описание функционала

Этот скрипт можно использовать как расширение для Goldendict, позволяющее выполнять машинный онлайн-перевод от различных сервисов. В данный момент, скрипт умеет работать с сервисами: translate.yandex, translate.google.
Также, его можно использовать как консольный онлайн-переводчик.

Установка и предварительная настройка

Для google translate дополнительно настраивать ничего не потребуется. Весь необходимый функционал реализован в библиотеке googletrans.
Для yandex translate следуйте инструкции.

  • Goldendict должен быть установлен в системе.

  • Python3 должен быть установлен в системе.

  • Выполните команды:

    git clone https://github.com/nicko858/online_translate.git
cd online_translate
pip install -r requirements.txt

YandexTranslate

  • Создайте файл .env в директории программы

  • Создайте аккаунт в yandex cloud

  • Создайте сервисный аккаунт с помошью данной инструкции

  • Создайте авторизованный ключ для сервисного аккаунта с помошью данной инструкции. В результате, вы должны получить файл key.json.

  • Скопируйте созданный key.json в директорию проекта

  • Получите IAM-токен*, необходимый для аутентификации yandex translate

  • Получите идентификатор любого каталога, на который у вашего аккаунта есть роль editor или выше

  • Создайте следующую запись в .env- файле:

    YANDEX_IAM_TOKEN=<ваш API-ключ>
FOLDER_ID=<ваш folder_id>

*Срок действия IAM-токена - 12 часов. Если yandex translate api вернет ответ с кодом 16, будет сгенерирован новый IAM-токен и обновится переменная YANDEX_IAM_TOKEN в .env- файле.
Данный функционал реализован с помощью JWT. См. инструкцию

Настройка Goldendict

В интерфейсе программы Goldendict:

  • Edit --> Dictionaries --> Programs
    Добавьте записи со следующими параметрами:
    1. Type: Plain Text
      Name: Yandex
      Command Line : python3 <online_translate_path>/translator.py yandex %GDWORD%
    2. Type: Plain Text
      Name: Google
      Command Line : python3 <online_translate_path>/translator.py google %GDWORD%
      , где:
      • python3 - путь к интерпритатору python, или к виртуальному окружению
      • <online_translate_path> - директория куда склонирован online_translate
  • Нажмите OK
  • Edit --> Preferences --> Hotkeys
    Установите hotkey для перевода из буфера обмена (по умолчанию - Ctrl+C+C)
  • Нажмите OK

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

Goldendict

Увидев незнакомую фразу/слово, просто выделите и нажмите Ctrl+C+C.
Результат будет примерно следующий:

screen

Консольный режим

(venv) nicko@nicko-laptop:~/online_translate$ python translator.py yandex 'Female domestic cats can have kittens from spring to late autumn, with litter sizes ranging from two to five kittens'
Женские домашние кошки могут иметь котят от весны до поздней осени, с помета от двух до пяти котят