Адаптер перевода

ioBroker используется по всему миру. Для того чтобы адаптер был понятен везде, необходимо перевести три вещи:

  • тексты интерфейса конфигурации,
  • title иdesc вio-package.json ,
  • примечания к изменениям (news ) вio-package.json .

Знание английского и немецкого языков обязательно. Все остальное — на добровольной основе, но приветствуется.

Поддерживаемые языки

en ,de ,ru ,pt ,nl ,fr ,it ,es ,pl ,uk ,zh-cn .

Инструмент

Перевод выполнен с помощью@iobroker/adapter-dev Это относится к категории зависимостей развития:

npm install --save-dev @iobroker/adapter-dev

Вpackage.json Оно получит запись в разделеscripts :

"scripts": {
    "translate": "translate-adapter"
}

Адаптер от Adapter Creator уже включает эту функцию.

!> Старыйgulp translate Его больше нет в наличии. У кого ещё остался такой...Gruntfile илиgulpfile.js Для переводов в пакете замените их наadapter-dev .

Процесс

Новые тексты записываются только в файл на английском языке, то есть вadmin/i18n/en.json илиadmin/src/i18n/en.json Впоследствии:

npm run translate

Это заполняет все недостающие переводы в других языковых файлах и вio-package.json только определенные языки:

npm run translate -- -l de fr it

Интерфейс в старом стиле HTML также имеетwords.js Теперь его выращивают не вручную, а производят:

npm run translate all

Это переводит, а затем записывает.words.js из JSON-файлов. Всем, у кого ещё нет JSON-файлов, следует один раз вызвать [команду/метод].npm run translate to-json удалить их из существующихwords.js производить.

Команды поступают в трех формах: в письменном виде (to-json ), как знак (j ) и под старым названием Gulp (adminWords2languages Они делают одно и то же.

Что переводится с помощью

Используется без каких-либо дополнительных настроек.adapter-dev Бесплатный сервис Google Translate имеет ограниченное количество применений. DeepL обеспечивает лучшие результаты. Для этого требуется всего одна переменная окружения:

export DEEPL_API_KEY="…"
npm run translate

ТакжеGOOGLE_APPLICATION_CREDENTIALS Если установить такой порядок, то будет использоваться DeepL, затем Google Translate V3, а затем бесплатный Google Translate.

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

Веблейт

Для перевода, осуществляемого сообществом, существует weblate.iobroker.net . Если вы зарегистрируете там свой адаптер, вы будете получать переводы от носителей языка, а не от машины. Weblate вызываетto-words даже как только что-то изменится.

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

Для страниц в разделе «Адаптер» применяется отдельная процедура. Она описана в разделах «Руководство по стилю документации» и «Шаблон документации» .