Субтитры SRT - Lingo.dev CLI

Что такое субтитры SRT?

Субтитры SRT (SubRip) — это текстовый формат файла, используемый для хранения субтитров для видео. Каждая запись субтитров содержит порядковый номер, временную метку и текст субтитров, что делает его одним из самых широко поддерживаемых форматов субтитров.

Например:

1
00:00:01,000 --> 00:00:03,500
Добро пожаловать на демонстрацию нашего продукта

2
00:00:04,000 --> 00:00:06,500
В этом видео мы покажем вам,
как быстро начать работу

3
00:00:07,000 --> 00:00:09,500
Сначала перейдите на свою панель управления 📊

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

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

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

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

В этом руководстве объясняется, как переводить файлы субтитров SRT с помощью 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. Создайте исходный контент

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

Шаг 5. Создайте bucket

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

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

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

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

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

Lingo.dev CLI использует большие языковые модели (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.srt

1
00:00:01,000 --> 00:00:03,500
Welcome to our product demo

2
00:00:04,000 --> 00:00:06,500
In this video, we'll show you
how to get started quickly

3
00:00:07,000 --> 00:00:09,500
First, navigate to your dashboard 📊

4
00:00:10,000 --> 00:00:12,500
This process takes about 5 minutes

5
00:00:13,000 --> 00:00:15,500
Click the <i>Create New</i> button to begin

es/example.srt

1
00:00:01,000 --> 00:00:03,500
Bienvenido a nuestra demostración de producto

2
00:00:04,000 --> 00:00:06,500
En este video, te mostraremos
cómo empezar rápidamente

3
00:00:07,000 --> 00:00:09,500
Primero, navega a tu panel de control 📊

4
00:00:10,000 --> 00:00:12,500
Este proceso toma aproximadamente 5 minutos

5
00:00:13,000 --> 00:00:15,500
Haz clic en el botón <i>Crear Nuevo</i> para comenzar

i18n.json

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

i18n.lock

version: 1
checksums:
  424142ee2f7c4f944722042f761b30eb:
    1#00:00:01,000-00:00:03,500: 5a2215cdfd6d9e9162efbdee57b89c27
    2#00:00:04,000-00:00:06,500: ecb7d6cb214b6db6d02e6e98cdfea178
    3#00:00:07,000-00:00:09,500: 3eee55196aea6ac13fb19eae7e7ffaf6
    4#00:00:10,000-00:00:12,500: a6cc802efe3431c7a986ac5d42d62ce1
    5#00:00:13,000-00:00:15,500: f73ef0a42ea51efb4e1e5fd2276ef243