Skip to content

कॉन्फ़िगरेशन संदर्भ ​

sourceLocale ​

स्रोत भाषा के लिए BCP-47 कोड (उदाहरण के लिए "en-GB", "pt-BR", या "ja")। कोई भी भाषा मान्य है। उदाहरणों में अंग्रेज़ी दिखाई देती है क्योंकि कई प्रोजेक्ट वहीं से शुरू होते हैं। इस लोकेल के लिए कोई अनुवाद फ़ाइल जनरेट नहीं की जाती — कुंजी स्ट्रिंग स्वयं स्रोत पाठ है।

आपके रनटाइम i18n सेटअप फ़ाइल (src/i18n.ts / src/i18n.js) से निर्यात किए गए SOURCE_LOCALE से मेल खाना चाहिए।


targetLocales ​

अनुवाद करने के लिए BCP-47 लोकेल कोड की सरणी (जैसे ["de", "fr", "es", "pt-BR"])।

targetLocales UI अनुवाद के लिए प्राथमिक लोकेल सूची है और दस्तावेज़ ब्लॉकों के लिए डिफ़ॉल्ट लोकेल सूची है। sourceLocale + targetLocales से ui-languages.json मैनिफ़ेस्ट बनाने के लिए generate-ui-languages का उपयोग करें।


uiLanguage (वैकल्पिक) ​

टूल की अपनी UI भाषा के लिए BCP-47 कोड (CLI सहायता, लॉग/सारांश, और अनुवाद डैशबोर्ड)। यह sourceLocale / targetLocales से स्वतंत्र है, और -L / --ui-lang फ़्लैग और AI_I18N_LANG पर्यावरण चर द्वारा ओवरराइड किया जाता है। अज्ञात मान स्रोत लोकेल (en-GB) में शालीनता से डिग्रेड होते हैं — कोई सख्त सत्यापन नहीं है। टूल UI भाषा देखें।


languagesManifestPath (वैकल्पिक) ​

रूट-स्तरीय वैकल्पिक स्ट्रिंग। डॉक्स भाषा स्विचर इस पथ को पढ़ता है। जब इसे छोड़ दिया जाता है, तो यह डिफ़ॉल्ट रूप से पहले UI ब्लॉक के मैनिफेस्ट पर सेट हो जाता है: उस ब्लॉक का languagesManifestPath, या {flatOutputDir}/ui-languages.json। प्रत्येक UI ब्लॉक अपना स्वयं का languagesManifestPath सेट कर सकता है; ब्लॉक 0 इस रूट पथ का उपयोग तब करता है जब ब्लॉक अपने स्वयं के पथ को छोड़ देता है।

इसका उपयोग तब करें जब:

  • मैनिफ़ेस्ट को ui.flatOutputDir के बाहर रहना चाहिए (उदाहरण के लिए src/i18n/ के तहत ऐप हेल्पर के बगल में)।
  • आप भाषा स्विचर पोस्ट-प्रोसेसिंग (languageListBlock) चाहते हैं कि वह केवल बंडल किए गए मास्टर कैटलॉग के बजाय प्रोजेक्ट मैनिफ़ेस्ट से लोकेल लेबल बनाए।

includeUiLanguageEnglishNames इस फ़ाइल को नहीं पढ़ता है — यह बंडल किए गए मास्टर कैटलॉग का उपयोग करता है (नीचे ui.uiExtractor देखें)।

लेगेसी: कॉन्फ़िग फ़ाइल लोड करते समय रूट-लेवल uiLanguagesPath अभी भी स्वीकार किया जाता है और स्वचालित रूप से languagesManifestPath में फिर से लिखा जाता है।


concurrency (वैकल्पिक) ​

एक ही समय में अनुवादित किए जा सकने वाले अधिकतम लक्ष्य लोकेल (translate-ui, translate-docs, translate-svg, और sync के अंदर के मिलान वाले चरण)। यदि इसे छोड़ा जाता है, तो CLI UI अनुवाद के लिए 4 और दस्तावेज़ अनुवाद के लिए 3 का उपयोग करता है (अंतर्निहित डिफ़ॉल्ट)। प्रति रन -j / --concurrency के साथ ओवरराइड करें।


batchConcurrency (वैकल्पिक) ​

translate-docs, translate-svg, और translate-json (और sync के अंदर के मिलान वाले चरण): प्रति फ़ाइल अधिकतम समानांतर LLM बैच अनुरोध (प्रत्येक बैच में कई सेगमेंट हो सकते हैं)। छोड़े जाने पर डिफ़ॉल्ट 4। translate-ui पर लागू नहीं होता है — इसके बजाय uiBatchConcurrency का उपयोग करें। -b / --batch-concurrency के साथ ओवरराइड करें।


uiBatchConcurrency (वैकल्पिक) ​

अनुवाद-यूआई, समन्वय-यूआई, और sync के यूआई चरण: अधिकतम समानांतर LLM बैच अनुरोध एकल स्थानीयता के भीतर (50 के प्लेन-स्ट्रिंग टुकड़े, फिर बहुवचन समूह)। डिफ़ॉल्ट 2 जब छोड़ा गया। concurrency (समानांतर लक्षित स्थानीयताएँ) और batchConcurrency (दस्तावेज़/JSON/SVG) से स्वतंत्र। कोई CLI ध्वज नहीं; इसे कॉन्फ़िगरेशन में सेट करें या प्रोग्रामेटिक runTranslateUI के लिए uiBatchConcurrency पास करें।

उदाहरण:

json
{
  "uiBatchConcurrency": 2
}

डिफ़ॉल्ट लोकेल समवर्ती 4 के साथ, यह 8 इन-फ़्लाइट UI API कॉल तक है। एक बड़े लोकेल (-l de) का अनुवाद करते समय इसे बढ़ाएँ; यदि प्रदाता दर-सीमित करता है तो इसे कम रखें।


fileConcurrency (वैकल्पिक) ​

translate-docs और sync के दौरान एक ही स्थान-विशेष में समवर्ती रूप से संसाधित की जाने वाली फ़ाइलों की अधिकतम संख्या। जब 1 से अधिक मान पर सेट किया जाता है, तो मेमोरी उपयोग को नियंत्रित करने के लिए एक सेमाफोर का उपयोग करके एक ही स्थान-विशेष के भीतर फ़ाइलों को समानांतर में संसाधित किया जाता है। छोड़े जाने पर डिफ़ॉल्ट 1 (अनुक्रमिक प्रसंस्करण)। उच्च मान I/O-बाउंड ऑपरेशनों के लिए थ्रूपुट में काफी सुधार कर सकते हैं, खासकर जब सभी सेगमेंट पहले से ही कैश किए गए हों (किसी API कॉल की आवश्यकता नहीं)।

उदाहरण:

json
{
  "fileConcurrency": 4
}

उपयोग का मामला: कुल प्रसंस्करण समय को कम करने के लिए 100% कैश हिट के साथ sync --force-update चलाते समय इसे 2-4 पर सेट करें। कई छोटी फ़ाइलों के साथ सुधार सबसे अधिक ध्यान देने योग्य है।


batchSize / maxBatchChars (वैकल्पिक) ​

translate-docs, translate-svg, और translate-json के लिए सेगमेंट बैचिंग: प्रति API अनुरोध कितने सेगमेंट, और एक वर्ण सीमा। डिफ़ॉल्ट: 20 सेगमेंट, 4096 वर्ण (छोड़े जाने पर)।


requestTimeout / requestTimeoutMs (वैकल्पिक) ​

प्रत्येक LLM अनुरोध के लिए, हर प्रदाता के लिए प्रतीक्षा करने का अधिकतम समय। requestTimeout पूरे सेकंड में है; requestTimeoutMs मिलीसेकंड में है। डिफ़ॉल्ट: 120 सेकंड जब दोनों को छोड़ दिया जाता है। दोनों में से केवल एक सेट करें। जो प्रदाता इनमें से कोई भी फ़ील्ड सेट करता है, वह उस मान का उपयोग करता है, केवल उस प्रदाता के लिए।


provider और providers ​

provider (शीर्ष-स्तरीय, वैकल्पिक) providers से सक्रिय प्रदाता कुंजी का चयन करता है। जब ठीक एक प्रदाता कॉन्फ़िगर किया गया हो तो यह वैकल्पिक होता है; जब एक से अधिक कॉन्फ़िगर किए गए हों तो यह आवश्यक होता है।

providers (शीर्ष-स्तरीय) एक प्रदाता कुंजी को उसके ब्लॉक में मैप करता है। अंतर्निहित कुंजियों (नीचे दी गई प्रीसेट तालिका देखें) को केवल translationModels की आवश्यकता होती है; कोई अन्य कुंजी एक कस्टम OpenAI-संगत एंडपॉइंट को परिभाषित करती है और baseUrl (प्लस apiKeyEnv जब तक एंडपॉइंट को किसी कुंजी की आवश्यकता न हो) की आवश्यकता होती है।

