Gestión de Contenido Multilingüe

Nuestra plataforma soporta múltiples idiomas para que los usuarios de todo el mundo puedan tener una buena experiencia. Este documento detalla cómo usar nuestro sistema de traducción i18n para gestionar contenido multilingüe.

Idiomas Soportados

Actualmente soportamos los siguientes idiomas:

🇺🇸 English (en) - Idioma por defecto
🇨🇳 简体中文 (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)

Estructura de Directorios

El contenido multilingüe se organiza de la siguiente manera:

content/
├── en/          # Inglés (idioma base)
├── zh/          # Chino simplificado
├── ja/          # Japonés
├── ko/          # Coreano
├── fr/          # Francés
├── de/          # Alemán
├── zh-Hant/     # Chino tradicional
├── es/          # Español
├── id/          # Indonesio
├── pt-BR/       # Portugués brasileño
├── ru/          # Ruso
└── tr/          # Turco

Cada directorio de idioma mantiene la misma estructura de subdirectorios:

{lang}/
├── 01.docs/           # Documentación principal
│   ├── 01.welcome/    # Guías de bienvenida
│   ├── 02.features/   # Características
│   ├── 03.api/        # Documentación de API
│   ├── 04.examples/   # Ejemplos
│   ├── 05.faq/        # Preguntas frecuentes
│   └── 06.troubleshooting/ # Solución de problemas
├── 02.guides/         # Guías de usuario
└── 03.tools/          # Documentación de herramientas

Principios de Sincronización

1. Consistencia Estructural

Todos los idiomas deben mantener la misma estructura de directorios
Los nombres de archivos deben ser idénticos en todos los idiomas
Las rutas de navegación deben ser consistentes

2. Sincronización de Contenido

Cuando se añade nuevo contenido en el idioma base (inglés), debe traducirse a todos los idiomas soportados
Las actualizaciones de contenido deben aplicarse a todos los idiomas simultáneamente
Mantener versiones de documentos sincronizadas

3. Gestión de Frontmatter

Cada archivo Markdown debe incluir frontmatter con metadatos:

---
title: Título del Documento
description: Descripción breve del contenido
---

Flujo de Trabajo de Traducción

1. Identificación de Contenido Nuevo

Usar el script multilingual-content.js para verificar la sincronización
Identificar archivos faltantes en cada idioma
Priorizar contenido crítico para la experiencia del usuario

2. Proceso de Traducción

Preparación: Leer el contenido original en inglés
Traducción: Traducir manteniendo el significado y contexto
Revisión: Verificar precisión técnica y fluidez
Prueba: Verificar que el contenido se renderiza correctamente

3. Herramientas de Automatización

Script de Verificación

# Verificar estado de sincronización
node scripts/multilingual-content.js check

# Crear estructura de idioma
node scripts/multilingual-content.js init {lang}

# Crear página de bienvenida
node scripts/multilingual-content.js welcome {lang}