Guida · Valori sorgente
Aggiornare il valore sorgente di una chiave
Inizializzare una chiave con create_key o create_keys_bulk imposta il suo valore sorgente una sola volta. Rilanciare con un source_value modificato non fa nulla, per progettazione, affinché un seed automatizzato non sovrascriva mai il testo sorgente. Ecco come cambiare deliberatamente la sorgente di una chiave dopo la sua creazione.
Il no-op che incontrerete
create_key e create_keys_bulk accettano un source_value, ma lo onorano solo alla creazione della chiave. Richiamateli su una chiave che esiste già e il nuovo source_value viene silenziosamente ignorato, la chiamata riesce comunque, la chiave torna con created: false e il testo sorgente resta invariato.
create_keys_bulk 1// create_keys_bulk, source_value on a key that ALREADY exists2{ "items": [3 { "namespace": "common", "name": "checkout.title",4 "source_value": "Checkout" }5] } 7// → no update_source: the existing source is left untouched8{ "results": [{ "index": 0, "status": "ok", "created": false }] }Soluzione: update_source
Aggiungete update_source: true alla chiave, è un campo per chiave (su create_key, o su ogni voce items[] di create_keys_bulk), mai un flag globale. Il valore sorgente viene allora aggiornato anche su una chiave esistente (created resta false). È opt-in: un re-seed di routine non cambia mai il testo sorgente per sbaglio.
create_keys_bulk 1// update_source is a PER-ITEM flag, never a global one2{ "items": [3 { "namespace": "common", "name": "checkout.title",4 "source_value": "Checkout", "update_source": true }5] } 7// → created:false (the key existed) but the source is now upserted8{ "results": [{ "index": 0, "status": "ok", "created": false }] }Entrambi passano attraverso la superficie MCP (una chiave con scope mcp:*), e il progetto deve già avere una lingua sorgente. La modifica incrementa la versione ed è registrata nella cronologia della chiave.
Oppure reimportare la lingua sorgente
L'import i18next in un'unica passata aggiorna anche i valori sorgente. Reimportare i vostri file della lingua sorgente aggiorna tutte le sorgenti esistenti in un'unica chiamata, comodo quando il testo sorgente vive già nel vostro repository.
terminal 1# or re-import your source-language files, import upserts source values2sonenta import "./locales/en/**/*.json" # en = your source languageCosa cambia
- Versionato e auditato. La nuova sorgente è una normale modifica versionata, attribuita alla vostra chiave API, e appare nella cronologia della chiave.
- Gli eventi di chiave mancante si risolvono. Gli eventi di chiave mancante aperti per queste chiavi si risolvono automaticamente non appena arriva un vero valore sorgente.
- Opt-in per progettazione. Senza
update_source, unsource_valuesu una chiave esistente resta ignorato, rilanciare il vostro script di seed non sovrascrive mai il testo sorgente per sbaglio.