प्रत्येक providers.<name> ब्लॉक स्वीकार करता है:

  • translationModels मॉडल ID की पसंदीदा क्रमबद्ध सूची (सादे अपस्ट्रीम ID, कोई provider/ उपसर्ग नहीं; OpenRouter ID अपने मूल vendor/model रूप को बनाए रखते हैं)। पहले वाले को पहले आज़माया जाता है; बाद वाली प्रविष्टियाँ त्रुटि होने पर फ़ॉलबैक होती हैं। यह प्रत्येक पाइपलाइन के लिए वैश्विक डिफ़ॉल्ट चेन है जब कोई अधिक विशिष्ट टियर लागू नहीं होता है।
  • uiModels (वैकल्पिक) translate-ui, बहुवचन जनरेशन (चरण 0 और पास B), और proofread-ui के लिए क्रमबद्ध UI-केवल मॉडल सूची। लक्ष्य लोकेल के लिए किसी भी मिलान वाली localeModels प्रविष्टि के बाद, translationModels से पहले आज़माया जाता है।
  • localeModels (वैकल्पिक) सभी अनुवाद पाइपलाइनों के लिए प्रति-लोकेल ओवरराइड। { "locale": "<BCP-47>", "models": ["…"] } ऑब्जेक्ट्स का एक ऐरे। लोकेल टैग केस-संवेदी नहीं होते हैं (pt-br = pt-BR)। प्रत्येक लोकेल की सूची को पहले केवल उस लोकेल के लिए आज़माया जाता है, फिर पाइपलाइन-विशिष्ट टियर (UI के लिए uiModels) और translationModels। कॉन्फ़िग लोड पर डुप्लिकेट सामान्यीकृत लोकेल कुंजियों को अस्वीकार कर दिया जाता है।
  • baseUrl OpenAI-संगत बेस URL। प्रीसेट बेस URL को ओवरराइड करता है; गैर-प्रीसेट प्रदाता के लिए आवश्यक है।
  • apiKeyEnv API कुंजी रखने वाला पर्यावरण चर। प्रीसेट env var को ओवरराइड करता है।
  • headers इस प्रदाता को हर अनुरोध के साथ भेजे गए अतिरिक्त HTTP हेडर।
  • maxTokens प्रति अनुरोध अधिकतम पूर्णता टोकन। डिफ़ॉल्ट: 8192।
  • temperature सैंपलिंग तापमान। डिफ़ॉल्ट: 0.2।
  • requestTimeout इस प्रदाता को प्रत्येक अनुरोध के लिए प्रतीक्षा करने का अधिकतम समय सेकंड में। यह शीर्ष-स्तरीय requestTimeout / requestTimeoutMs को ओवरराइड करता है। जब न तो यह प्रदाता और न ही शीर्ष-स्तरीय कॉन्फ़िग टाइमआउट सेट करता है, तो डिफ़ॉल्ट 120 सेकंड होता है। एक ही ऑब्जेक्ट पर requestTimeout और requestTimeoutMs में से केवल एक सेट करें।
  • requestTimeoutMs इस प्रदाता को प्रत्येक अनुरोध के लिए प्रतीक्षा करने का अधिकतम समय मिलीसेकंड में। यह शीर्ष-स्तरीय requestTimeout / requestTimeoutMs को ओवरराइड करता है। जब न तो यह प्रदाता और न ही शीर्ष-स्तरीय कॉन्फ़िग टाइमआउट सेट करता है, तो डिफ़ॉल्ट 120000 (120 सेकंड) होता है। एक ही ऑब्जेक्ट पर requestTimeout और requestTimeoutMs में से केवल एक सेट करें।
  • pricing (वैकल्पिक) प्रदाता-व्यापी USD प्रति 1M टोकन: { "inputPerMTokens": 0.15, "outputPerMTokens": 0.6 }। जब किसी बिल किए गए कॉल में प्रदाता-रिपोर्टेड usage.cost नहीं होता है (OpenRouter और Cheaper Inference के अलावा अधिकांश प्रदाता), तो यह दर उस कॉल के इनपुट और आउटपुट टोकन पर लागू होती है। यह राशि अनुवाद सारांश में शामिल की जाती है और api_calls पंक्ति पर संग्रहीत की जाती है।

लागत स्रोत इस क्रम में हल किया जाता है:

  1. एक मिलान वाली modelPricing प्रविष्टि (इस प्रदाता डिफ़ॉल्ट को ओवरराइड करती है);
  2. एक प्रदाता-रिपोर्टेड लागत (कभी प्रतिस्थापित नहीं की जाती);
  3. यह pricing दर;
  4. उस मॉडल ID के लिए models.dev सूची मूल्य (इनपुट और आउटपुट USD प्रति 1M टोकन)।

जिन पंक्तियों को बिना लागत के संग्रहीत किया गया था, उन्हें बाद में usage और उपयोग और लागत द्वारा अनुमानित किया जा सकता है। यदि इनमें से कोई भी स्रोत लागू नहीं होता है, तो लागत अज्ञात (—) रहती है, कभी $0.00 नहीं।

  • modelPricing (वैकल्पिक) प्रति-मॉडल USD प्रति 1M टोकन: { "<model-id>": { "inputPerMTokens": 2.5, "outputPerMTokens": 10 } }। उस मॉडल ID के लिए pricing को ओवरराइड करता है। कॉल के समय लागू होता है जब प्रदाता ने usage.cost को छोड़ दिया था, और कॉल के साथ संग्रहीत किया जाता है।
  • zeroDataRetention (वैकल्पिक, केवल providers.cheaperinference) जब true, चैट अनुरोध "zdr": true और list-models, check-models, और suggest-models लोड GET /v1/models?zdr=true भेजते हैं। छोड़ा गया मतलब बंद। जीरो डेटा रिटेंशन देखें।

अंतर्निहित प्रदाता प्रीसेट (कुंजी — आधार URL — API-कुंजी env var):

प्रदाताबेस यूआरएलएपीआई-की एनवायरनमेंट वेरिएबल
alibabahttps://dashscope-intl.aliyuncs.com/compatible-mode/v1ALIBABA_API_KEY
anthropichttps://api.anthropic.com/v1ANTHROPIC_API_KEY
apikeyfanhttps://api.apikey.fan/v1APIKEYFAN_API_KEY
cerebrashttps://api.cerebras.ai/v1CEREBRAS_API_KEY
cheaperinferencehttps://api.cheaperinference.com/v1CHEAPERINFERENCE_API_KEY
deepseekhttps://api.deepseek.comDEEPSEEK_API_KEY
geminihttps://generativelanguage.googleapis.com/v1beta/openaiGOOGLE_API_KEY
groqhttps://api.groq.com/openai/v1GROQ_API_KEY
mistralhttps://api.mistral.ai/v1MISTRAL_API_KEY
nvidiahttps://integrate.api.nvidia.com/v1NVIDIA_API_KEY
ollamahttp://localhost:11434/v1(कोई नहीं)
openaihttps://api.openai.com/v1OPENAI_API_KEY
openrouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
xaihttps://api.x.ai/v1XAI_API_KEY

apifun प्रीसेट का नाम बदलकर apikeyfan कर दिया गया। मौजूदा कॉन्फ़िगरेशन में provider और providers कुंजियों को अपडेट करें; APIFUN_API_KEY, APIKEYFAN_API_KEY के लिए एक उपनाम बना हुआ है।

एक लेगेसी शीर्ष-स्तरीय openrouter ब्लॉक (baseUrl, translationModels, defaultModel, fallbackModel, maxTokens, temperature, requestTimeout, requestTimeoutMs के साथ) अभी भी स्वीकार किया जाता है और लोड होने पर providers.openrouter (provider: "openrouter" के साथ) में स्वतः माइग्रेट हो जाता है; defaultModel / fallbackModel translationModels में समाहित हो जाते हैं।

एक चलाने योग्य उदाहरण के लिए जो एक कॉन्फ़िग में कई प्रदाताओं को कॉन्फ़िगर करता है और -P के साथ उनके बीच स्विच करता है, examples/multi-provider (एक ही दस्तावेज़ पर openai, anthropic, openrouter, और deepseek) देखें।

एक से ज़्यादा मॉडल का इस्तेमाल क्यों करें: अलग-अलग प्रोवाइडर और मॉडल की लागत अलग-अलग होती है और वे भाषाओं और लोकेल में अलग-अलग स्तर की क्वालिटी देते हैं. translationModels को एक क्रमित फ़ॉलबैक चेन के रूप में कॉन्फ़िगर करें ताकि अनुरोध विफल होने पर CLI अगले मॉडल को आज़मा सके. उस सूची को बनाने के लिए गाइड AI मॉडल है.

