無視されたキーは、翻訳処理の対象から完全に外れます。ターゲットファイルには含まれず、CLI はコンテンツ検出時にそれらをスキップし、翻訳バックエンドに送信することもありません。
設定#
バケット内の ignoredKeys に i18n.json を追加します。
json
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"ignoredKeys": ["internal/debug", "dev/testData"]
}
}
}仕組み#
たとえば、次のようなソースファイルがあるとします。
json
{
"welcome": "Welcome to our platform",
"internal": {
"debug": "Debug mode enabled",
"testData": "Sample test content"
}
}"ignoredKeys": ["internal/debug", "internal/testData"] を指定すると、スペイン語のターゲットファイルは次のようになります。
json
{
"welcome": "Bienvenido a nuestra plataforma"
}ターゲットファイルでは、internal セクション全体が削除されます。
キーパス記法#
ネストされたキーにはスラッシュ (/)、ワイルドカードにはアスタリスク (*) を使います。
json
{ "ignoredKeys": ["internal/*", "dev/settings"] }ドットを含むキーもそのまま扱えます。dev/api.mock を使うと、"dev" 内の "api.mock" を指定できます。
キーの無視とキーのロックの違い#
| キーの無視 | キーのロック | |
|---|---|---|
| ターゲットファイルに含まれるか | いいえ | はい - ソース値のまま |
| 主な用途 | デバッグ、テスト、内部向けコンテンツ | ブランド名、技術的なID |
