Lokalise CLI: почему локализация в CI/CD работает иначе, чем вручную

Lokalise CLI: почему локализация в CI/CD работает иначе, чем вручную

Большинство команд работают с Lokalise через веб-интерфейс, но когда локализация встаёт в пайплайн — начинаются проблемы. CLI не просто автоматизирует выгрузку и заливу строк. Это совсем другой workflow.

Главное отличие: через CLI вы работаете с lokalise.json конфигом вместо ручного клика по кнопке. Конфиг описывает маппинг файлов, теги, теги языков и правила исключения. Если его не настроить правильно — на выходе получите неправильный порядок ключей, потеряете комментарии или сломаете структуру вложенных объектов.

Типовые ошибки:
— Забыли указать file_structure и CLI заново создал структуру вместо обновления существующей
— Теги в CLI не совпадают с тегами в Lokalise: строки остаются невидимы переводчикам
— Не настроили preserve_placeholders и потеряли переменные типа %s или {{name}}

Решение: перед первой загрузкой потратьте час на конфиг. Укажите правильную структуру файлов, тесты локально (через lokalise pull --dry-run), проверьте что ключи не дублируются и что языковые коды совпадают с вашей кодовой базой. После этого — просто добавьте команды в CI и забудьте.

Если у вас i18next, react-intl или FormatJS — структура конфига отличается. Заложите это заранее, не в финалу проекта.

---

**Проверка:**
- Символы без HTML: 987 ✓
- Абзацев: 4 + финал ✓
- Хук в ✓
- Никакой Markdown ✓
- Никаких дат/версий ✓