नीचे दी गई सूची को बेसलाइन मानें. AI मॉडल पर दी गई बेंचमार्क रैंकिंग से इसे बदलें. अगर किसी खास लोकेल के लिए अनुवाद खराब रहता है, तो उस भाषा या स्क्रिप्ट के लिए एक localeModels एंट्री जोड़ें, या प्रोवाइडर की कैटलॉग से और आईडी जोड़ें.

ये मॉडल आईडी वही हैं जो ai-i18n-tools init -P openrouter लिखता है। अन्य प्रीसेट init -P <provider> से नेटिव मॉडल आईडी प्राप्त करते हैं — बिल्ट-इन प्रोवाइडर देखें।

इस सूची को 36 लक्षित लोकेल के साथ एक बड़े दस्तावेज़ीकरण प्रोजेक्ट में व्यापक लोकेल कवरेज के लिए परखा गया था; यह एक व्यावहारिक डिफ़ॉल्ट के रूप में कार्य करता है, लेकिन हर लोकेल के लिए अच्छा प्रदर्शन करने की गारंटी नहीं है।

उदाहरण translationModels (ai-i18n-tools init -P openrouter से OpenRouter सूची):

OpenRouter ट्रांसलेशनमॉडल सूची
json
"translationModels": [
  "google/gemini-2.5-flash",
  "meta-llama/llama-3.3-70b-instruct",
  "openai/gpt-4o-mini",
  "google/gemma-4-26b-a4b-it",
  "~anthropic/claude-haiku-latest",
  "z-ai/glm-5.2",
  "google/gemini-3.5-flash",
  "~anthropic/claude-sonnet-latest"
  // … add more fallback models as needed
]

अनुशंसित uiModels: UI स्ट्रिंग छोटी होती हैं लेकिन अत्यधिक दृश्यमान होती हैं — एक प्रीमियम मॉडल अक्सर टोन, बहुवचन और संगति में सुधार करता है। वैकल्पिक uiModels को किसी भी मिलान वाले localeModels प्रविष्टि के बाद और translationModels से पहले आज़माया जाता है (ऊपर फ़ील्ड सूची देखें)। उदाहरण:

UI अनुवाद के लिए अनुशंसित uiModels
json
"uiModels": [
  "~anthropic/claude-sonnet-latest",
  "z-ai/glm-5.2"
]

एशियाई भाषाओं के लिए अनुशंसित localeModels: जापानी, कोरियाई और चीनी लोकेल अक्सर उन स्क्रिप्ट के लिए ट्यून किए गए मॉडल से लाभान्वित होते हैं। प्रति-लोकेल ओवरराइड जोड़ें जिन्हें लक्षित लोकेल के मिलान होने पर पहले (uiModels / translationModels से पहले) आज़माया जाता है:

जा, को, झ-हंस, झ-हंत के लिए अनुशंसित लोकेलमॉडल
json
"localeModels": [
  { "locale": "ja",      "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "ko",      "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "zh-Hans", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "zh-Hant", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] }
]

अपने वातावरण या .env फ़ाइल में सक्रिय प्रदाता का API-कुंजी env var (देखें प्रीसेट तालिका) सेट करें।

मॉडल सूचियों को बदलने से पहले, ai-i18n-tools check-models चलाएँ। किसी भी प्रदाता के लिए यह प्रत्येक कॉन्फ़िगर किए गए मॉडल आईडी (translationModels, uiModels, और सभी localeModels प्रविष्टियाँ) को उस प्रदाता की लाइव मॉडल सूची (GET /models) के विरुद्ध सत्यापित करता है, उन आईडी की रिपोर्ट करता है जो गायब हैं या expiration_date से अधिक हैं, वैध मॉडल की सूची बनाता है, और जब कोई कॉन्फ़िगर किया गया आईडी अमान्य होता है तो गैर-शून्य से बाहर निकलता है। जब प्रदाता मूल्य निर्धारण लौटाता है (जैसे OpenRouter) तो यह अनुमानित इनपुट/आउटपुट मूल्य निर्धारण (प्रति 1M टोकन USD) भी दिखाता है।

वास्तविक अनुवाद कार्य पर कॉन्फ़िगर किए गए मॉडल की तुलना करने के लिए, ai-i18n-tools bench-models चलाएँ। यह translationModels, uiModels, और localeModels से प्रत्येक अद्वितीय मॉडल आईडी को बेंचमार्क करता है, प्रत्येक के माध्यम से एक नमूने का अनुवाद करके (समानांतर में, concurrency द्वारा सीमित) और प्रति-मॉडल इनपुट/आउटपुट टोकन, वॉल-क्लॉक समय, और USD लागत प्रिंट करता है, ताकि आप मॉडल सूचियों पर निर्णय लेने से पहले गति बनाम मूल्य का वजन कर सकें।


features ​

फ़ील्डपाइपलाइनविवरण
translateUIStrings1t("…") / i18n.t("…") को strings.json में निकालें, फिर प्रविष्टियों का अनुवाद करें और प्रति-लोकेल फ़्लैट JSON लिखें (निष्कर्षण स्वचालित रूप से चलता है; केवल कैटलॉग को ताज़ा करने के लिए स्टैंडअलोन extract का उपयोग करें)।
translateDocs2.md / .mdx / .astro / .html / .htm पृष्ठों का अनुवाद करें; जब docs[].docusaurusCatalogDir सेट हो तो Docusaurus शेल JSON; कॉन्फ़िगर होने पर Nextra _meta / शब्दकोश; जब docsOutput.vitepressThemeCatalog सेट हो तो VitePress थीम; जब docsOutput.style "fumadocs" हो तो Fumadocs meta.json / UI कैटलॉग।
translateJson3json[] (translate-json) के तहत मनमाना नेस्टेड JSON।
translateSVG—.svg फ़ाइलों का अनुवाद करें (शीर्ष-स्तरीय svg ब्लॉक की आवश्यकता है)।

जब कुंजी छोड़ी जाती है तो प्रत्येक फ़्लैग डिफ़ॉल्ट रूप से true होता है। व्यवहार इस प्रकार है:

  • अनुवाद करने के लिए कुछ भी न होने पर छोड़ा गया true छोड़ दिया जाता है: किसी भी UI ब्लॉक में sourceRoots नहीं है, किसी भी डॉक्स ब्लॉक में contentPaths या docusaurusCatalogDir नहीं है, json[] में contentPaths नहीं है, या svg अनसेट है।
  • जब उस पाइपलाइन में कोई काम नहीं होता है तो फ़्लैग को true के रूप में लिखना एक कॉन्फ़िग त्रुटि है।
  • false लिखने से वह पाइपलाइन sync के लिए बंद हो जाती है, भले ही स्रोत मौजूद हों।
  • --no-ui, --no-docs, --no-json, और --no-svg एक रन के लिए चरण को छोड़ देते हैं।

जब features.translateSVG सत्य हो और एक शीर्ष-स्तरीय svg ब्लॉक कॉन्फ़िगर किया गया हो, तो translate-svg के साथ SVG फ़ाइलों का अनुवाद करें। जब फ्लैग चालू हो और svg सेट हो (जब तक कि --no-svg न हो), तो sync कमांड उस चरण को चलाता है।


ui ​

एक कैटलॉग ऑब्जेक्ट, या कैटलॉग ब्लॉकों की एक सरणी (docs[] जैसा ही विचार)। लोड होने पर एक एकल ऑब्जेक्ट स्वीकार किया जाता है और उसे एक-तत्व वाली सरणी में रैप किया जाता है; डिस्क पर मौजूद फ़ाइल को फिर से नहीं लिखा जाता है। पार्स करने के बाद, config.ui हमेशा एक सरणी होती है।

extract, translate-ui, sync-ui, sync का UI चरण, proofread-ui, export-ui-xliff, generate-ui-languages, और purge-locale उन प्रत्येक ब्लॉक को पार करते हैं जिनमें sourceRoots है। एक ब्लॉक चलाने के लिए --ui-block को शून्य-आधारित इंडेक्स, ब्लॉक के description, या उसके stringsJson पथ के साथ पास करें। status और statistics उन प्रत्येक ब्लॉक को सूचीबद्ध करते हैं जिनमें स्रोत या मौजूदा कैटलॉग है। अनुवाद डैशबोर्ड ऐसे प्रत्येक कैटलॉग को सूचीबद्ध करता है और एक से अधिक होने पर एक चयनकर्ता दिखाता है।

