База знаний

Ответы на частые вопросы о локализации приложений, документации и контента с помощью General Translation.

Интернационализация

Настройка i18n в кодовой базе: библиотеки, фреймворки и компоненты.

Как перевести приложение на Flask или FastAPI?Отметьте строки, которые видит пользователь, определите локаль для каждого запроса (обычно по заголовку Accept-Language) и загрузите переводы для этой локали. В приложениях на Flask обычно используют Flask-Babel с каталогами gettext, а в приложениях на FastAPI Babel подключают через промежуточное ПО. CLI от General Translation заполняет эти каталоги, а экспериментальные SDK gt-flask и gt-fastapi переводят встроенные строки t() без всяких каталогов.Видео52 с
Как локализовать Android-приложение с помощью strings.xml?Храните все строки по умолчанию в res/values/strings.xml, добавьте strings.xml для каждого языка в папку с квалификатором локали, например values-es или values-b+zh+Hant+TW, и получайте текст через stringResource или getString. Переводите вручную, в Play Console или с помощью CLI от General Translation, который создаёт все папки values и заново формирует формы множественного числа для каждого языка перевода.Видео49 с
Как добавить i18n в приложение Next.js на Pages Router?Добавьте в next.config.js блок i18n с locales и defaultLocale — и Next.js будет отдавать страницы по адресам /es и /fr, перенаправлять посетителей в зависимости от языка браузера и передавать локаль в getStaticProps и getServerSideProps. Рендеринг сообщений берёт на себя библиотека; gt-next от General Translation, кроме того, генерирует переводы из текста, написанного прямо в JSX.Видео55 с
Как добавить i18n в TanStack Start?В TanStack Start нет встроенной поддержки i18n, поэтому нужно подключить библиотеку, которая разрешает локаль для каждого серверного запроса — обычно по префиксу URL или cookie-файлу — и загружает сообщения до рендеринга. Paraglide JS, react-i18next и Lingui выполняют рендеринг переводов, которые вы готовите сами; экспериментальный gt-tanstack-start от General Translation, кроме того, генерирует их из текста, встроенного прямо в JSX.Видео48 с
Как перевести строки вне JSX?Пропускайте каждую строку, которая не является дочерним элементом JSX (например, плейсхолдер или константу в области видимости модуля), через функцию перевода в том месте, где выполняется её рендеринг. Такую функцию возвращает хук useGT от General Translation, а msg вместе с useMessages переводит константы, определённые вне компонента.Видео49 с
Как перевести приложение на Vue?Чтобы перевести приложение на Vue, нужно заменить каждую строку шаблона поиском по ключу для активного языка и перевести её на все языки перевода. Плагин gt-vue от General Translation переводит контент, обёрнутый в компонент <T>, а npx gt translate создаёт отдельный каталог для каждого языка перевода.Видео48 с
Как перевести приложение на React Native?Разметьте текст в компонентах, сгенерируйте файл перевода для каждого языка, добавьте полифилы Intl и загружайте файл для языка устройства. С экспериментальной библиотекой gt-react-native от General Translation вы оборачиваете текст в <T>, Babel-плагин добавляет полифилы, а npx gt translate создаёт файлы.Видео47 с
Как перевести приложение на Node.js?Определяйте язык каждого запроса, обычно по заголовку Accept-Language, и возвращайте все строки на этом языке. Пакет gt-node от General Translation привязывает локаль к каждому запросу с помощью withGT и переводит строки с помощью getGT. Переводы для них генерирует команда npx gt translate --publish ещё до развертывания.Видео48 с
Как перевести React-приложение?Перевод React-приложения состоит из двух этапов — интернационализации компонентов, чтобы они отображались на языке пользователя, и перевода каждой строки на все поддерживаемые языки. gt-react от General Translation переводит JSX на месте в компоненте <T>, а npx gt translate создаёт по одному файлу на каждый язык.Видео48 с
Как интернационализировать приложение с помощью Cursor или Claude Code?Начните с промпта Setup for Agents от General Translation в Cursor или Claude Code, выберите функциональность и целевые языки, а затем поручите агенту реализовать и проверить результат. Вход через браузер, машиночитаемая документация и инструменты MCP связывают настройку с переводом и проверкой. Используйте Locadex, чтобы автоматизировать дальнейшую локализацию через пул-реквесты.Видео46 с
Как добавить i18n в приложение Next.js на App Router?Начните с gt init, чтобы настроить General Translation в поддерживаемом проекте на App Router, затем разметьте исходное содержимое, создайте переводы и проверьте переключение языка. gt-next хранит тексты прямо в JSX вместе с контекстом перевода, а CLI, редактор в панели управления и Locadex берут на себя генерацию, проверку и последующие обновления. В этом руководстве также показана явная настройка с локальными файлами.Видео51 с
Что такое псевдолокализация?Псевдолокализация — это тест, при котором исходный текст заменяется изменённой версией с диакритикой, удлинённой примерно на 40% и заключённой в скобки. Так жёстко закодированные строки, усечение, проблемы со шрифтами и склеенные из фрагментов предложения выявляются ещё до появления перевода. В Android для этого предусмотрены псевдолокали en-XA и ar-XB.Видео48 с
Переключатель языка: лучшие практики UX, SEO и доступностиНазывайте каждый язык на нём самом, например Deutsch или 日本語, и не используйте флаги — они обозначают страны. Каждый вариант должен вести на ту же страницу на выбранном языке через индексируемую ссылку. Запоминайте выбор в cookie-файле и никогда не перенаправляйте автоматически с локализованного URL.Видео47 с
Как сделать сайт многоязычным?Выберите, где будут храниться переводы — в прокси, плагине CMS, конструкторе сайтов или в вашем собственном коде, — а затем выделите каждому языку собственный URL, как рекомендует Google. Переводите страницы целиком, включая заголовки и метаописания, связывайте языковые версии с помощью hreflang и предлагайте переключатель языка вместо автоматического перенаправления посетителей.Видео50 с
Как определить язык браузера пользователя?Прочитайте упорядоченный список языков браузера (navigator.languages в JavaScript или заголовок Accept-Language на сервере с сортировкой по q-значению) и сопоставьте его с поддерживаемыми локалями, предусмотрев резервный вариант. Safari и Chrome в режиме инкогнито сообщают только один язык, а геолокация по IP указывает на местоположение, а не на язык.Видео47 с
Как найти захардкоженные строки, которые не переведены?Запустите в CI линтер, который находит строковые литералы, видимые пользователю, — например, правило no-literal-string из eslint-plugin-i18next для JSX, проверку HardcodedText в Android Lint или линтер HardCodedString из erb_lint для Rails. Затем пройдитесь по приложению в псевдолокали, чтобы найти текст, который статические проверки отследить не могут.Видео48 с
Как называть ключи переводов i18n?Называйте ключи по тому, где отображается текст и что он означает, например checkout.summary.title, а не по его английской формулировке. Для каждого отдельного случая использования заводите собственный ключ, даже если английский текст совпадает: в немецком кнопка Open переводится как Öffnen, а статус Open — как Offen.Видео46 с
Как локализовать iOS-приложение с помощью String Catalogs?Добавьте языки в Xcode, пишите текст для пользователей с помощью локализуемых API, таких как SwiftUI Text и String(localized:), и выполните сборку, чтобы Xcode собрал эти строки в String Catalog (.xcstrings). Переводите в Xcode, через XLIFF или с помощью CLI General Translation, если каталоги должны обновляться с каждым релизом и использовать общую терминологию с вашим сайтом и Android-приложением.Видео44 с
Интернационализация и локализация (i18n и l10n)Интернационализация (i18n) — это работа над кодом и дизайном, благодаря которой один продукт может поддерживать множество локалей: например, форматировать даты с помощью Intl и отображать текст с направлением right-to-left. Локализация (l10n) адаптирует продукт под конкретную локаль: это перевод, а также валюта, форматы дат, единицы измерения, тон и правовые нюансы.Видео52 с
Чек-лист тестирования локализации для многоязычных приложенийПроверьте девять аспектов в каждой поддерживаемой локали на сборке для рабочей среды: пользовательские сценарии целиком, включая состояния ошибок и письма; переключение языка; формы множественного числа; валюту и часовые пояса; увеличение длины текста; вёрстку для языков right-to-left; доступность; доставку переводов; индексируемые языковые URL. Задайте для каждой проверки явный критерий успешного прохождения.Видео33 с
Писать собственную i18n или использовать General Translation?Самописной i18n (по словарю на каждый язык и небольшой вспомогательной функции t()) вполне достаточно для одного-двух языков и небольшого объёма текста. По мере роста приложения вам приходится заново реализовывать правила множественного числа, резервные варианты и синхронизацию файлов, а переводы всё равно нужно где-то брать. Библиотеки General Translation с открытым исходным кодом берут на себя рендеринг, а General Translation генерирует и обновляет переводы на основе вашего кода.Видео43 с
Альтернативы react-intl: General Translation или react-intlGeneral Translation позволяет React-командам сохранить синтаксис ICU-сообщений и при этом получить генерацию переводов, общую терминологию и проверку в панели управления. react-intl отвечает за форматирование и предоставляет инструменты FormatJS для работы с каталогами, а General Translation ещё и создаёт сами переводы.Видео47 с
Альтернативы i18next: General Translation или i18nextВыбирайте General Translation, если хотите хранить тексты прямо в React-компонентах и создавать переводы с учётом их JSX-структуры и контекста продукта. Можно также оставить i18next и переводить существующие каталоги с помощью General Translation. i18next отвечает за рендеринг сообщений и выбор форм множественного числа, а сами переводы предоставляет отдельный сервис.Видео47 с
General Translation против i18next, react-intl и next-intl: какую библиотеку интернационализации выбрать?Библиотеки с открытым исходным кодом, такие как i18next, react-intl и next-intl, ничего не переводят. Они лишь отображают переводы, которые вы сами помещаете в файл каталога для каждого языка, — их пишете вы, ваши переводчики или сторонний сервис. Библиотеки General Translation тоже имеют открытый исходный код и делают то же самое, но General Translation ещё и выполняет перевод, используя ваш код как контекст.Видео43 с
General Translation или vue-i18n: что выбрать?General Translation позволяет командам Vue писать исходные тексты прямо в шаблонах и создавать переводы с помощью CLI. Плагин gt-vue выполняет рендеринг этого контента с учётом локали, включая формы множественного числа и форматирование чисел. Выбирайте его, если хотите избавиться от поддержки исходных файлов с ключами; vue-i18n по-прежнему подходит командам, которые используют модуль i18n для Nuxt и уже сложившийся рабочий процесс с каталогами.Видео42 с
General Translation или Symfony Translation: что выбрать?Symfony Translation выполняет рендеринг сообщений в PHP и Twig. General Translation переводит его YAML-каталоги в CI, поддерживает их в актуальном состоянии при изменении исходного текста и даёт рецензентам панель управления для их редактирования. Оставьте рендеринг за Symfony и добавьте автоматический перевод в рабочий процесс релиза.Видео44 с
General Translation или Paraglide JS: что выбрать?Выбирайте General Translation, если хотите держать тексты прямо в коде и создавать переводы с учётом структуры ваших React-компонентов, общей терминологии и проверки в панели управления. Выбирайте Paraglide JS, если вам нужны скомпилированные типизированные функции сообщений и tree-shaking на уровне отдельных сообщений. Paraglide выполняет рендеринг ваших каталогов, а General Translation связывает исходные тексты с созданием переводов и их последующим обновлением.Видео42 с
General Translation или nestjs-i18n: что выбрать?nestjs-i18n определяет язык каждого запроса в приложении NestJS и выполняет рендеринг сообщений из JSON- или YAML-каталогов для каждого языка, но сам ничего не переводит. CLI General Translation переводит эти каталоги, а библиотека gt-node переводит контент, который появляется только во время выполнения, поэтому можно оставить nestjs-i18n и добавить к нему General Translation.Видео45 с
General Translation или Mobility: что выбрать?Mobility хранит переведённые атрибуты моделей в вашей базе данных. General Translation создаёт эти переводы через свой API с учётом вашего Glossary и пользовательских промптов. Используйте оба инструмента, чтобы переводить карточки товаров, публикации и другой контент из базы данных, не отказываясь от своих моделей Rails.Видео44 с
General Translation или Lingui: что выбрать?Выбирайте General Translation, если хотите, как и в Lingui, держать тексты прямо в коде и генерировать переводы, используя структуру JSX в качестве контекста. Lingui извлекает встроенные сообщения в каталоги, которые затем переводят ваши переводчики или подключённый сервис. CLI General Translation обновляет переводы по мере изменения кода, а ваша команда проверяет их в панели управления.Видео45 с
General Translation или Intlayer: что выбрать?Intlayer хранит контент каждого компонента в типизированном файле объявлений рядом с ним, где все языки записаны бок о бок, и может заполнять недостающие языки с помощью настроенного вами ИИ-провайдера. General Translation хранит тексты прямо в компонентах на одном языке и генерирует остальные языки с учётом контекста вашего кода.Видео42 с
General Translation или Babel и Flask-Babel: что выбрать?Babel форматирует даты, числа и валюты для любой локали и управляет каталогами gettext, а Flask-Babel интегрирует его с Flask, но ни один из них не переводит ваши строки. CLI General Translation заполняет PO-файлы Babel для всех языков, включая формы множественного числа, поэтому вы можете и дальше использовать Flask-Babel, но больше не переводить каталоги вручную.Видео46 с
General Translation и фреймворк переводов Django: нужны ли оба?Используйте фреймворк переводов Django вместе с General Translation. Django отвечает за извлечение сообщений, выбор языка и рендеринг. General Translation заполняет его PO-файлы, включая формы множественного числа, с учётом терминологии вашего продукта и проверки в панели управления. Ваши шаблоны и URL-шаблоны остаются прежними, а переводы обновляются вместе с кодом.Видео46 с
General Translation и Rails I18n: нужны ли оба?Rails I18n находит сообщения и форматирует даты и числа. General Translation создаёт переводы, поддерживает их в актуальном состоянии по мере изменения английского текста и предоставляет вашей команде панель управления для проверки. Используйте оба инструмента, чтобы выпускать переведённые каталоги Rails с каждым релизом.Видео44 с
General Translation и GNU gettext: нужны ли оба?Оставьте GNU gettext для извлечения и рендеринга, а General Translation подключите для генерации и сопровождения PO-файлов. General Translation учитывает при генерации заметки для переводчиков и контекст сообщений, применяет общую терминологию и предоставляет рецензентам редактор в панели управления. Существующие вызовы gettext и скомпилированные каталоги остаются на месте.Видео46 с
Можно ли делать i18n без файлов перевода?Да. Библиотеки gt-react и gt-next от General Translation обеспечивают i18n для React и Next.js без ключей перевода и без отдельного JSON-файла для каждого языка, который приходится поддерживать. Тексты остаются встроенными в JSX внутри компонента <T>, а команда gt translate генерирует переводы для каждого языка во время сборки, учитывая контекст из вашего кода. Locadex может поддерживать их в актуальном состоянии через пул-реквесты.Видео46 с
Как перевести условный текст в JSX?Не разбивайте предложение и переводите каждый его вариант целиком, ведь тернарный оператор дробит его на фрагменты, которые теряют смысл и своё место в порядке слов каждого языка. В General Translation для этого используется <Branch> внутри <T>, который переводит предложение как единое целое.Видео46 с

Форматирование с учётом локали

Формы множественного числа, даты, числа, валюты и текст с направлением right-to-left в каждой локали.

Перевод

Машинный перевод и перевод с помощью ИИ, качество, контекст и глоссарии.

Многоязычное SEO

Маршрутизация по локалям, hreflang, карты сайта и переведённые метаданные для многоязычных сайтов.

Инструменты для рабочих процессов

Выбор инструментов локализации и синхронизация переводов в рамках непрерывной локализации.

Разверните приложение уже сегодня

Присоединяйтесь к лучшим командам разработчиков мира в General Translation

Начать работуЗапросить демо