Gestion du Contenu Multilingue

Ce guide explique comment gérer et maintenir le contenu multilingue sur notre plateforme, en s'assurant que le contenu de toutes les versions linguistiques reste synchronisé et cohérent.

Langues Supportées

La plateforme prend actuellement en charge les langues suivantes :

Chinois Simplifié (zh) - Langue principale
Chinois Traditionnel (zh-Hant) - Version chinoise traditionnelle
Anglais (en) - Langue commune internationale
Japonais (ja) - Utilisateurs japonais
Coréen (ko) - Utilisateurs coréens
Français (fr) - Utilisateurs français
Allemand (de) - Utilisateurs allemands
Espagnol (es) - Utilisateurs espagnols
Indonésien (id) - Utilisateurs indonésiens
Portugais Brésilien (pt-BR) - Utilisateurs brésiliens
Russe (ru) - Utilisateurs russes
Turc (tr) - Utilisateurs turcs

Structure des Répertoires

Le contenu multilingue est organisé selon la structure suivante :

content/
├── zh/                    # Chinois Simplifié (langue principale)
│   ├── 01.docs/          # Documentation
│   ├── 02.guides/        # Guides
│   └── 03.tools/         # Outils
├── en/                    # Anglais
├── ja/                    # Japonais
├── ko/                    # Coréen
├── fr/                    # Français
├── de/                    # Allemand
├── es/                    # Espagnol
├── id/                    # Indonésien
├── pt-BR/                 # Portugais Brésilien
├── ru/                    # Russe
├── tr/                    # Turc
└── zh-Hant/               # Chinois Traditionnel

Principes de Synchronisation du Contenu

1. Priorité de la Langue Principale

Le Chinois Simplifié (zh) est la langue principale, et tout nouveau contenu est d'abord créé dans la version chinoise
Les autres versions linguistiques sont traduites sur la base de la version chinoise

2. Cohérence de la Structure des Fichiers

Toutes les versions linguistiques doivent maintenir la même structure de répertoires
Les noms de fichiers et les chemins doivent être complètement cohérents
S'assurer que chaque version linguistique a des fichiers correspondants

3. Complétude du Contenu

Les documents importants doivent avoir des versions correspondantes dans toutes les langues
Prioriser la traduction des fonctionnalités principales et des guides utilisateur
La documentation technique peut être priorisée pour les langues principales

Flux de Travail de Traduction

1. Création de Contenu

Créer un nouveau contenu dans la version chinoise
S'assurer que la structure du contenu est claire et facile à traduire
Utiliser le format Markdown standard

2. Priorité de Traduction

Haute Priorité :

Texte de l'interface utilisateur
Questions fréquemment posées
Guides de démarrage rapide
Documentation des fonctionnalités principales

Priorité Moyenne :

Documentation technique détaillée
Documentation de référence API
Guides de configuration

Faible Priorité :

Documentation des fonctionnalités avancées
Documentation des outils développeur
Commentaires de code d'exemple

3. Contrôle Qualité de Traduction

S'assurer de l'exactitude et de la complétude de la traduction
Maintenir la cohérence des termes techniques
Vérifier les erreurs de grammaire et d'orthographe
Valider les liens et références

Outils d'Automatisation

Script de Vérification du Contenu Multilingue

Utiliser le script de vérification intégré pour valider l'état de synchronisation du contenu :

# Vérifier l'état de synchronisation du contenu pour toutes les langues
node scripts/multilingual-content.js check

# Créer les structures de fichiers manquantes
node scripts/multilingual-content.js init

# Créer les pages d'accueil
node scripts/multilingual-content.js welcome