रिज़ॉल्व किए गए stringsJson, flatOutputDir, और मैनिफेस्ट पथ ब्लॉकों के बीच अद्वितीय होने चाहिए। सेट होने पर description मान अद्वितीय होने चाहिए, क्योंकि --ui-block उनसे बिल्कुल मेल खाता है।

  • description कॉन्फ़िग पढ़ने वाले लोगों के लिए वैकल्पिक नोट (मॉडल को नहीं भेजा जाता)। कमांड हेडर, status, statistics, और डैशबोर्ड में ui[i] — description के रूप में दिखाया गया है।
  • sourceRootst("…") कॉल के लिए स्कैन की गई निर्देशिकाएँ या ग्लोब पैटर्न (cwd के सापेक्ष)। src/ या ["src/**/*.ts"] जैसे पैटर्न का समर्थन करता है। खाली सूची वाले ब्लॉक को स्किप कर दिया जाता है जब तक कि --ui-block इसे नाम न दे, जो कि एक त्रुटि है।
  • stringsJson इस ब्लॉक की मास्टर कैटलॉग फ़ाइल का पथ। extract द्वारा अपडेट किया गया।
  • flatOutputDir वह निर्देशिका जहाँ इस ब्लॉक की प्रति-लोकेल JSON फ़ाइलें लिखी जाती हैं (de.json, आदि)।
  • flatOutput जब true (डिफ़ॉल्ट), translate-ui प्रति लोकैल एक फ़्लैट JSON फ़ाइल लिखता है। केवल gettext या resx उत्सर्जित करने के लिए false सेट करें। flatOutput: false वाले ब्लॉक को gettext या resx सेट करना होगा।
  • resx वैकल्पिक .NET .resx आउटपुट। outputDir (डिफ़ॉल्ट Resources) और baseName (डिफ़ॉल्ट SharedResource) {baseName}.resx के साथ {baseName}.{culture}.resx लिखते हैं। writeNeutral (डिफ़ॉल्ट true) स्रोत टेक्स्ट को न्यूट्रल फ़ाइल में रखता है ताकि ResourceManager फ़ॉलबैक कर सके। localeFormat या तो bcp47 (डिफ़ॉल्ट, pt-BR) है या posix (pt_BR)। ingestExistingResx (डिफ़ॉल्ट true) extract के दौरान सैटेलाइट्स पढ़ता है। neutralFile LoginButton जैसी लेगेसी नामित कुंजियों को न्यूट्रल मान के माध्यम से मैप करता है। संदर्भ कुंजियाँ U+2404 का उपयोग करती हैं। बहुवचन रूप {singular}[{form}] नामक अलग प्रविष्टियाँ हैं। flatOutput: false वाले ब्लॉक को gettext या resx सेट करना होगा।
  • gettext इस ब्लॉक के लिए वैकल्पिक GNU gettext आउटपुट। outputDir (डिफ़ॉल्ट ./locales) <locale>/LC_MESSAGES/<domain>.po प्राप्त करता है और, जब compileMo true (डिफ़ॉल्ट) होता है, तो मिलान करने वाला .mo प्राप्त करता है। domain का डिफ़ॉल्ट messages है। potPath टेम्पलेट कैटलॉग है। ingestExistingPo (डिफ़ॉल्ट true) extract के दौरान गैर-फ़ज़ी msgstr मानों से खाली strings.json स्लॉट भरता है और गैर-खाली या उपयोगकर्ता-संपादित अनुवाद को प्रतिस्थापित नहीं करता है। localeFormat या तो posix (डिफ़ॉल्ट, pt_BR) है या bcp47 (pt-BR)। प्रासंगिक पंक्तियाँ gettext \u0004 सेपरेटर का उपयोग करती हैं। दो संदर्भों में एक ही स्रोत-भाषा स्ट्रिंग एक कैटलॉग आईडी साझा नहीं करती है।
  • targetLocales इस ब्लॉक के लिए वैकल्पिक लोकैल सूची। जब इसे छोड़ा जाता है या खाली होता है, तो ब्लॉक रूट targetLocales का उपयोग करता है।
  • languagesManifestPath वैकल्पिक पाथ जहाँ extract और generate-ui-languages इस ब्लॉक का ui-languages.json लिखते हैं। जब इसे छोड़ा जाता है, तो ब्लॉक 0 रूट languagesManifestPath का उपयोग करता है (जो स्वयं इस ब्लॉक के {flatOutputDir}/ui-languages.json पर डिफ़ॉल्ट होता है)। बाद के ब्लॉक {flatOutputDir}/ui-languages.json पर डिफ़ॉल्ट होते हैं।
  • uiGlossary जब true (डिफ़ॉल्ट) होता है, तो इस ब्लॉक का strings.json translate-docs, translate-json और translate-svg के लिए एक शब्दावली संकेत स्रोत होता है। translate-ui, proofread-ui और स्रोत लिंटिंग केवल glossary.userGlossary का उपयोग करते हैं। उन संकेतों से कैटलॉग को बाहर रखने के लिए false सेट करें (उदाहरण के लिए एक CLI स्ट्रिंग कैटलॉग जो दस्तावेज़ को निर्देशित नहीं करना चाहिए)।
  • uiExtractor.funcNames (या लेगेसी reactExtractor.funcNames) स्कैन करने के लिए अतिरिक्त फ़ंक्शन नाम (डिफ़ॉल्ट: ["t", "i18n.t"])।
  • uiExtractor.extensions (या लेगेसी reactExtractor.extensions) शामिल करने के लिए फ़ाइल एक्सटेंशन (डिफ़ॉल्ट: [".js", ".jsx", ".ts", ".tsx"])। Astro फ्रंटमैटर और टेम्पलेट एक्सप्रेशन के लिए .astro जोड़ें।
  • uiExtractor.includePackageDescription (या लेगेसी reactExtractor.includePackageDescription) जब true (डिफ़ॉल्ट) होता है, तो extract मौजूद होने पर package.json description को UI स्ट्रिंग के रूप में भी शामिल करता है। अतिरिक्त ब्लॉकों पर false सेट करें ताकि वही विवरण हर कैटलॉग में न निकाला जाए।
  • uiExtractor.packageJsonPath (या लेगेसी reactExtractor.packageJsonPath) उस वैकल्पिक विवरण निष्कर्षण के लिए उपयोग की जाने वाली package.json फ़ाइल का कस्टम पाथ।
  • uiExtractor.includeUiLanguageEnglishNames (या लेगेसी reactExtractor.includeUiLanguageEnglishNames)

जब true (डिफ़ॉल्ट false), extract बंडल किए गए ui-languages मास्टर कैटलॉग (जो sourceLocale + ब्लॉक के प्रभावी targetLocales से बना है) से प्रत्येक englishName को strings.json में भी जोड़ता है, यदि स्रोत स्कैन से पहले से मौजूद नहीं है (समान हैश कुंजियाँ)। languagesManifestPath को नहीं पढ़ता है।

  • uiExtractor.placeholderStyledefault (मस्टैच, पायथन फ़ॉर्मेट फ़ील्ड और printf) या dotnet (केवल {0}, {0,-10}, {0:format})। dotnet शैली में एक प्रतिशत चिह्न शाब्दिक पाठ है और दोहरे ब्रेसिज़ शाब्दिक ब्रेसिज़ हैं। ui-dotnet टेम्पलेट dotnet सेट करता है।
  • uiExtractor.exclude मिनिमैच पैटर्न, प्रोजेक्ट रूट के सापेक्ष, स्कैन के बाद हटा दिए जाते हैं। bin, obj, .vs, TestResults, और packages को निर्देशिका नाम से पहले ही छोड़ दिया जाता है। ui-dotnet और ui-dotnet-resx टेम्पलेट **/Tests/**, **/*.Tests/**, और **/TrExtension.cs को बाहर करते हैं।

glossary.uiGlossary और glossary.uiGlossaryFromStringsJson अब स्वीकार नहीं किए जाते हैं। कॉन्फ़िग लोड विफल हो जाता है और त्रुटि प्रतिस्थापन की व्याख्या करती है: कुंजी को हटा दें। संकेत अब प्रत्येक ब्लॉक के uiGlossary फ्लैग से आते हैं (डिफ़ॉल्ट true)।


cacheDir ​

  • cacheDir SQLite कैश निर्देशिका (सभी docs ब्लॉकों द्वारा साझा)। डिफ़ॉल्ट .translation-cache। रन के बीच पुन: उपयोग करें। यदि आप एक कस्टम डॉक अनुवाद कैश से माइग्रेट कर रहे हैं, तो इसे आर्काइव या डिलीट करें — cacheDir अपना स्वयं का SQLite डेटाबेस बनाता है और अन्य स्कीमा के साथ संगत नहीं है। suggest-models बेंचमार्क एग्रीगेट्स को भी <cacheDir>/benchmark-scores.json में संग्रहीत करता है। वह फ़ाइल एक कैश है, निर्देशिका के बाकी हिस्सों की तरह, और प्रकाशित पैकेज का हिस्सा नहीं है।

