This translation may be outdated. The current English version is v1.4.0.View the English version

Помощь с переводом

Спасибо за ваш интерес к переводу документации TrucklineMP! Это руководство объясняет, как участвовать в переводе, каких стандартов мы придерживаемся и как отправить готовую работу.

Зачем переводить?

TrucklineMP — это глобальное сообщество. Перевод нашей документации помогает игрокам и руководителям VTC по всему миру понять, как пользоваться платформой на их родном языке. Качественные переводы делают платформу более доступной и дружелюбной.

Присоединяйтесь к сообществу участников

Хотите помочь с переводом или у вас есть вопросы? Присоединяйтесь к нашему специальному Discord-серверу для контрибьюторов:

https://discord.gg/jsuGrx4Rbv

Это место, где можно пообщаться с другими переводчиками, задать вопросы и скоординировать работу над документацией.

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

Каждая страница документации содержит два поля метаданных:

---
title: Example Page
description: ...
version: 1.2.0
lastUpdated: 2026-07-09
---

version определяет версию контента на странице. Когда в английскую страницу вносятся значимые изменения, её версия повышается.
lastUpdated это дата последнего редактирования файла.

Когда вы переводите страницу или обновляете перевод, копируйте version с текущей английской страницы и устанавливайте lastUpdated сегодняшнюю дату. Перевод, версия которого совпадает с английской страницей, отображается как Актуальный на странице Статуса перевода; при несовпадении версий он помечается как Устаревший, а на переведенной странице появляется баннер с предупреждением. Оба поля обязательны — автоматическая проверка CI отклонит pull request, в котором они отсутствуют.

Поддерживаемые в данный момент языки

Локаль	Язык	Статус
`en`	English	Исходный язык, всегда заполнен
`ru`	Русский	Переводы от сообщества, почти полностью готово
`de`	Deutsch (German)	Принимаются переводы от сообщества
`ta`	தமிழ் (Tamil)	Принимаются переводы от сообщества
`tr`	Türkçe (Turkish)	Принимаются переводы от сообщества
`pl`	Polski (Polish)	Принимаются переводы от сообщества
`fr`	Français (French)	Принимаются переводы от сообщества

Актуальный статус каждой локали можно посмотреть на странице Статус перевода. Вы не ограничены языками из списка выше — вы можете переводить документацию на любой язык, которым свободно владеете. Если вашего языка нет в списке, следуйте инструкциям из раздела “Добавление нового языка” ниже и свяжитесь с командой проекта, чтобы мы добавили нужную локаль.

Как устроены переводы

Документация TrucklineMP создана на базе Astro Starlight, фреймворка со встроенной поддержкой интернационализации (i18n).

Структура файлов

Переводы хранятся в папках конкретных локалей внутри каталога src/content/docs/:

src/content/docs/
├── index.mdx                     # Английская главная страница
├── web-docs/
│   ├── vtc-programs/
│   │   ├── verified.mdx          # Английское руководство
│   │   └── ...
│   └── ...
└── pl/                           # Папка польской локали
    ├── index.mdx                 # Польская главная страница
    └── web-docs/
        ├── vtc-programs/
        │   ├── verified.mdx      # Польский перевод
        │   └── ...
        └── ...

Структура URL-адресов

Английский: https://docs.trucklinemp.com/web-docs/vtc-programs/verified/
Русский: https://docs.trucklinemp.com/ru/web-docs/vtc-programs/verified/
Немецкий: https://docs.trucklinemp.com/de/web-docs/vtc-programs/verified/
Тамильский: https://docs.trucklinemp.com/ta/web-docs/vtc-programs/verified/
Турецкий: https://docs.trucklinemp.com/tr/web-docs/vtc-programs/verified/
Польский: https://docs.trucklinemp.com/pl/web-docs/vtc-programs/verified/
Французский: https://docs.trucklinemp.com/fr/web-docs/vtc-programs/verified/

Переключатель языков в правом верхнем углу позволяет пользователям переключаться между доступными языками.

Что можно переводить?

1. Содержимое руководств

Все .mdx файлы внутри каталогов src/content/docs/web-docs/, web-api/, game-docs/ и game-sdk/ доступны для перевода. Каждому английскому руководству должен соответствовать аналогичный файл в папке целевой локали.

2. Главная страница

