Ignorer des clés

Mis à jour le : le trimestre dernier · 1 min de lecture

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ésVerrouillage des clés
Apparaît dans les fichiers ciblesNonOui — avec la valeur source
Cas d'usageDébogage, tests, contenu interneNoms de marque, identifiants techniques

Étapes suivantes#