Управление многоязычным контентом

Наша платформа поддерживает несколько языков, чтобы пользователи по всему миру могли получить хороший опыт. Этот документ подробно описывает, как использовать нашу систему перевода i18n для управления многоязычным контентом.

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

В настоящее время мы поддерживаем следующие языки:

🇺🇸 English (en) - Язык по умолчанию
🇨🇳 简体中文 (zh)
🇯🇵 日本語 (ja)
🇰🇷 한국어 (ko)
🇫🇷 Français (fr)
🇩🇪 Deutsch (de)
🇹🇼 繁體中文 (zh-Hant)
🇪🇸 Español (es)
🇮🇩 Bahasa Indonesia (id)
🇧🇷 Português do Brasil (pt-BR)
🇷🇺 Русский (ru)
🇹🇷 Türkçe (tr)

Структура директорий

Многоязычный контент организован следующим образом:

content/
├── en/          # Английский (базовый язык)
├── zh/          # Упрощенный китайский
├── ja/          # Японский
├── ko/          # Корейский
├── fr/          # Французский
├── de/          # Немецкий
├── zh-Hant/     # Традиционный китайский
├── es/          # Испанский
├── id/          # Индонезийский
├── pt-BR/       # Бразильский португальский
├── ru/          # Русский
└── tr/          # Турецкий

Каждый языковой каталог поддерживает одинаковую структуру подкаталогов:

{lang}/
├── 01.docs/           # Основная документация
│   ├── 01.welcome/    # Руководства по началу работы
│   ├── 02.features/   # Функции
│   ├── 03.api/        # Документация API
│   ├── 04.examples/   # Примеры
│   ├── 05.faq/        # Часто задаваемые вопросы
│   └── 06.troubleshooting/ # Устранение неполадок
├── 02.guides/         # Руководства пользователя
└── 03.tools/          # Документация инструментов

Принципы синхронизации

1. Структурная согласованность

Все языки должны поддерживать одинаковую структуру каталогов
Имена файлов должны быть идентичными на всех языках
Маршруты навигации должны быть согласованными

2. Синхронизация контента

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

3. Управление Frontmatter

Каждый файл Markdown должен включать frontmatter с метаданными:

---
title: Заголовок документа
description: Краткое описание содержимого
---

Рабочий процесс перевода

1. Идентификация нового контента

Использовать скрипт multilingual-content.js для проверки синхронизации
Определить отсутствующие файлы на каждом языке
Приоритизировать критический контент для пользовательского опыта

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

Подготовка: Прочитать оригинальный контент на английском языке
Перевод: Перевести, сохраняя значение и контекст
Обзор: Проверить техническую точность и беглость
Тестирование: Убедиться, что контент отображается правильно

3. Инструменты автоматизации

Скрипт проверки

# Проверить статус синхронизации
node scripts/multilingual-content.js check

# Создать структуру языка
node scripts/multilingual-content.js init {lang}

# Создать страницу приветствия
node scripts/multilingual-content.js welcome {lang}