Приветственная страница index.mdx также должна быть переведена, чтобы встречать пользователей на их языке.

3. Ярлыки бокового меню

Названия пунктов бокового меню настраиваются для каждого модуля в файле astro.config.mjs (через starlightSidebarTopics) и поддерживают переводы:

starlightSidebarTopics([
  {
    label: 'Web Docs',
    link: 'web-docs/vtc/creating',
    items: [
      {
        label: 'VTC Programs',
        items: [
          {
            slug: 'web-docs/vtc-programs/verified',
            label: 'Verified VTC Program',
            translations: {
              pl: 'Zweryfikowany Program VTC',
            },
          },
        ],
      },
    ],
  },
  // ... Web API, Game Docs, Game SDK
])

При переводе добавьте название на вашем языке в объект translations.

4. Элементы интерфейса

Некоторые системные подписи Starlight (например, “На этой странице”, “Редактировать страницу”, “Поиск”) обрабатываются встроенной системой переводов Starlight. Если язык не поддерживается фреймворком в полной мере, мы можем добавить пользовательские переводы интерфейса через файл конфигурации.

Перед началом работы

Требования

Аккаунт на GitHub
Базовое понимание синтаксиса Markdown и MDX
Свободное владение как английским, так и целевым языком
Знание терминологии TrucklineMP (VTC, конвой и т. д.)

Процесс перевода

Шаг 1: Сделайте форк репозитория

Перейдите в репозиторий документации на GitHub
Нажмите кнопку Fork в правом верхнем углу
Склонируйте свой форк на локальный компьютер или работайте через веб-интерфейс GitHub

Шаг 2: Настройте проект (Необязательно)

Чтобы предварительно просматривать переводы, откройте pull request и используйте автоматическую превью-ссылку для вашей ветки. Ссылка появится на pull request после завершения сборки.

Шаг 3: Выберите руководство для перевода

Проверьте текущий статус готовности и выберите руководство, которое ещё не было переведено или требует обновления. Приоритетные страницы:

Verified VTC Program
Partnered VTC Program
VTC General Settings
Profile Settings
Account Security

Шаг 4: Создайте файл перевода

Найдите исходный английский файл (например, src/content/docs/web-docs/vtc-programs/verified.mdx)
Создайте аналогичный файл в папке целевой локали (например, src/content/docs/pl/web-docs/vtc-programs/verified.mdx)
Скопируйте метаданные из шапки и переведите основной текст

Шаг 5: Сохраняйте структуру метаданных

Метаданные в шапке должны сохранять исходную структуру. Переводить можно исключительно их значения:

---
title: Verified VTC Program Rules
description: Complete guide to the Truckline Verified VTC Program — how to apply, requirements, and rules for maintaining verified status.
---

Пример для польского языка:

---
title: Zasady Programu Zweryfikowanych VTC
description: Pełny przewodnik po Programie Zweryfikowanych VTC Truckline — jak aplikować, wymagania i zasady utrzymania statusu zweryfikowanego.
---

Шаг 6: Переведите пункты бокового меню

Откройте astro.config.mjs и добавьте переводы для тех руководств, над которыми вы работали:

{
  slug: 'web-docs/vtc-programs/verified',
  label: 'Verified VTC Program',
  translations: {
    pl: 'Zweryfikowany Program VTC',
  },
},

Шаг 7: Проверьте свою работу

Откройте превью-ссылку из pull request и перейдите на переведённую страницу, например /pl/web-docs/vtc-programs/verified/.

Убедитесь, что:

Весь контент переведён
Ссылки работают корректно
Форматирование сохранено
Изображения отображаются правильно
Подписи в боковом меню переведены

Шаг 8: Отправьте Pull Request

Закоммитьте изменения с понятным сообщением:
```
docs(pl): translate verified VTC program guide
```
Отправьте коммит в свой форк
Откройте Pull Request в ветку main оригинального репозитория
Опишите, что именно вы перевели, и добавьте примечания для проверяющих

Стандарты перевода

Точность

Переводите смысл, а не слово в слово
Сохраняйте техническую точность
Оставляйте форматирование, ссылки и общую структуру идентичными оригиналу

Тон

Соответствуйте оригинальной интонации (профессиональной, но дружелюбной)
Изучайте принципы инклюзивного языка
Избегайте лишнего сленга, если он не используется в оригинале

Терминология

