Locales

Qué se traduce

Los campos de texto y de prosa contienen un valor por locale dondequiera que estén: en la raíz de un registro, dentro de un modelo en línea, en un elemento de lista o en un modelo colocado en un campo de prosa. Todos los demás tipos de campo, incluidos números, fechas, referencias y medios, tienen un valor compartido por todos los locales. El texto alternativo de una imagen forma parte del valor de la imagen, así que también se comparte.

Configurar locales

Los locales son códigos BCP-47 configurados por proyecto. Uno es el predeterminado, el idioma en el que escribes, y cada uno puede nombrar un locale de reserva. Una reserva que nombra un locale que el proyecto no tiene, que apunta a sí misma o que cierra un bucle se rechaza al guardar.

Las traducciones se escriben en el editor de registros de la consola o por un agente de IA mediante MCP. La API GraphQL y el SDK leen las traducciones y no las escriben.

La cadena de reserva

Pasa locale en una lectura y cada campo se resuelve por separado, en este orden: el locale que pediste, sus reservas configuradas por turno, los locales más cercanos del proyecto en el mismo idioma escrito, el predeterminado del proyecto y, por último, el valor original. Se sirve el primero que tenga un valor, de modo que un registro traducido solo en parte puede devolver su título de un locale y su cuerpo de otro.

El paso de la coincidencia más cercana se queda dentro de un estándar escrito: una solicitud de pt-PT recibe copia de pt-BR solo si tú mismo fijas esa reserva. Un locale que el proyecto no ha configurado sigue devolviendo contenido, que termina en el predeterminado.

Encontrar las lagunas

Fija localeStrict en una lectura y la respuesta lista los campos que no tenían traducción, e informa de un locale no configurado como un error. resolutionTrace devuelve el recorrido completo y necesita una clave con el alcance de depuración de segmentación. Ninguno de los dos cambia el contenido servido.