Ignorer des clés
Déconseillé
Cette documentation couvre l’ancien CLI (v0). La version actuelle du CLI est la v1. Voir la documentation actuelle du CLI
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 :
json
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"ignoredKeys": ["internal/debug", "dev/testData"]
}
}
}Fonctionnement#
Prenons ce fichier source :
json
{
"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 :
json
{
"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 :
json
{ "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 |