Используйте единообразные переводы для ключевых терминов TrucklineMP. Если сомневаетесь, укажите английский термин в скобках при первом упоминании:

Английский	Вариант для польского
Virtual Trucking Company (VTC)	Wirtualna Firma Transportowa (VTC)
Verified	Zweryfikowany
Partnered	Partnerski
Member	Członek
Role	Rola
Recruitment	Rekrutacja
Profile	Profil
Two-Factor Authentication	Uwierzytelnianie Dwuskładnikowe

Код и URL-адреса

Строго запрещается переводить:

URL-адреса
Пути к файлам
Фрагменты кода
Адреса электронной почты
Ссылки-приглашения в Discord
Названия технических параметров

Ссылки

Внутренние ссылки должны вести на переведённую версию страницы (если она существует)
Пример: /web-docs/vtc-programs/verified/ → /pl/web-docs/vtc-programs/verified/
Внешние ссылки должны оставаться без изменений

Изображения

Не переводите названия файлов изображений
Альтернативный текст должен быть переведён
Если скриншот содержит текст, рассмотрите возможность сделать локализованную версию изображения

Контрольный список качества

Перед отправкой перевода убедитесь, что:

Метаданные сохранены и переведены
Все заголовки переведены
Весь основной текст переведён
Ссылки указывают на правильную локаль
Блоки кода и URL-адреса оставлены без изменений
Ярлыки бокового меню обновлены в astro.config.mjs
Страница корректно отображается на локальном сервере разработки
Нет сломанной разметки или ошибок Markdown
Терминология едина во всём тексте

Обновление переводов

Когда исходный английский текст обновляется, переводы могут устаревать. Помогайте поддерживать их в актуальном состоянии:

Отслеживайте изменения в исходных английских файлах
Вносите аналогичные правки в переведённые файлы
При необходимости обновляйте метаданные в шапке
Отправляйте Pull Request с чётким описанием проделанной работы

Добавление нового языка

Вы можете переводить документацию на любой язык. Если ваш язык ещё не поддерживается, вы можете добавить его сами.

Шаги

Свяжитесь с командой в Discord, чтобы сообщить, что вы работаете над новым языком
Мы добавим локаль в astro.config.mjs
Создайте папку локали внутри каталога src/content/docs/ (например, de/ для немецкого)
Переведите основные руководства
Отправьте Pull Request

Нет жёсткого правила касательно того, сколько страниц нужно перевести для внедрения языка, но мы рекомендуем начать как минимум с:

Главная страница (index.mdx)
Verified VTC Program
Partnered VTC Program
VTC General Settings
Profile Settings

Настройка локали

Новые локали регистрируются в файле astro.config.mjs:

locales: {
  root: {
    label: 'English',
    lang: 'en',
  },
  pl: {
    label: 'Polski',
    lang: 'pl',
  },
  de: {
    label: 'Deutsch',
    lang: 'de',
  },
  fr: {
    label: 'Français',
    lang: 'fr',
  },
  ru: {
    label: 'Русский',
    lang: 'ru',
  },
  ta: {
    label: 'தமிழ்',
    lang: 'ta',
  },
  tr: {
    label: 'Türkçe',
    lang: 'tr',
  },
},

Убедитесь, что используете правильный языковой тег BCP 47 для вашей локали.

Частые ошибки

Перевод URL-адресов

❌ /pl/przewodniki/zweryfikowany-program-vtc/
✅ /pl/web-docs/vtc-programs/verified/

Забытые метаданные

❌ Отсутствие title или description
✅ Полностью заполненный frontmatter на целевом языке

Непоследовательная терминология

❌ Использование слова «weryfikacja» в одном месте и «zweryfikowanie» в другом
✅ Единый термин на протяжении всего руководства

Поломка синтаксиса Markdown

❌ Удаление символов # из заголовков или повреждение структуры таблиц
✅ Строгое сохранение всей разметки Markdown

Получение помощи

Если у вас возникли вопросы по поводу перевода:

Discord: https://discord.gg/trucklinemp
GitHub Issues: Откройте задачу в репозитории документации
Обсуждение Pull Request: Оставляйте комментарии в существующих PR для получения обратной связи

Признание заслуг

Имена переводчиков и участников проекта указываются на странице Участники. Спасибо, что помогаете сделать TrucklineMP доступным для каждого!