Locales
Les champs texte et prose peuvent contenir une valeur pour chaque locale. Une lecture demande une langue, et une chaîne de repli décide quoi servir pour tout champ qui n'a pas de traduction dans cette langue.
Ce qui se traduit
Les champs texte et prose contiennent une valeur par locale où qu'ils se trouvent : en haut d'un enregistrement, dans un modèle en ligne, dans un élément de liste, ou dans un modèle placé dans un champ prose. Tous les autres types de champ, y compris les nombres, les dates, les références et les médias, ont une seule valeur partagée par toutes les locales. Le texte alternatif d'une image fait partie de la valeur de l'image, il est donc partagé aussi.
Configurer les locales
Les locales sont des codes BCP-47 configurés par projet. L'une est la locale par défaut, la langue dans laquelle vous rédigez, et chacune peut nommer une locale de repli. Un repli qui nomme une locale que le projet n'a pas, qui pointe vers lui-même ou qui ferme une boucle est refusé à la sauvegarde.
Les traductions sont écrites dans l'éditeur d'enregistrement de la console ou par un agent IA via MCP. L'API GraphQL et le SDK lisent les traductions et ne les écrivent pas.
La chaîne de repli
Passez locale sur une lecture et chaque champ est résolu séparément, dans cet ordre : la locale demandée, ses replis configurés tour à tour, les locales les plus proches du projet dans la même langue écrite, la locale par défaut du projet, puis la valeur d'origine. Le premier qui a une valeur est servi, de sorte qu'un enregistrement partiellement traduit peut renvoyer son titre dans une locale et son corps dans une autre.
L'étape de la correspondance la plus proche reste dans un même standard écrit : une demande en pt-PT n'est servie avec le contenu pt-BR que si vous avez défini ce repli vous-même. Une locale que le projet n'a pas configurée renvoie quand même du contenu, qui se termine à la locale par défaut.
Repérer les lacunes
Définissez localeStrict sur une lecture et la réponse liste les champs qui n'avaient pas de traduction, et signale une locale non configurée comme une erreur. resolutionTrace renvoie tout le parcours et demande une clé avec la portée de débogage du ciblage. Aucun des deux ne change le contenu servi.
Lire le détail
Le guide de localisation couvre les paramètres de locale, l'ordre de repli, et les options strict et trace pour vérifier ce qu'une lecture a servi.