Locale

Cosa si traduce

I campi text e prose contengono un valore per locale ovunque si trovino: al livello superiore di un record, dentro un modello inline, in un elemento di una lista o in un modello inserito in un campo prose. Ogni altro tipo di campo, compresi numeri, date, riferimenti e media, ha un solo valore condiviso da tutti i locale. Anche il testo alternativo delle immagini fa parte del valore dell'immagine, quindi è condiviso.

Configurare i locale

I locale sono codici BCP-47 configurati per progetto. Uno è quello predefinito, la lingua in cui scrivi, e ognuno può indicare un locale di fallback. Un fallback che indica un locale che il progetto non ha, che punta a se stesso o che chiude un ciclo viene rifiutato al salvataggio.

Le traduzioni si scrivono nell'editor dei record della console o con un agente AI tramite MCP. L'API GraphQL e l'SDK leggono le traduzioni ma non le scrivono.

La catena di fallback

Passa locale in una lettura e ogni campo viene risolto separatamente, in quest'ordine: il locale richiesto, i suoi fallback configurati a turno, i locale più vicini del progetto nella stessa lingua scritta, il valore predefinito del progetto, poi il valore di origine. Viene servito il primo che ha un valore, quindi un record tradotto in parte può restituire il titolo da un locale e il corpo da un altro.

Il passaggio della corrispondenza più vicina resta dentro uno standard scritto: una richiesta per pt-PT riceve una copia pt-BR solo se imposti tu quel fallback. Un locale che il progetto non ha configurato restituisce comunque contenuto, fino al valore predefinito.

Trovare le lacune

Imposta localeStrict in una lettura e la risposta elenca i campi che non avevano traduzione, e segnala come errore un locale non configurato. resolutionTrace restituisce l'intero percorso e richiede una chiave con lo scope di debug del targeting. Nessuno dei due cambia il contenuto servito.