Formats

Trouvez le gestionnaire de format qui traduit votre texte tout en préservant la structure dont votre application a besoin.

Un fichier de langue contient bien plus que des mots. Ses clés relient les messages au code, ses espaces réservés reçoivent les valeurs de l’application et sa structure indique au framework comment charger le résultat. Un document y ajoute des titres, des liens, des exemples et des métadonnées. Traduire un fichier, c’est changer de langue sans rompre ces liens.

Lingo.dev utilise un gestionnaire de format pour sélectionner le texte à traduire et reconstruire le résultat. Choisissez ce gestionnaire en fonction du rôle du fichier. Un catalogue Rails et une spécification OpenAPI peuvent tous deux avoir l’extension .yml, mais traduire toutes leurs chaînes poserait des problèmes différents : la racine de langue d’un catalogue Rails doit changer, tandis que les identifiants d’opération d’une API doivent rester inchangés.

Trouvez votre format #

SourceType de gestionnaireRéférence
Catalogue JSON imbriquéjsonJSON
JSON avec commentaires de contextejsoncJSONC
Catalogue YAMLyamlYAML
YAML avec une seule racine de langueyaml-root-keyYAML avec racine de langue
Module de langue statique en TypeScripttypescriptTypeScript
Tableau de langue statique en PHPphpPHP
Document MarkdownmdMarkdown
Markdown avec composants JSXmdxMDX
Document MarkdocmarkdocMarkdoc
OpenAPI 3.x en YAMLyaml-openapiOpenAPI
Ressources Android en XMLandroidAndroid
Ensemble de ressources d’application FlutterflutterFlutter ARB
Table de chaînes Applexcode-stringsChaînes Apple
Fichier plist Apple de ressources de formes pluriellesxcode-stringsdictApple stringsdict
Catalogue Apple multilinguexcode-xcstringsCatalogues de chaînes Apple
Catalogue PO GettextpoGettext
Document d’échange XLIFFxliffXLIFF
Sous-titres SubRipsrtSubRip
Texte brut, traduit ligne par lignetxtTexte brut
Document ou fragment HTMLhtmlHTML
Tableau CSV avec une colonne par languecsvCSV
Ensemble de ressources Java au format propertiespropertiesFichiers properties Java
Champs sélectionnés de Payload CMSpayloadPayload

Les pages de référence présentent les gestionnaires de fichiers existants et leurs limites en matière d’extraction et de reconstruction. La CLI et la GitHub App acceptent les 22 types configurés listés ci-dessus, à l’exception de Payload. Le format HTML est déduit de .html et .htm ; le fichier de sortie préserve le contenu source non modifié et, lorsqu’un élément <html> est explicitement présent, définit son attribut lang sur la langue cible. Sélectionnez explicitement la variante YAML ou le format Android souhaité dans la configuration du dépôt. Comme les catalogues de chaînes Apple, le format CSV conserve toutes les langues dans le fichier source. Le guide de démarrage rapide de la CLI vous accompagne pas à pas avec un fichier, de la configuration à la récupération ; la page GitHub détaille le workflow géré pour les dépôts.

Les connexions actuelles aux fournisseurs sélectionnent et écrivent le contenu selon leurs propres contrats d’intégration.

Pour traduire directement des données structurées, envoyez du JSON intégré. Pour importer des fichiers sources tout en conservant leurs formats, suivez le guide Documents sous forme de fichiers. Les deux méthodes utilisent le même cycle de vie des tâches de traduction.

Conservez la révision source avec ses traductions #

La traduction incrémentale de fichiers compare la source actuelle à une source précédente et utilise la version cible existante correspondante. Ces éléments permettent de conserver les formulations acceptées pour les messages inchangés, tout en traduisant les messages nouveaux ou modifiés.

Les clés donnent tout son intérêt à cette comparaison : checkout.title et account.title peuvent contenir exactement le même texte anglais tout en conservant des traductions différentes. Les positions dans les tableaux, les numéros des séquences de sous-titres, les positions des lignes de texte brut et la structure du document interviennent aussi dans la mise en correspondance. Déplacer un élément ou réorganiser un document traduit peut modifier cette correspondance : conservez donc chaque version cible avec la révision source qui a servi à la produire.

La plupart des formats produisent un fichier distinct pour chaque langue cible. Les catalogues de chaînes Apple, eux, regroupent les langues dans le fichier source. Un artefact Payload ou un catalogue de chaînes peut aussi contenir certaines valeurs cibles sans être complet. Vérifiez les entrées cibles elles-mêmes, pas seulement l’existence du fichier.

Contrôlez séparément la sélection du texte et la sortie #

Exclure du texte de la traduction peut recouvrir plusieurs réalités. Une valeur de catalogue verrouillée provient de la source ; une valeur préservée provient de la version cible existante ; une valeur ignorée peut disparaître de la sortie. Le format et l’interface d’appel déterminent les options de contrôle disponibles.

Utilisez les périmètres de clés de la CLI pour JSON/JSONC, YAML, YAML avec racine de langue, PHP et TypeScript. Une mise à jour partielle conserve les formulations cibles existantes en dehors de la sélection, mais le traitement des entrées présentes uniquement dans la source et des positions dans les tableaux dépend du format. Examinez l’ensemble du résultat en vous appuyant sur la référence du format.

Le comportement des métadonnées de contexte est tout aussi spécifique. Un commentaire JSONC @context décrit la valeur de chaîne suivante. Un @message.description ARB décrit le message associé. Le msgctxt Gettext distingue les messages et fournit du contexte. Les commentaires ordinaires peuvent être conservés lors de la reconstruction sans pour autant devenir des instructions de traduction. Les annotations @src et @orphan de React relèvent de son workflow de maintenance des catalogues.

Après avoir récupéré un fichier, chargez-le dans le système qui l’utilise. Vérifiez la langue sélectionnée, les variables, les formes plurielles, les liens et les données protégées, sans oublier le sens du texte traduit. Les guides d’application vous accompagnent dans ces vérifications pour les applications web, les ressources natives et le contenu statique.