Public release from ruodoo-project: 19.0 - 2026-05-31 21:19:12 UTC

translation_helper/README.md

@@ -0,0 +1,59 @@
+# Модуль переводов в реальном времени
+
+⚠️ **ВНИМАНИЕ:** модуль находится на стадии бета-тестирования. Использование в промышленной эксплуатации **не рекомендуется**.
+
+Модуль реализует **прямой перевод терминов в режиме реального времени** прямо в пользовательском интерфейсе Odoo.
+
+---
+
+## Краткое руководство пользователя
+
+1. Установите модуль.
+
+2. Перейдите в настройки и активируйте **«Режим переводчика»** — он работает аналогично режиму разработчика.
+
+3. В правом верхнем углу экрана появится дополнительная иконка. Нажмите на неё, чтобы открыть меню доступных действий.
+
+4. У каждого пункта меню появится иконка для перевода. При изменении перевода он будет применён, и страница автоматически перезагрузится.
+
+5. У каждого поля появится кнопка для его перевода. Вы можете перевести:
+
+   * Название поля
+   * Подсказку (tooltip), которая отображается при наведении на знак вопроса
+     Перевод применяется **немедленно**.
+
+6. Все переводы сохраняются:
+
+   * В базу данных
+   * В `.po`-файлы выбранного языка, с именем, соответствующим модулю, в котором был объявлен термин
+     Например, если вы перевели термин из модуля `crm`, будет создан файл:
+
+     ```
+     translation_helper/translations/{код_языка}/crm.po
+     ```
+
+7. В этот файл выгружаются все переведённые термины.
+
+---
+
+## Применение переводов на новой базе
+
+Если вы создадите новую базу с установленным модулем, то при выборе, например, русского языка, система будет **на лету** подменять обращения к файлу:
+
+```
+odoo/addons/crm/i18n/ru.po
+```
+
+на ваш собственный файл:
+
+```
+translation_helper/translations/ru/crm.po
+```
+
+---
+
+## Преимущества
+
+* Вы можете **накапливать собственные переводы**, которые не зависят от внешних переводов.
+* Вы **полностью контролируете** систему локализации.
+* Перенос переводов между инстансами Odoo выполняется **простым копированием модуля**.