Markdown

AI-перевод Markdown-файлов с помощью Lingo.dev CLI

Что такое Markdown?

Markdown — это легковесный язык разметки, который использует синтаксис форматирования обычного текста для создания структурированных документов. Он широко используется для документации, файлов README, блогов и систем управления контентом.

Например:


---

title: "Руководство по запуску продукта"
description: "Все, что вам нужно знать о новых функциях нашего продукта"
author: "Команда продукта"

---

# Добро пожаловать в нашу новую панель управления

Откройте для себя мощные новые функции, разработанные для оптимизации вашего рабочего процесса и повышения продуктивности.

## Начало работы

Следуйте этим простым шагам, чтобы настроить свою учетную запись и эффективно начать использовать нашу платформу.

![Скриншот обзора панели управления](image.jpg)

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

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

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

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

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

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

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

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

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

  2. В объекте "markdown" определите массив из одного или нескольких шаблонов include:

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

    Эти шаблоны определяют, какие файлы нужно перевести.

    Сами шаблоны:

    • должны содержать [locale] как заполнитель для настроенной локали
    • могут указывать на пути к файлам (например, "[locale]/docs.md")
    • могут использовать звездочки в качестве подстановочных знаков (например, "[locale]/*.md")

    Рекурсивные шаблоны (например, **/*.md) не поддерживаются.

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

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

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

  1. Зарегистрируйтесь в Lingo.dev.

  2. Выполните следующую команду:

    npx lingo.dev@latest login

    Эта команда откроет ваш браузер по умолчанию и попросит вас пройти аутентификацию.

  3. Следуйте инструкциям.

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

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

npx lingo.dev@latest run

Эта команда:

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

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

Пример

ru/example.md


---

title: "Руководство по запуску продукта"
description: "Всё, что нужно знать о новых функциях нашего продукта"
author: "Команда продукта"
date: 2024-01-15
tags: ["яблоки", "бананы", "груши"]

---

# Добро пожаловать в нашу новую панель управления

Откройте для себя мощные новые функции, разработанные для оптимизации вашего рабочего процесса и повышения продуктивности.

## Начало работы

Следуйте этим простым шагам, чтобы настроить свою учётную запись и эффективно начать использовать нашу платформу.

---

Наши передовые аналитические инструменты помогают вам принимать обоснованные решения на основе данных.

![Скриншот обзора панели управления](image.jpg)

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

[Просмотреть документацию](https://example.com)

Нужна помощь с началом работы? Наша служба поддержки доступна 24/7, чтобы помочь вам.

***

Присоединяйтесь к тысячам довольных клиентов, которые преобразовали свой бизнес с помощью нашей платформы.

ru/example.md


---

title: Руководство по запуску продукта
description: Все, что вам нужно знать о последних функциях нашего продукта
author: Команда продукта
date: 2024-01-15
tags:
  - яблоки
  - бананы
  - груши

---

# Добро пожаловать в нашу новую панель управления

Откройте для себя новые мощные функции, разработанные для оптимизации ваших рабочих процессов и повышения продуктивности.

## Первые шаги

Следуйте этим простым шагам, чтобы настроить свою учетную запись и начать эффективно использовать нашу платформу.

---

Наши продвинутые аналитические инструменты помогают вам принимать обоснованные решения на основе данных.

![Скриншот обзора панели управления](image.jpg)

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

[Просмотреть документацию](https://example.com)

Нужна помощь с началом работы? Наша служба поддержки доступна 24/7, чтобы помочь вам.

---

Присоединяйтесь к тысячам довольных клиентов, которые преобразовали свой бизнес с помощью нашей платформы.

i18n.json

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

i18n.lock

version: 1
checksums:
  eed9ef23a605b747d38b8916cee1d500:
    md-section-0: d53f61b8c8922fb62d9df5678d9b44a8
    md-section-1: 98aec271471bedce0e12b530c7060827
    md-section-2: 9e5a786192608844493dfbb6e4100886
    md-section-3: 1a5299c38bb20c1b8af0e64e33d7b2b0
    md-section-4: 51adf33450cab2ef392e93147386647c
    md-section-5: e56cc804e3e06b5f5fb2484e88c18adc
    md-section-6: 0ea86a3338305070c865e8fe138da890
    md-section-7: bbabf7f391569a72099001e3d81eb251
    md-section-8: 36cbfd93f42528edce4faac2ac3c2c12
    md-section-9: a1c50054ab23d70be8d453789b214580
    md-section-10: 51adf33450cab2ef392e93147386647c
    md-section-11: cb596c9608828f7b87a0ab8fa37beb07
    fm-attr-title: f3469c4e3d3377c39a705c844930b3a5
    fm-attr-description: 2e988d98001e44997a3f5fa3fb487ca6
    fm-attr-author: ec8c8711fce61265a4fe296ce2ba3b6f
    fm-attr-tags: 313ac6f17ee08e4f4a6a2ca95e5ae024