Dictionary-Translator

Цель проекта

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

Доступный функционал:

• Перевод указанного слова
• Указание транскрипции
• Ссылка на произношение слова
• Ссылка на примеры предложений с данным словом

Видео демонстрация

Video-Demonstration.mp4

Используемые технологии

• Google Sheets - Google Таблица является основным интерфейсом взаимодействия пользователя.
• Google Apps Script - Целью Google Script является обработка добавления новых элементов в Google таблицу, и отправка данных на API.
• ASP Web API - Используется для получения запросов на перевод, и вставку данных в Google таблицу. Является основным компонентом обработки данных приложения.
• Yandex Dictionary API - Данный API используется для перевода и получения транскрипции.
• Google Sheets API - С помощью данного API происходит вставка данных в Google Таблицу.

Как использовать?

Если вы хотите использовать данное приложение, вам требуется пройти несколько пунктов.

1. Добавление Google Script к вашей Google таблице

Для того, чтобы получить данные, введенные пользователем в таблицу Google, нам нужно добавить скрипт обработки изменения ячеек. В корне проекта располагается файл GoogleSheetScript.js, который вам нужно разместить в вашу Google таблицу.

Как добавить скрипт к Google Таблице

 let url = "https://url/TranslateConstroller/translate"

В данной строке кода вместо url должен быть указан ваш адрес, по которому будет размещаться ASP Web API.
Или вы можете использовать ngrok

2. Получение Google Credentials для доступа к Google Sheets

Как получить service-account credentials

3. Получить Dictionary API Key

4. Указать полученные данные в Dictionary-Translator/appsettings.json

Введите полученные вами данные в json.file

"YandexTranslateApiKey": "",

"GoogleSheetsOptions": {
    "ApplicationName": "",
    "SheetID": "",
    "SheetName": "",
    "SecretsPath": "",
    "SheetRange": {
       "ColumnStart": "",
       "ColumnEnd": ""
    }
  },

• YandexTranslateApiKey - API ключ из пункта 3.

• ApplicationName - Ваше названия проекта в cloud.google

• SheetID - Можно получить из адресной строки вашей Google таблицы

• SheetName - Наименование листа вашей Google таблицы

• SecretsPath - Путь к json файлу полученному из пункта 2.

• ColumnStart - Наименование столбца начала вашей гугл таблицы в виде буквы. Пример буква (А).

• ColumnEnd - Данный столбец должен быть на 5 больше от ColumnStart. Например, если вы выбрали столбец А, ColumnEnd должен быть F.