Файлы PO - Lingo.dev CLI

Что такое PO-файлы?

PO (Portable Object) файлы — это текстовый формат файлов, используемый GNU gettext для интернационализации программного обеспечения. Они хранят оригинальные строки вместе с их переводами и широко применяются в проектах с открытым исходным кодом.

Например:

msgid ""
msgstr ""
"Project-Id-Version: Example Project 1.0\n"
"Language: en\n"

msgid "Welcome"
msgstr "Welcome"

msgctxt "navigation"
msgid "Home"
msgstr "Home"

msgid "You have %d message"
msgid_plural "You have %d messages"
msgstr[0] "You have %d message"
msgstr[1] "You have %d messages"

Что такое Lingo.dev CLI?

Lingo.dev CLI — это бесплатный инструмент с открытым исходным кодом для перевода приложений и контента с помощью ИИ. Он разработан для замены традиционного программного обеспечения для управления переводами и интеграции с существующими конвейерами.

Чтобы узнать больше, см. Обзор.

О данном руководстве

В этом руководстве объясняется, как переводить PO-файлы с помощью Lingo.dev CLI.

Вы узнаете, как:

Создать проект с нуля
Настроить конвейер перевода
Генерировать переводы с помощью ИИ

Предварительные требования

Для использования Lingo.dev CLI убедитесь, что установлена версия Node.js v18+:

❯ node -v
v22.17.0

Шаг 1. Настройка проекта

В каталоге вашего проекта создайте файл i18n.json:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

Этот файл определяет поведение конвейера перевода, включая языки перевода и расположение локализуемого контента в файловой системе.

Чтобы узнать больше о доступных свойствах, см. i18n.json.

Шаг 2. Настройка исходной локали

Исходная локаль — это оригинальный язык и регион, на которых был написан ваш контент. Чтобы настроить исходную локаль, установите свойство locale.source в файле i18n.json:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

Исходная локаль должна быть указана в виде языкового тега BCP 47.

Для полного списка кодов локалей, поддерживаемых Lingo.dev CLI, см. Поддерживаемые коды локалей.

Шаг 3. Настройка целевых локалей

Целевые локали — это языки и регионы, на которые вы хотите перевести ваш контент. Чтобы настроить целевые локали, задайте свойство locale.targets в файле i18n.json:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

Шаг 4. Создание исходного контента

Если вы ещё этого не сделали, создайте один или несколько PO-файлов, содержащих контент для перевода. Эти файлы должны находиться в пути, который включает исходную локаль (например, в имени директории, как en/, или в имени файла, как messages.en.po).

Шаг 5. Создание корзины

В файле i18n.json добавьте объект "po" в объект buckets:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "po": {}
  }
}

В объекте "po" определите массив из одного или нескольких шаблонов include:
```
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "po": {
      "include": ["./[locale]/example.po"]
    }
  }
}
```
Эти шаблоны определяют, какие файлы нужно перевести.

Сами шаблоны:
- должны содержать [locale] как заполнитель для настроенной локали
- могут указывать на пути к файлам (например, "[locale]/messages.po")
- могут использовать звёздочки в качестве подстановочных символов (например, "[locale]/*.po")
Рекурсивные шаблоны (например, **/*.po) не поддерживаются.

Шаг 6. Настройка LLM

CLI Lingo.dev использует большие языковые модели (LLM) для перевода контента с помощью ИИ. Чтобы использовать одну из этих моделей, вам нужен API-ключ от поддерживаемого провайдера.

Чтобы начать как можно быстрее, мы рекомендуем использовать Lingo.dev Engine — нашу собственную платформу, которая предоставляет 10 000 токенов бесплатного ежемесячного использования:

Зарегистрируйтесь в Lingo.dev.
Выполните следующую команду:
```
npx lingo.dev@latest login
```
Эта команда откроет ваш браузер по умолчанию и предложит вам пройти аутентификацию.
Следуйте инструкциям.

Шаг 7. Генерация переводов

В каталоге, содержащем файл i18n.json, выполните следующую команду:

npx lingo.dev@latest run

Эта команда:

Считывает файл i18n.json.
Находит файлы, которые нужно перевести.
Извлекает переводимый контент из файлов.
Использует настроенную LLM для перевода извлеченного контента.
Записывает переведенный контент обратно в файловую систему.

При первой генерации переводов создается файл i18n.lock. Этот файл отслеживает, какой контент был переведен, предотвращая ненужные повторные переводы при последующих запусках.

Пример

en/example.po

msgid ""
msgstr ""
"Project-Id-Version: Example Project 1.0\n"
"Language: en\n"

msgid "Welcome"
msgstr "Welcome"

msgctxt "navigation"
msgid "Home"
msgstr "Home"

msgid "You have %d message"
msgid_plural "You have %d messages"
msgstr[0] "You have %d message"
msgstr[1] "You have %d messages"

msgid "Save"
msgstr "Save"

es/example.po

msgid ""
msgstr ""
"Project-Id-Version: Example Project 1.0\n"
"Language: es\n"

msgid "Welcome"
msgstr "Bienvenido"

msgctxt "navigation"
msgid "Home"
msgstr "Inicio"

msgid "You have %d message"
msgid_plural "You have %d messages"
msgstr[0] "Tienes %d mensaje"
msgstr[1] "Tienes %d mensajes"

msgid "Save"
msgstr "Guardar"

i18n.json

{
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "po": {
      "include": ["./[locale]/example.po"]
    }
  },
  "$schema": "https://lingo.dev/schema/i18n.json"
}

i18n.lock

version: 1
checksums:
  cdba37b4ade3da08cf12eccfde49d625:
    Welcome/singular: 3180ad6b8de344b781637750259e0f53
    Home/singular: 104a3db3b671c04e167eafbe21e57881
    You%20have%20%25d%20message/singular: 1691abfe2c5d017cda86e298d34f3524
    You%20have%20%25d%20message/plural: 2d37831bf51cc2cf75e812c0e61c6861
    Save/singular: f7a2929f33bc420195e59ac5a8bcd454
    Cancel/singular: 2e2a849c2223911717de8caa2c71bade
    Delete/singular: 8bcf303dd10a645b5baacb02b47d72c9
    Name/singular: 9368b5a047572b6051f334af5aa76819
    Email%20Address/singular: 0ee22bbbe989a0c61a18023407d12dc2
    Message/singular: f2f72126bd244cfc534eab395e054362
    Loading.../singular: 82b4ea7ed1439094d7c4be13aaba9a66
    Success!%20Changes%20saved./singular: 906371aaeec474803e22ae959605dad8
    Error%3A%20Request%20failed./singular: cdeaab2374e34c0e396cdb2596a9824e
    Add%20to%20Cart/singular: c93a29ccf502ff71bf08924dcdea9179
    Out%20of%20Stock/singular: 6673fc95c2cee3c713e0d60c8184e289
    Price%3A%20%24%25s/singular: a860f7b395e4a9d916a48717f9f8837a