Aller au contenu
DispatchAtlas
Rechercher

Traductions

Comment DispatchAtlas localise sa documentation : la cohorte de locales, la couverture actuelle, le pipeline de graine-machine plus revue-humaine, et comment contribuer une traduction.

DispatchAtlas sert sa documentation dans une cohorte de douze locales. L'anglais est la source ; chaque autre locale est une cible de traduction. Cette page déclare ce qui est traduit aujourd'hui, la discipline qui gouverne la qualité de traduction, et les étapes pour contribuer une traduction.

Cohorte de locales

Le site enregistre douze locales — l'anglais à la racine du site et onze cibles de traduction préfixées :

LocaleCodeDirection
Anglais (source)engauche-à-droite
Mandarin (simplifié)zh-cngauche-à-droite
Espagnolesgauche-à-droite
Portugais (Brésil)pt-brgauche-à-droite
Françaisfrgauche-à-droite
Allemanddegauche-à-droite
Japonaisjagauche-à-droite
Coréenkogauche-à-droite
Russerugauche-à-droite
Indonésienidgauche-à-droite
Arabeardroite-à-gauche
Hindihigauche-à-droite

Chaque page déclare son lang, l'arabe se rend en outre de droite-à-gauche, et un ensemble hreflang symétrique plus un x-default pointant vers la page en anglais lie la cohorte pour les moteurs de recherche. Un locale qui n'a pas encore traduit une page donnée omet l'entrée hreflang de cette page au lieu de la pointer vers l'anglais, de sorte que l'absence est rapportée avec précision.

Couverture actuelle

L'habillage de l'interface — navigation, contrôles, recherche, et pied de page — est traduit à travers les douze locales. Les pages de documentation sont traduites de façon incrémentale ; une page sans traduction dans le locale demandé rend la source en anglais comme repli, de sorte qu'aucune route n'est jamais brisée. La couverture croît page-par-page sous le pipeline de revue ci-dessous ; le sélecteur de langue atteint toujours chaque page au moins dans sa forme anglaise.

Le pipeline de graine-machine plus revue-humaine

La qualité de traduction est un critère de publication, pas une réflexion après coup. Deux étapes gouvernent chaque page traduite :

  1. Graine machine. Une page est d'abord ébauchée par traduction automatique contre le glossaire par-locale, qui fixe le vocabulaire de domaine (planification, dispatch, benchmark, solveur, objectif, contrainte) à un terme cohérent par locale.
  2. Revue humaine. Un relecteur natif-courant corrige la graine pour la fluidité, la terminologie, et le ton avant qu'elle ne soit livrée. La copie à graine-machine n'est jamais publiée comme texte final non revu.

Une page est prête-pour-publication dans un locale seulement après qu'un relecteur l'a attestée. Jusque-là, le repli en anglais tient, qui est précis et complet plutôt que partiellement-traduit.

Contribuer une traduction

  1. Choisissez une page sous site/content/docs/en/ et le locale cible.
  2. Créez le chemin miroir sous site/content/docs/<locale>/ avec le même slug relatif et les mêmes clés de frontmatter (title, description).
  3. Traduisez le corps, en honorant le glossaire du locale pour que les termes de domaine restent cohérents avec le reste de ce locale.
  4. Gardez chaque bloc de code, commande, identifiant, cible de lien, et référence de figure identiques à la source — seule la prose en langage naturel est traduite.
  5. Ouvrez une contribution pour une revue native-courante. Une fois attestée, la page est livrée dans ce locale et son entrée hreflang est ajoutée à la cohorte.

Consultez le Guide de contribution pour le flux de travail du dépôt et le processus de revue qui s'applique à chaque changement.