Gestion de contenu multilingue

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

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 internationale
Japonais (ja) - Pour les utilisateurs japonais
Coréen (ko) - Pour les utilisateurs coréens
Français (fr) - Pour les utilisateurs français
Allemand (de) - Pour les utilisateurs allemands
Espagnol (es) - Pour les utilisateurs espagnols
Indonésien (id) - Pour les utilisateurs indonésiens
Portugais brésilien (pt-BR) - Pour les utilisateurs brésiliens
Russe (ru) - Pour les utilisateurs russes
Turc (tr) - Pour les 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, 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épertoire
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 prioritaire pour la langue principale

Workflow de traduction

1. Création de contenu

Créer du 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

Priorité élevée :

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

Priorité faible :

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

3. Vérification de la 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
Vérifier les liens et références

Outils d'automatisation

Script de vérification du contenu multilingue

Utilisez le script de vérification intégré pour vérifier le statut de synchronisation du contenu :

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

# Créer la structure de fichiers manquante
node scripts/multilingual-content.js init

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