गिट बहिष्करण के लिए सर्वोत्तम अभ्यास: ​

  • अनुवाद कैश फ़ोल्डर की सामग्री को बाहर रखें (उदाहरण के लिए, .gitignore या .git/info/exclude का उपयोग करके) ताकि अस्थायी कैश कलाकृतियों को कमिट होने से रोका जा सके।
  • cache.db को बनाए रखें (इसे नियमित रूप से न मिटाएं), क्योंकि SQLite कैश को बनाए रखने से अपरिवर्तित खंडों का फिर से अनुवाद करने से रोका जा सकता है। इससे रनटाइम और API दोनों लागतें बचती हैं जब ai-i18n-tools का उपयोग करने वाले सॉफ़्टवेयर को अपडेट या संशोधित किया जाता है।
  • पर्यावरण फ़ाइलों और अस्थायी फ़ाइलों को बाहर रखें ताकि रहस्य और बैकअप कमिट न हों।

उदाहरण:

init डिफ़ॉल्ट cacheDir के लिए इस ब्लॉक को लिखता है। जब cacheDir अलग होता है, तो दो कैश लाइनें उस डायरेक्टरी का उपयोग करती हैं, उदाहरण के लिए .i18n-cache/* और !.i18n-cache/cache.db।

gitignore
# Cache
.translation-cache/*
!.translation-cache/cache.db
benchmark-scores.json

# Environment
.env
.env.local
.env.*.local

# Temporary files
*.tmp
*.backup.*

docs ​

डॉक्यूमेंटेशन पाइपलाइन ब्लॉक का ऐरे। translate-docs और sync का डॉक्स चरण प्रत्येक ब्लॉक को क्रम में प्रोसेस करता है। लेगेसी कुंजियाँ लोड समय पर अभी भी स्वीकार की जाती हैं और जब कॉन्फ़िग फ़ाइल लिखने योग्य होती है तो फिर से लिखी जाती हैं; नई कॉन्फ़िग में वर्तमान नामों को प्राथमिकता दें।

लेगेसी कुंजीवर्तमान कुंजी / व्यवहार
documentationsdocs
markdownOutputdocs[].docsOutput
jsonSourcedocs[].docusaurusCatalogDir
शीर्ष-स्तरीय openrouterproviders.openrouter + provider: "openrouter"
features.translateMarkdownfeatures.translateDocs
features.translateJSONहटा दिया गया (docs[].docusaurusCatalogDir या json[] का उपयोग करें)
features.extractUIStringsहटा दिया गया (extract UI अनुवाद से पहले चलता है)
glossary.uiGlossary और glossary.uiGlossaryFromStringsJsonहटाए गए; कॉन्फ़िग लोड विफल रहता है। ui[].uiGlossary (बूलियन, डिफ़ॉल्ट true) का उपयोग करें
ui.reactExtractorui.uiExtractor (उपनाम अभी भी स्वीकार किया गया)
svg.svgExtractor.forceLowercasesvg.forceLowercase

सामग्री स्रोत

  • description इस ब्लॉक के लिए वैकल्पिक मानव-पठनीय नोट (अनुवाद के लिए उपयोग नहीं किया गया)। सेट होने पर translate-docs 🌐 हेडलाइन में उपसर्ग; status अनुभाग शीर्षकों में भी दिखाया गया है।
  • contentPaths मार्कडाउन/MDX पेज बॉडी और .astro टेम्प्लेट का अनुवाद करने के लिए (translate-docs .md, .mdx, और .astro के लिए इन्हें स्कैन करता है)। डायरेक्टरी पाथ या ग्लोब पैटर्न (जैसे "docs/**/*.md", "guides/*.mdx", "src/pages/index.astro") का समर्थन करता है। यहीं से स्थानीयकृत दस्तावेज़ गद्य आता है।
  • sourceFiles लोड पर contentPaths में मर्ज किया गया वैकल्पिक उपनाम।
  • targetLocales केवल इस ब्लॉक के लिए लोकेल का वैकल्पिक उपसमूह (अन्यथा रूट targetLocales)। प्रभावी दस्तावेज़ लोकेल ब्लॉक में संघ हैं।
  • docusaurusCatalogDir वैकल्पिक। इस ब्लॉक के लिए Docusaurus JSON लेबल कैटलॉग के लिए स्रोत निर्देशिका (जैसे "i18n/en" से docusaurus write-translations)। पेज बॉडी हमेशा contentPaths से आती हैं; docusaurusCatalogDir केवल शेल/UI JSON प्रदान करता है, MDX नहीं।
  • nextraMetaGlobdocsRoot के तहत Nextra _meta.ts / _meta.tsx / _meta.js के लिए वैकल्पिक ग्लोब। जब docsOutput.style "nextra" होता है और इसे छोड़ दिया जाता है, तो docsRoot के तहत सभी _meta फाइलें स्वचालित रूप से एकत्र की जाती हैं।
  • nextraMetaTranslatableKeys वैकल्पिक संपत्ति नाम जिनके स्ट्रिंग मान Nextra _meta ऑब्जेक्ट में अनुवादित होते हैं (डिफ़ॉल्ट: title, display, breadcrumb)।
  • nextraDictionaryPath वैकल्पिक अंग्रेजी Nextra थीम डिक्शनरी मॉड्यूल (जैसे "app/_dictionaries/en.ts")। translate-docs के दौरान {dir}/{locale}.ts में अनुवादित।
  • nextraDictionaryOutputTemplate लोकेल डिक्शनरी मॉड्यूल के लिए वैकल्पिक आउटपुट टेम्प्लेट (डिफ़ॉल्ट: डिक्शनरी डायरेक्टरी के सापेक्ष {dir}/{locale}.ts)।

docsOutput ​

इस ब्लॉक के लिए आउटपुट लेआउट।

  • outputDir इस ब्लॉक के लिए अनुवादित आउटपुट के लिए रूट डायरेक्टरी।
  • docsOutput.style"nested" (डिफ़ॉल्ट), "flat", "doc-system", या उपनाम "docusaurus" / "astro-starlight" / "vitepress" / "nextra"।
  • docsOutput.localeSubpathdoc-system के लिए {locale}/ और {relativeToDocsRoot} के बीच पाथ सेगमेंट (style: "doc-system" का सीधे उपयोग करते समय आवश्यक; उपनाम का उपयोग करते समय प्रीसेट)। Starlight-शैली लोकेल फ़ोल्डरों के लिए "" का उपयोग करें।
  • docsOutput.docsRoot Docusaurus लेआउट के लिए स्रोत डॉक्स रूट (जैसे "docs")। छोड़े जाने पर डिफ़ॉल्ट "docs"।
  • docsOutput.pathTemplate कस्टम मार्कडाउन आउटपुट पाथ। प्लेसहोल्डर: "{outputDir}", "{locale}", "{LOCALE}", "{llocale}", "{relPath}", "{stem}", "{basename}", "{extension}", "{docsRoot}", "{relativeToDocsRoot}"।
  • docsOutput.jsonPathTemplate लेबल फ़ाइलों के लिए कस्टम JSON आउटपुट पाथ। pathTemplate के समान प्लेसहोल्डर का समर्थन करता है।
  • docsOutput.localePathLowercase जब true, बिल्ट-इन आउटपुट लेआउट (nested, flat, doc-system बिना pathTemplate) पाथ में लोअरकेस लोकेल सेगमेंट का उपयोग करते हैं। डिफ़ॉल्ट false; astro-starlight और doc-system खाली localeSubpath के साथ कॉन्फ़िग लोड पर true पर डिफ़ॉल्ट होते हैं।
  • docsOutput.flatPreserveRelativeDir जब docsOutput.style = "flat", स्रोत उपनिर्देशिकाओं को रखें ताकि समान बेसनाम वाली फ़ाइलें टकरा न जाएं। डिफ़ॉल्ट false।
  • docsOutput.rewriteRelativeLinks अनुवाद के बाद सापेक्ष लिंक फिर से लिखें (जब docsOutput.style = "flat" और कोई कस्टम pathTemplate न हो तो स्वतः सक्षम हो जाता है)।
  • docsOutput.linkRewriteDocsRoot फ़्लैट-लिंक रीराइट प्रीफ़िक्स की गणना करते समय उपयोग किया जाने वाला रेपो रूट। आमतौर पर इसे "." के रूप में छोड़ दें जब तक कि आपके अनुवादित दस्तावेज़ किसी भिन्न प्रोजेक्ट रूट के अंतर्गत न हों।
  • docsOutput.rewriteVitepressLinks जब true हो, तो अनुवाद के बाद VitePress लिंक नॉर्मलाइज़र चलाएँ। जब docsOutput.style "vitepress" हो तो डिफ़ॉल्ट रूप से सक्षम होता है। किसी भी doc-system लेआउट के साथ उपयोग करें जहाँ स्थानीय फ़ोल्डर docsRoot के अंतर्गत स्रोत-स्थानीय फ़ाइलों के बगल में हों। स्रोत भाषा sourceLocale है और कोई भी भाषा हो सकती है। README-शैली docs/guide/… पाथ को साइट रूट (/guide/…) और स्थानीय-सापेक्ष ../guide/… लिंक में फिर से लिखता है। VitePress ट्री (LICENSE, examples/) के बाहर रेपो फ़ाइलों के लिंक के लिए, स्रोत-स्थानीय फ़ाइलों में पूर्ण URL का उपयोग करें — VitePress एकीकरण — दस्तावेज़ होमपेज के रूप में README देखें।
  • docsOutput.rewriteNextraLinks जब true हो, तो अनुवाद के बाद Nextra लिंक नॉर्मलाइज़र चलाएँ। जब docsOutput.style "nextra" हो तो डिफ़ॉल्ट रूप से सक्षम होता है। Next.js i18n के लिए content/en/… और सापेक्ष .mdx पाथ को स्थानीय-तटस्थ साइट रूट (/guide/…) में फिर से लिखता है। Nextra एकीकरण — लिंक परंपराएँ देखें।
  • docsOutput.fumadocsParser"dot" (डिफ़ॉल्ट) या "dir"। डॉट स्रोत-स्थानीय फ़ाइलों के बगल में stem.{locale}.mdx लिखता है; डिरेक्टरी Nextra की तरह स्थानीय फ़ोल्डर लिखती है। स्रोत भाषा sourceLocale है और कोई भी भाषा हो सकती है। Fumadocs एकीकरण — पृष्ठ लेआउट देखें।
  • docsOutput.rewriteFumadocsLinks जब true हो, तो अनुवाद के बाद Fumadocs लिंक नॉर्मलाइज़र चलाएँ। जब docsOutput.style "fumadocs" हो तो डिफ़ॉल्ट रूप से सक्षम होता है। सामग्री पाथ और सापेक्ष .mdx लिंक को /docs/… रूट में फिर से लिखता है।
  • docsOutput.fumadocsUiCatalog वैकल्पिक। Fumadocs UI ओवरराइड कैटलॉग बूटस्ट्रैप + translate-docs के अंदर अनुवाद। फ़ील्ड: sourcePath (उदाहरण के लिए lib/layout.shared.ts), catalogPath (जनरेटेड अंग्रेज़ी JSON), वैकल्पिक outputPathTemplate (डिफ़ॉल्ट: ui.{locale}.json catalogPath के बगल में)।
  • docs[].fumadocsMetaGlob जब docsOutput.style "fumadocs" हो तो meta.json संग्रह के लिए वैकल्पिक ग्लोब। डिफ़ॉल्ट: docsOutput.docsRoot के अंतर्गत रिकर्सिव meta.json।
  • docs[].fumadocsMetaTranslatableKeys प्रॉपर्टी नाम जिनके स्ट्रिंग मानों का Fumadocs meta.json में अनुवाद किया जाता है (डिफ़ॉल्ट: title, description)।
  • docsOutput.localizedAssets जब कोई लोकेल फ़ाइल मौजूद हो तो अनुवादित HTML में छवि और आइकन URL का वैकल्पिक पुनर्नामकरण। फ़ील्ड: include (डिफ़ॉल्ट img/**), pattern (डिफ़ॉल्ट {stem}-{locale}{ext}), onlyIfExists (डिफ़ॉल्ट true), assetRoot (रूट-रिलेटिव URL का परीक्षण करने के लिए उपयोग की जाने वाली डायरेक्टरी; डिफ़ॉल्ट HTML फ़ाइल की डायरेक्टरी है)। प्लेसहोल्डर: {stem}, {ext}, {basename}, {locale}, {llocale}, {LOCALE}। CSS url() को फिर से नहीं लिखा जाता है। HTML पृष्ठ देखें।
  • docsOutput.html HTML दस्तावेज़ों के लिए वैकल्पिक भाषा सूची और hreflang। डिफ़ॉल्ट टिप्पणियाँ <!-- ai-i18n:lang-list --> … <!-- /ai-i18n:lang-list --> और <!-- ai-i18n:hreflang --> … <!-- /ai-i18n:hreflang --> हैं। languageList.format, links या select है। languageList.label, local, english, या both है। hreflang.siteUrl वैकल्पिक लिंक को प्रीफ़िक्स करता है; जब इसे छोड़ दिया जाता है, तो लिंक रिलेटिव होते हैं और एक चेतावनी लॉग की जाती है। hreflang.xDefault डिफ़ॉल्ट रूप से sourceLocale होता है। hreflang.stripIndexHtml, index.html को डायरेक्टरी URL में बदल देता है। HTML के लिए, लोकेल फ़ोल्डर जोड़े जाने से पहले docsRoot को हटा दिया जाता है (जब docsRoot, site हो तो site/index.html → site/{locale}/index.html)। HTML पृष्ठ देखें।
  • docsOutput.vitepressThemeCatalog वैकल्पिक। translate-docs के अंदर VitePress थीम/नेव/साइडबार कैटलॉग बूटस्ट्रैप + अनुवाद। फ़ील्ड: configPath (थीम स्ट्रिंग के साथ VitePress कॉन्फ़िग), catalogPath (जनरेट किया गया अंग्रेज़ी नेस्टेड JSON), वैकल्पिक outputPathTemplate (डिफ़ॉल्ट: catalogPath के बगल में theme.{locale}.json)।

पोस्ट-प्रोसेसिंग

  • docsOutput.postProcessing अनुवादित मार्कडाउन बॉडी पर वैकल्पिक परिवर्तन (YAML कुंजियाँ और गैर-गद्य फ्रंट मैटर मान संरक्षित हैं)। सेगमेंट पुनर्संयोजन और लिंक पुनर्लेखन (फ्लैट या VitePress) के बाद, और addFrontmatter से पहले चलता है।
  • docsOutput.postProcessing.regexAdjustments{ "description"?, "search", "replace" } की क्रमबद्ध सूची। search एक रेगेक्स पैटर्न है (साधारण स्ट्रिंग फ़्लैग g का उपयोग करती है, या /pattern/flags)। replace ${translatedLocale}, ${sourceLocale}, ${sourceFullPath}, ${translatedFullPath}, ${sourceFilename}, ${translatedFilename}, ${sourceBasedir}, ${translatedBasedir} जैसे प्लेसहोल्डर का समर्थन करता है।
  • docsOutput.postProcessing.languageListBlock{ "start", "end", "separator", "label"? } — स्रोत और अनुवादित मार्कडाउन में एक बाउंडेड "अन्य भाषाओं में पढ़ें" लिंक पंक्ति को पुनर्जीवित करता है। जब label: "local" हो तो एंडोनिम लेबल के लिए languagesManifestPath (या ui.flatOutputDir/ui-languages.json पर एक मैनिफेस्ट) की आवश्यकता होती है।

व्यवहार और मेटाडेटा

  • translateFrontmatterFieldsdocsOutput के समान स्तर पर (प्रति docs[] ब्लॉक)। डिफ़ॉल्ट true: Starlight/Docusaurus के लिए उपयोगकर्ता-सामने वाले YAML गद्य का अनुवाद करें (title, description, sidebar.label, sidebar_label, keywords, hero.title, hero.tagline, hero.image.alt, hero.actions[].text, pagination_label, prev/next लेबल)। पूरे फ्रंट मैटर ब्लॉक को अपरिवर्तित रखने के लिए false सेट करें; विशिष्ट डॉट-पाथ तक सीमित रखने के लिए एक स्ट्रिंग ऐरे पास करें।
  • segmentSplittingdocsOutput के समान स्तर पर (प्रति docs[] ब्लॉक)। translate-docs निष्कर्षण के लिए वैकल्पिक अधिक बारीक-दाने वाले खंड: { "enabled", "maxCharsPerSegment"?, "splitPipeTables"?, "splitDenseParagraphs"?, "maxLinesPerParagraphChunk"?, "splitLongLists"?, "maxListItemsPerChunk"?, "qualityRetrySplit"?, "maxQualityRetrySplitDepth"? }। जब enabled true हो (segmentSplitting छोड़े जाने पर डिफ़ॉल्ट), तो सघन पैराग्राफ, GFM पाइप टेबल (पहले चंक में हेडर, सेपरेटर और पहली डेटा पंक्ति शामिल होती है), और लंबी सूचियाँ विभाजित हो जाती हैं; उप-भाग एकल नई लाइनों (tightJoinPrevious) के साथ फिर से जुड़ते हैं। केवल प्रति खाली-पंक्ति-सीमांकित बॉडी ब्लॉक एक खंड का उपयोग करने के लिए "enabled": false सेट करें। जब qualityRetrySplit true हो (डिफ़ॉल्ट), तो मॉडल सूची रुकने के बाद AST सत्यापन में विफल रहने वाले मार्कडाउन खंडों को धीरे-धीरे विभाजित किया जाता है और पहले मॉडल से पुनः प्रयास किया जाता है। जब एक ही गुणवत्ता त्रुटि तीन बार हो चुकी हो तो सूची जल्दी रुक जाती है। maxQualityRetrySplitDepth (डिफ़ॉल्ट 3) रिकर्सिव स्प्लिट्स को सीमित करता है।
  • warnMarkdownSourceIssues जब true हो (छोड़े जाने पर डिफ़ॉल्ट), तो प्रत्येक translate-docs रन जोखिम भरे डीलिमिटर / बिना बंद इनलाइन कोड के लिए मार्कडाउन खंडों को फिर से स्कैन करता है, टर्मिनल चेतावनियाँ प्रिंट करता है, और उस फ़ाइल के कैश फ़ाइलपाथ के लिए markdown_source_issues पंक्तियों को बदल देता है। इस ब्लॉक के लिए चेतावनियों और SQLite अपडेट को छोड़ने के लिए false सेट करें।
  • addFrontmatter जब true हो (छोड़े जाने पर डिफ़ॉल्ट), तो अनुवादित मार्कडाउन फ़ाइलों में YAML कुंजियाँ शामिल होती हैं: translation_last_updated, source_file_mtime, source_file_hash, translation_language, source_file_path, और जब कम से कम एक खंड में मॉडल मेटाडेटा हो, तो translation_models (सक्रिय प्रदाता से मॉडल आईडी की क्रमबद्ध सूची)। छोड़ने के लिए false पर सेट करें।
  • emphasisPlaceholders प्रति docs[] ब्लॉक। जब true हो, तो अनुवाद से पहले मार्कडाउन जोर सीमांकक को प्लेसहोल्डर के रूप में मास्क करें। CJK लोकेल (zh, ja, ko) और rtlLocales में सूचीबद्ध लोकेल के लिए डिफ़ॉल्ट रूप से true होता है; अन्यथा डिफ़ॉल्ट रूप से false होता है। CLI --emphasis-placeholders / --no-emphasis-placeholders के माध्यम से ओवरराइड किया जा सकता है।
  • rtlLocales जोर-प्लेसहोल्डर डिफ़ॉल्ट के लिए RTL के रूप में माने जाने वाले BCP-47 कोड की वैकल्पिक सरणी (अंतर्निहित RTL पहचान के साथ विलय)।

  • protectAttributes वैकल्पिक। अतिरिक्त JSX/HTML विशेषता नाम जिनके उद्धृत स्ट्रिंग मान अनुवादक को नहीं भेजे जाने चाहिए। बिल्ट-इन डिफ़ॉल्ट (class, id, style, src, href, type, data-*, अधिकांश aria-*, आदि) के साथ मर्ज किया गया। केस-असंवेदनशील। इस पर लागू होता है:

  • .astro पार्स-और-बदलें निष्कर्षण (स्थिर HTML टैग और {expression} ब्लॉक के अंदर attr= के बाद स्ट्रिंग लिटरल)।

    • मार्कडाउन/एस्ट्रो सेगमेंट अनुवाद के दौरान MDX प्लेसहोल्डर निष्कर्षण (पूंजीकृत JSX टैग पर label, tooltip, और aria-label, साथ ही लागू होने पर TabItem value)।

उदाहरण: "protectAttributes": ["variant", "size"] {items.map(...)} के अंदर variant="primary" को लोकेल में अपरिवर्तित रखता है।

आप सामान्य रूप से अनुवाद योग्य विशेषताओं (उदाहरण के लिए "title" या "aria-label") को भी सूचीबद्ध कर सकते हैं जब आप उन मानों को अंग्रेजी से शब्दशः कॉपी करना चाहते हैं।

  • protectKeys वैकल्पिक। अतिरिक्त ऑब्जेक्ट प्रॉपर्टी नाम जिनके उद्धृत स्ट्रिंग मानों का टेम्पलेट {expression} ब्लॉक और MDX ऑब्जेक्ट लिटरल (उदाहरण के लिए <Tabs values={[ … ]}> के अंदर label:) के अंदर अनुवाद नहीं किया जाना चाहिए। बिल्ट-इन डिफ़ॉल्ट (class, key, id, href, src, आदि) के साथ मर्ज किया गया। केस-असंवेदनशील।

उदाहरण: "protectKeys": ["slug", "code"] { slug: 'getting-started', title: 'Getting started' } को छोड़ देता है → जब slug सुरक्षित होता है तो केवल title का अनुवाद किया जाता है।


उदाहरण (docsOutput.style = "flat" — स्क्रीनशॉट पथ + वैकल्पिक भाषा सूची रैपर):

फ्लैट लेआउट पोस्टप्रोसेसिंग उदाहरण (स्क्रीनशॉट + भाषा सूची ब्लॉक)
json
"docsOutput": {
  "style": "flat",
  "postProcessing": {
    "regexAdjustments": [
      {
        "description": "Per-locale screenshot folders",
        "search": "images/screenshots/[^/]+/",
        "replace": "images/screenshots/${translatedLocale}/"
      }
    ],
    "languageListBlock": {
      "start": "<small id=\"lang-list\">",
      "end": "</small>",
      "separator": " · ",
      "label": "local"
    }
  }
}

json ​

नेस्टेड JSON अनुवाद पाइपलाइनों का शीर्ष-स्तरीय सरणी। केवल तभी उपयोग किया जाता है जब features.translateJson सत्य हो (translate-json या sync का JSON चरण)। JSON देखें।

फ़ील्डविवरण
descriptionCLI / status के लिए वैकल्पिक नोट (अनुवादित नहीं)।
contentPathsप्रोजेक्ट रूट के तहत स्रोत .json फ़ाइलें, निर्देशिकाएँ, या ग्लोब। विशिष्ट i18next नेमस्पेस फ़ाइलें (public/locales/en/*.json) समर्थित हैं: नेस्टेड ऑब्जेक्ट, एरे, स्ट्रिंग मानों में {{var}} इंटरपोलेशन, और स्वतंत्र बहुवचन प्रत्यय कुंजियाँ (key_one, key_other)।
outputPathTemplateप्रति लक्ष्य लोकेल आवश्यक आउटपुट पथ। प्लेसहोल्डर: {locale}, {LOCALE}, {llocale}, {stem}, {basename}, {extension}, {relativeToSourceRoot}।
targetLocalesइस ब्लॉक के लिए वैकल्पिक उपसमूह; अन्यथा रूट targetLocales।
keyPolicy.modeallowlist, denylist, या both।
keyPolicy.translateKeysजब मोड allowlist या both हो तो शामिल करने के लिए डॉट पथ / ग्लोब।
keyPolicy.skipKeysबाहर करने के लिए डॉट पथ / ग्लोब (डिफ़ॉल्ट डेनिलिस्ट में id, slug, href, url, key, code शामिल हैं)।

svg ​

SVG फ़ाइलों के लिए शीर्ष-स्तरीय पथ और लेआउट। अनुवाद केवल तभी चलता है जब features.translateSVG सत्य हो (translate-svg या sync के SVG चरण के माध्यम से)।

फ़ील्डविवरण
sourcePathएक या अधिक निर्देशिकाएँ या ग्लोब पैटर्न (जैसे "images/*.svg", "**/icons/*.svg")। पैटर्न प्रोजेक्ट रूट के सापेक्ष हल किए जाते हैं और .svg फ़ाइलों के लिए पुनरावर्ती रूप से स्कैन किए जाते हैं।
outputDirअनुवादित SVG आउटपुट के लिए रूट डायरेक्टरी।
stylepathTemplate अनसेट होने पर "flat" या "nested"।
pathTemplateकस्टम SVG आउटपुट पाथ। प्लेसहोल्डर: "{outputDir}", "{locale}", "{LOCALE}", "{llocale}", "{relPath}", "{stem}", "{basename}", "{extension}", "{relativeToSourceRoot}"।
localePathLowercaseजब true होता है, तो बिल्ट-इन flat / nested SVG लेआउट लोअरकेस लोकेल सेगमेंट का उपयोग करते हैं। कस्टम pathTemplate मान अपरिवर्तित रहते हैं; लोअरकेस सेगमेंट के लिए {llocale} का उपयोग करें।
forceLowercaseSVG रीअसेंबली पर अनुवादित टेक्स्ट को लोअर-केस करें। उन डिज़ाइनों के लिए उपयोगी है जो सभी-लोअरकेस लेबल पर निर्भर करते हैं।

modelSuggestion (वैकल्पिक) ​

ChrF और Arena वज़न, साथ ही एक वैकल्पिक गुणवत्ता सीमा, suggest-models और डैशबोर्ड के मॉडल टैब के लिए। इंडेक्स केवल गुणवत्ता का है। ब्लॉक को छोड़ दें, या एक प्रोफ़ाइल को छोड़ दें, और वह प्रोफ़ाइल अंतर्निहित वज़न को बनाए रखेगी। ब्लॉक को --apply या कॉन्फ़िग अपडेट करें द्वारा फिर से नहीं लिखा जाता है; वे केवल मॉडल आईडी लिखते हैं। कॉन्फ़िग लोड होने पर प्रोफ़ाइल पर एक पुराना price वज़न हटा दिया जाता है।

  • quality — डिफ़ॉल्ट ChrF 0.55, Arena 0.45, गुणवत्ता सीमा 0.7
  • price — डिफ़ॉल्ट ChrF 0.55, Arena 0.45, गुणवत्ता सीमा 0.6

प्रत्येक प्रोफ़ाइल ऑब्जेक्ट को chrf और arena की आवश्यकता होती है। प्रत्येक मान सीमित और कम से कम 0 है, और कम से कम एक 0 से अधिक है। उन्हें 1 तक योग करने के लिए सामान्यीकृत किया जाता है, ताकि 55 और 45 डिफ़ॉल्ट से मेल खाते हों। qualityFloor वैकल्पिक है, (0, 1] की सीमा में है, और उम्मीदवार पूल में सर्वश्रेष्ठ ChrF का अंश है। सीमा से नीचे के मॉडल, जिसमें ChrF माप के बिना कोई भी मॉडल शामिल है, उन मॉडलों के बाद क्रमबद्ध होते हैं जो इसे पार करते हैं। दोनों प्रोफ़ाइल एक ही डिफ़ॉल्ट मिश्रण साझा करते हैं; वे सॉर्ट ऑर्डर (इंडेक्स द्वारा --quality, पेरेटो फ्रंटियर द्वारा --price) और सीमा में भिन्न होते हैं।

json
"modelSuggestion": {
  "quality": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.7 },
  "price": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.6 }
}

glossary ​

फ़ील्डविवरण
userGlossaryOriginal language string (या en), locale, Translation, वैकल्पिक Force, और वैकल्पिक Context कॉलम वाले CSV का पथ - प्रति स्रोत शब्द और लक्ष्य लोकेल एक पंक्ति (locale सभी लक्ष्यों के लिए * हो सकता है)।
autoAddUserEditedToGlossaryजब true होता है, तो UI स्ट्रिंग्स में डैशबोर्ड संपादन स्वचालित रूप से उपयोगकर्ता शब्दावली में जोड़े जा सकते हैं।
contextFilesउत्पाद या सुविधा स्पष्टीकरण के साथ वैकल्पिक cwd-सापेक्ष मार्कडाउन या सादे-पाठ फ़ाइलें (.md, .markdown, .txt)। कमांड शुरू होने पर लोड की जाती हैं और UI, डॉक्स, JSON, SVG, और प्रूफरीड प्रॉम्प्ट में इंजेक्ट की जाती हैं। इन फ़ाइलों को docs[].contentPaths में न रखें जब तक कि आप उन्हें अनुवादित भी न करना चाहें। URL अस्वीकृत हैं। पूरा पाठ कॉन्फ़िगर किए गए LLM प्रदाता को भेजा जाता है और --debug-failed लॉग में दिखाई दे सकता है — रहस्य या PII शामिल न करें।
contextMaxCharsमॉडल को भेजे गए संयोजित संदर्भ-फ़ाइल पाठ के अधिकतम वर्ण (डिफ़ॉल्ट 12000, हार्ड कैप 100000)। अतिरिक्त पाठ को चेतावनी के साथ छोटा कर दिया जाता है।
labelCheckSkipsलॉक किए गए UI-लेबल चेक की वैकल्पिक सूची जिन्हें छोड़ना है। प्रत्येक प्रविष्टि में term (अंग्रेजी शब्दावली शब्द), locales (लक्ष्य कोड, या प्रत्येक लोकेल के लिए *; डिफ़ॉल्ट *), वैकल्पिक files (cwd-सापेक्ष ग्लोब), और वैकल्पिक note होता है। यह शब्द एक प्रॉम्प्ट संकेत बना रहता है। अगला translate-docs रन होने पर एक स्किप लागू होता है।

translate-docs, translate-json, और translate-svg प्रत्येक UI ब्लॉक से संकेत लेते हैं जिनका uiGlossary true (डिफ़ॉल्ट) होता है। यह उस ब्लॉक के strings.json में पहले से संग्रहीत अनुवादों का पुन: उपयोग करता है। किसी ब्लॉक को छोड़ने के लिए उस पर uiGlossary को false पर सेट करें। translate-ui और proofread-ui उन कैटलॉग का उपयोग संकेतों के रूप में नहीं करते हैं। संक्षिप्त UI-लेबल संक्षेपाक्षर (ट्रेलिंग-डॉट रूप जैसे Alm., या छोटे सिंगल-टोकन संपीड़न जैसे Size → Tam) को छोड़ दिया जाता है ताकि दस्तावेज़ प्रॉम्प्ट को आविष्कार किए गए {{…}} टोकन की ओर निर्देशित न किया जाए। पूर्ण उत्पाद शब्द और गैर-संक्षिप्त UI अनुवादों को अभी भी संकेत दिया जाता है।

वैकल्पिक Context CSV कॉलम उस शब्द के लिए स्रोत-भाषा उपयोग मार्गदर्शन (परिभाषा, व्याकरणिक उपयोग, उत्पाद अर्थ) है। इसे तभी शामिल किया जाता है जब शब्द वर्तमान बैच से मेल खाता हो। किसी शब्द के Context नोट या किसी contextFiles सामग्री को बदलने से अगले रन पर मिलान वाले लोकेल के कैश किए गए खंड और फ़ाइल-ट्रैकिंग पंक्तियाँ अमान्य हो जाती हैं, इसलिए अनुवाद स्वचालित रूप से ताज़ा हो जाते हैं। गैर-बलपूर्वक पंक्ति पर केवल एक पसंदीदा Translation बदलने से भी मौजूदा कैश का उपयोग होता है जब तक कि आप --force / --force-update पास न करें। एक Force पंक्ति केवल उन खंडों को छोड़ देती है जिनके स्रोत में वह शब्द होता है, जब संग्रहीत पाठ में पहले से ही बलपूर्वक अनुवाद शामिल नहीं होता है। डैशबोर्ड उपयोगकर्ता-संपादित कैश पंक्तियों को रखा जाता है। UI कैटलॉग एक साझा बहु-शब्द उपसर्ग को अपने स्वयं के शब्द के रूप में भी बीज करते हैं जब वह उपसर्ग एक पूंजीकृत लेबल (कम से कम दो सामग्री शब्द) होता है और साझा अनुवाद एक छोटा वाक्यांश होता है जिसमें कोई प्लेसहोल्डर नहीं होता है। मार्कडाउन अनुवाद के लिए दो से पाँच शब्दों वाले UI लेबल की आवश्यकता होती है ताकि वह अपनी कैटलॉग अनुवाद को बनाए रख सके जब स्रोत इसे पूरे बोल्ड या इनलाइन-कोड स्पैन के रूप में, एक हेडिंग में, या केवल उस लेबल वाली पंक्ति पर उद्धृत करता है। एक लंबा बोल्ड वाक्यांश जिसमें केवल वह शब्द होता है, एक संकेत है। वाक्य के भीतर शीर्षक केस एक संकेत है, ताकि अनुवाद विभक्ति कर सके (हिंदी Cursor account शब्दकोश रूप कर्सर खाता के बजाय कर्सर खाते बन सकता है)। एक सामग्री शब्द वाला लेबल, जैसे Sign in, एक संकेत बना रहता है। जाँच कैपिटलाइज़ेशन को अनदेखा करती है। इसे अभी भी कैटलॉग शब्दांकन को एक सबस्ट्रिंग के रूप में चाहिए, इसलिए एक व्याकरणिक रूप से विभक्ति वाला रूप विफल हो सकता है। वह विफलता एक चेतावनी है: खंड लिखा जाता है, एक शब्दावली-लेबल ध्वज के साथ कैश किया जाता है, और रन के अंत में glossary-review-*.md में cacheDir के तहत सूचीबद्ध किया जाता है। इसकी समीक्षा करने के बाद एक labelCheckSkips प्रविष्टि जोड़ें, या --recheck-glossary-warnings पास करें। --force ध्वजांकित पंक्तियों को हर दूसरे खंड के साथ फिर से अनुवादित करता है।

उदाहरण:

json
{
  "glossary": {
    "userGlossary": "i18n/glossary.csv",
    "contextFiles": ["i18n/product-context.md", "i18n/billing-feature.md"],
    "contextMaxChars": 12000,
    "labelCheckSkips": [
      {
        "term": "Target language",
        "locales": ["uk"],
        "files": ["website/src/content/docs/docs/transform.md"],
        "note": "Inflected inside a bold phrase"
      }
    ]
  }
}

एक खाली शब्दावली CSV जनरेट करें:

bash
ai-i18n-tools glossary-generate

रिपॉजिटरी से contextFiles का ड्राफ्ट तैयार करने के लिए, AI एजेंट के साथ कॉन्टेक्स्ट फ़ाइल जनरेट करें में कॉपी-पेस्ट एजेंट प्रॉम्प्ट का उपयोग करें। शब्द पंक्तियों और कॉन्टेक्स्ट फ़ाइलों को कैसे लागू किया जाता है, यह जानने के लिए शब्दावली देखें।

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