Каждое руководство пошагово разбирает конкретный сценарий локализации — от настройки движка локализации в Lingo.dev до выпуска переведённого результата в продакшен. Во всех руководствах предполагается, что у вас уже есть организация и настроен как минимум один движок локализации.
Как устроены руководства#
У каждого продукта свои точки локализации. Веб-приложению нужны переведённые строки интерфейса. API — локализованные ответы. Сайту документации — переведённые файлы Markdown. Все эти точки подключаются к одному и тому же движку локализации, но способ интеграции различается.
В этих руководствах описаны семь вариантов интеграции:
| Поверхность | Что локализуется | Способ интеграции |
|---|---|---|
| API перевода | Данные в формате «ключ-значение», динамический контент | Вызовы HTTP API |
| Веб-приложения | Строки интерфейса, текст компонентов | CLI + интеграция с фреймворком |
| Мобильные приложения | iOS .strings, Android .xml | CLI + мобильный пайплайн сборки |
| iOS-приложения | String Catalogs в Xcode .xcstrings | CLI + GitHub Actions |
| Android-приложения | Android strings.xml | CLI + GitHub Actions |
| Next.js с Markdoc | Страницы Markdoc и строки интерфейса в JSON | CLI + GitHub Actions |
| Rails с i18n | YAML-файлы Rails config/locales | CLI + GitHub Actions |
| Письма | Транзакционные и маркетинговые шаблоны | API или CLI в зависимости от формата шаблона |
| Статический контент | Файлы Markdown, JSON и YAML | CLI с файловым переводом |
| Рабочие процессы CI/CD | Всё перечисленное выше — в автоматическом режиме | GitHub Actions, GitLab CI, Bitbucket Pipelines |
Что понадобится
Для всех руководств нужны API-ключ и настроенный движок локализации. Если вы ещё этого не сделали, начните с документации.
