Skip to content

JSON ​

यह किसके लिए है: उन प्रोजेक्ट्स के लिए जो पहले से ही प्रति लोकैल नेस्टेड JSON फ़ाइलों में कॉपी रखते हैं (उदाहरण के लिए src/i18n/en/translation.json) और उस लेआउट को बनाए रखना चाहते हैं। यदि आपके स्रोत में सादा टेक्स्ट है और अभी तक कोई t() नहीं है, तो इसके बजाय Add i18n to a JS/TS app से शुरू करें।

सीएलआई उन फ़ाइलों में स्ट्रिंग मानों से होकर गुज़रता है, उन्हें सक्रिय LLM प्रोवाइडर पर मौजूद मॉडल से अनुवाद करता है, और json[].outputPathTemplate का उपयोग करके हर-लोकेल के आउटपुट लिखता है। यह translate-docs और translate-svg (cacheDir) के समान ही SQLite कैश का उपयोग करता है।

यह पाइपलाइन नहीं चलता extract — कोई strings.json कैटलॉग नहीं है। इसे features.translateJson और शीर्ष-स्तरीय json[] में एक या अधिक प्रविष्टियों के साथ सक्षम करें।

प्रति-स्थानीय मॉडल ओवरराइड ​

translate-json मॉडल को हर टारगेट लोकेल के अनुसार रिज़ॉल्व करता है: कॉन्फ़िगर किए जाने पर पहले localeModels(locale), फिर translationModels। इसका इस्तेमाल नेस्टेड JSON बंडल के लिए करें जहाँ कुछ लोकेल को डेडिकेटेड मॉडल से फ़ायदा होता है — उदाहरण के लिए zh-Hans / zh-Hant थीम फ़ाइलें। AI मॉडल देखें।

चरण 1: नेस्टेड JSON के लिए प्रारंभ करें ​

bash
ai-i18n-tools init -t ui-json-bundles -P ollama

वह टेम्पलेट features.translateJson: true सेट करता है, UI एक्सट्रैक्शन और दस्तावेज़ अनुवाद को अक्षम करता है, और आउटपुट src/i18n/{llocale}/translation.json के साथ src/i18n/en/translation.json पर इंगित करते हुए एक एकल json[] ब्लॉक तैयार करता है। इसमें उस प्रीसेट के लिए provider / providers ब्लॉक भी शामिल है जिसे आप -P के साथ पास करते हैं — translate-json या sync चलाने से पहले संबंधित API कुंजी सेट करें (या स्थानीय Ollama का उपयोग करें); प्रदाता और API कुंजी देखें। अपने रेपो लेआउट के लिए sourceLocale, targetLocales, contentPaths, और outputPathTemplate को संपादित करें।

चरण 2: json[] कॉन्फ़िगर करें ​

प्रत्येक json[] ब्लॉक एक पाइपलाइन का वर्णन करता है:

  • contentPaths — एक या अधिक .json फ़ाइलें, निर्देशिकाएँ, या ग्लोब (उदाहरण के लिए "src/i18n/en/translation.json" या "src/i18n/en/overrides/*.json")। पथ प्रोजेक्ट रूट से हल किए जाते हैं।
  • outputPathTemplate — आवश्यक। प्रत्येक लक्ष्य लोकेल फ़ाइल कहाँ लिखनी है। प्लेसहोल्डर: {locale}, {LOCALE}, {llocale} (लोअरकेस लोकेल, एस्ट्रो रूट फ़ोल्डरों के लिए उपयोगी), {stem}, {basename}, {extension}, {relativeToSourceRoot}।
  • targetLocales (वैकल्पिक) — केवल इस ब्लॉक के लिए उपसमूह; अन्यथा रूट targetLocales लागू होता है।
  • keyPolicy — कौन सी JSON कुंजियाँ अनुवाद योग्य गद्य बनाम स्थिर पहचानकर्ता रखती हैं (नीचे देखें)।
  • description (वैकल्पिक) — CLI हेडर और status आउटपुट में दिखाया गया है।

उदाहरण (कई स्रोत फ़ाइलें, लोअरकेस लोकेल फ़ोल्डर):

json
{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "pt-BR"],
  "features": {
    "translateJson": true
  },
  "cacheDir": ".translation-cache",
  "json": [
    {
      "description": "App UI bundle",
      "contentPaths": [
        "src/i18n/en/translation.json",
        "src/i18n/en/overrides/*.json"
      ],
      "outputPathTemplate": "src/i18n/{llocale}/{basename}",
      "keyPolicy": {
        "mode": "denylist",
        "skipKeys": ["id", "slug", "href", "url", "key", "code"],
        "translateKeys": []
      }
    }
  ]
}

keyPolicy

modeव्यवहार
allowlistकेवल translateKeys (डॉट पाथ; मिनिमैच ग्लोब) से मेल खाने वाली कुंजियाँ अनुवादित होती हैं।
denylistskipKeys से मेल खाने वाली कुंजियों को छोड़कर सभी स्ट्रिंग मानों का अनुवाद करें।
bothपहले translateKeys लागू करें, फिर skipKeys से मिलान हटाएँ।

पथ डॉट नोटेशन (nav.home.label) का उपयोग करते हैं। slug जैसा एक नंगे नाम किसी भी गहराई पर अंतिम कुंजी खंड से मेल खाता है।

चरण 3: JSON बंडलों का अनुवाद करें ​

bash
ai-i18n-tools translate-json

