Gestión de contenido multilingüe

Esta guía explica cómo gestionar y mantener contenido multilingüe en nuestra plataforma, asegurando que todas las versiones de idioma permanezcan sincronizadas y consistentes.

Idiomas soportados

La plataforma actualmente soporta los siguientes idiomas:

Chino simplificado (zh) - Idioma principal
Chino tradicional (zh-Hant) - Versión china tradicional
Inglés (en) - Idioma internacional
Japonés (ja) - Para usuarios japoneses
Coreano (ko) - Para usuarios coreanos
Francés (fr) - Para usuarios franceses
Alemán (de) - Para usuarios alemanes
Español (es) - Para usuarios españoles
Indonesio (id) - Para usuarios indonesios
Portugués brasileño (pt-BR) - Para usuarios brasileños
Ruso (ru) - Para usuarios rusos
Turco (tr) - Para usuarios turcos

Estructura de directorios

El contenido multilingüe está organizado en la siguiente estructura:

content/
├── zh/                    # Chino simplificado (idioma principal)
│   ├── 01.docs/          # Documentación
│   ├── 02.guides/        # Guías
│   └── 03.tools/         # Herramientas
├── en/                    # Inglés
├── ja/                    # Japonés
├── ko/                    # Coreano
├── fr/                    # Francés
├── de/                    # Alemán
├── es/                    # Español
├── id/                    # Indonesio
├── pt-BR/                 # Portugués brasileño
├── ru/                    # Ruso
├── tr/                    # Turco
└── zh-Hant/               # Chino tradicional

Principios de sincronización de contenido

1. Prioridad del idioma principal

El chino simplificado (zh) es el idioma principal, todo el contenido nuevo se crea primero en la versión china
Las otras versiones de idioma se traducen basándose en la versión china

2. Consistencia de estructura de archivos

Todas las versiones de idioma deben mantener la misma estructura de directorios
Los nombres de archivos y rutas deben ser completamente consistentes
Asegurar que cada versión de idioma tenga archivos correspondientes

3. Completitud de contenido

Los documentos importantes deben tener versiones correspondientes en todos los idiomas
Priorizar la traducción de funcionalidades principales y guías de usuario
La documentación técnica puede ser prioritaria para el idioma principal

Flujo de trabajo de traducción

1. Creación de contenido

Crear nuevo contenido en la versión china
Asegurar que la estructura del contenido sea clara y fácil de traducir
Usar formato Markdown estándar

2. Prioridad de traducción

Alta prioridad:

Texto de interfaz de usuario
Preguntas frecuentes
Guías de inicio rápido
Documentación de funcionalidades principales

Prioridad media:

Documentación técnica detallada
Documentación de referencia API
Guías de configuración

Baja prioridad:

Documentación de funcionalidades avanzadas
Documentación de herramientas de desarrollador
Comentarios de código de ejemplo

3. Verificación de calidad de traducción

Asegurar precisión y completitud de la traducción
Mantener consistencia de términos técnicos
Verificar errores de gramática y ortografía
Verificar enlaces y referencias

Herramientas de automatización

Script de verificación de contenido multilingüe

Usar el script de verificación integrado para verificar el estado de sincronización del contenido:

# Verificar estado de sincronización de contenido para todos los idiomas
node scripts/multilingual-content.js check

# Crear estructura de archivos faltante
node scripts/multilingual-content.js init

# Crear páginas de bienvenida
node scripts/multilingual-content.js welcome