Les clés ignorées sont totalement exclues du processus de traduction. Elles n'apparaissent pas dans les fichiers cibles — le CLI les ignore lors de la détection du contenu et ne les envoie jamais au backend de traduction.
Configuration#
Ajoutez ignoredKeys à un bucket dans i18n.json :
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"ignoredKeys": ["internal/debug", "dev/testData"]
}
}
}Fonctionnement#
Prenons ce fichier source :
{
"welcome": "Welcome to our platform",
"internal": {
"debug": "Debug mode enabled",
"testData": "Sample test content"
}
}Avec "ignoredKeys": ["internal/debug", "internal/testData"], le fichier cible en espagnol devient :
{
"welcome": "Bienvenido a nuestra plataforma"
}Toute la section internal est absente du fichier cible.
Notation des chemins de clés#
Utilisez la barre oblique (/) pour les clés imbriquées et l'astérisque (*) comme joker :
{ "ignoredKeys": ["internal/*", "dev/settings"] }Les clés contenant des points fonctionnent naturellement — dev/api.mock cible "api.mock" dans "dev".
Ignorer des clés vs verrouiller des clés#
| Ignorer des clés | Verrouillage des clés | |
|---|---|---|
| Apparaît dans les fichiers cibles | Non | Oui — avec la valeur source |
| Cas d'usage | Débogage, tests, contenu interne | Noms de marque, identifiants techniques |