वैकल्पिक फ़्लैग (translate-docs जैसे ही विचार): लक्ष्यों के सबसेट के लिए -l / --locale, फ़ाइलों को सीमित करने के लिए -p / --path, --dry-run, --force (मिलान की गई फ़ाइलों के लिए फ़ाइल ट्रैकिंग और सेगमेंट कैश साफ़ करें), --force-update (फ़ाइल हैश मिलान होने पर फिर से प्रोसेस करें; सेगमेंट कैश अभी भी लागू होता है), --check-cache (देशी स्क्रिप्ट लागू करने वाले लोकेल के लिए कैश्ड सेगमेंट को फिर से मान्य करें, भले ही फ़ाइल ट्रैकिंग मेल खाती हो), -b / --batch-concurrency, --prompt-format (xml | json-array | json-object)।

केवल JSON प्रोजेक्ट चला सकते हैं:

bash
ai-i18n-tools sync --no-ui --no-svg --no-docs

जब UI या दस्तावेज़ भी सक्षम होते हैं, तो sync translate-docs के बाद translate-json चलाता है (जब तक --no-json नहीं)। --no-json के साथ JSON छोड़ें।

प्रति फ़ाइल और लोकेल कवरेज की जाँच करें:

bash
ai-i18n-tools status

जब translateJson चालू होता है, तो status एक json[] अनुभाग प्रिंट करता है (✓ अप टू डेट, ● बासी या गुम)।

JSON बनाम अन्य पाइपलाइनें ​

स्थितिउपयोग करें
JS/TS/Astro में t("…") / i18n.t("…") में UI स्ट्रिंगUI स्ट्रिंग — extract + translate-ui
Docusaurus write-translations कैटलॉग ({ "key": { "message": "…", "description": "…" } })दस्तावेज़ — docs[].docusaurusCatalogDir + translate-docs, नहीं json[]
VitePress थीम/नेविगेशन/साइडबार स्ट्रिंगदस्तावेज़ — docsOutput.vitepressThemeCatalog + translate-docs; json[] का उपयोग न करें — VitePress एकीकरण देखें
Nextra _meta.ts लेबल और थीम डिक्शनरी .tsदस्तावेज़ — translate-docs (style: "nextra" होने पर ऑटो _meta, वैकल्पिक nextraDictionaryPath); json[] का उपयोग न करें — Nextra एकीकरण देखें
Fumadocs meta.json लेबल और UI ओवरराइड कैटलॉगदस्तावेज़ — translate-docs (style: "fumadocs" होने पर ऑटो meta.json, वैकल्पिक fumadocsUiCatalog); json[] का उपयोग न करें — Fumadocs एकीकरण देखें
स्टैंडअलोन नेस्टेड लोकेल JSON (ZenBrowser-शैली translation.json ट्री)JSON — json[] + translate-json
i18next नेमस्पेस फ़ाइलें (public/locales/en/common.json, {{name}} टोकन, key_one / key_other प्रत्यय)JSON — json[] + translate-json (i18next नेमस्पेस फ़ाइलें देखें)
Intlayer *.content.ts डिक्शनरी + useIntlayer (Intlayer से बाहर निकलें)Intlayer से माइग्रेट करना — migrate-intlayer, फिर UI स्ट्रिंग्स
Intlayer *.content.ts डिक्शनरी (Intlayer रखें, अनुवाद भरें)Intlayer को यथास्थान अनुवादित करना — translate-intlayer
<text> / <title> / <desc> के साथ सचित्र .svg फ़ाइलेंfeatures.translateSVG + svg + translate-svg (वैकल्पिक; तीन मुख्य पाइपलाइनों में से एक नहीं)

फ़ील्ड संदर्भ: कॉन्फ़िगरेशन संदर्भ में json। सफाई के लिए कैश कुंजियाँ file_tracking में json-block:{blockIndex}:{projectRelPath} का उपयोग करती हैं।

i18next नेमस्पेस फ़ाइलें ​

JSON पाइपलाइन विशिष्ट i18next कुंजी/मान लोकैल फ़ाइलों को कवर करती है: नेस्टेड ऑब्जेक्ट्स, स्ट्रिंग एरेज़, मानों में {{name}} इंटरपोलेशन, और स्वतंत्र बहुवचन प्रत्यय कुंजियाँ (welcome_one, welcome_other)। यह t("some.key") कॉल साइट्स को फिर से नहीं लिखता है — वे कुंजी-आधारित रहती हैं। किसी प्रोजेक्ट को ai-i18n-tools के स्रोत-स्ट्रिंग t() स्कीमा पर ले जाने के लिए, कॉल साइट्स को t("source text") में बदलें। टेक्स्ट sourceLocale में लिखा गया है, जो कोई भी भाषा हो सकती है। जब स्रोत Intlayer .content.ts हो, तो migrate-intlayer चलाएँ। Intlayer को रखने और केवल उसकी डिक्शनरी का अनुवाद करने के लिए, translate-intlayer का उपयोग करें।

उदाहरण (public/locales/en/ के तहत स्रोत अंग्रेजी नेमस्पेस):

json
{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "pt-BR"],
  "features": { "translateJson": true },
  "json": [
    {
      "description": "i18next namespaces",
      "contentPaths": ["public/locales/en/*.json"],
      "outputPathTemplate": "public/locales/{locale}/{basename}"
    }
  ]
}

key_one / key_other / key_zero (और अन्य CLDR प्रत्यय) को अलग-अलग पत्तियों के रूप में अनुवादित किया जाता है। i18next के लिए प्रत्यय द्वारा बहुवचन को हल करते रहने के लिए यह पर्याप्त है; पाइपलाइन उन्हें एक ही कैटलॉग पंक्ति में पुनर्गठित नहीं करती है।

MIT लाइसेंस के तहत जारी किया गया।