कॉन्फ़िगरेशन संदर्भ
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 पास करें।
उदाहरण:
{
"uiBatchConcurrency": 2
}डिफ़ॉल्ट लोकेल समवर्ती 4 के साथ, यह 8 इन-फ़्लाइट UI API कॉल तक है। एक बड़े लोकेल (-l de) का अनुवाद करते समय इसे बढ़ाएँ; यदि प्रदाता दर-सीमित करता है तो इसे कम रखें।
fileConcurrency (वैकल्पिक)
translate-docs और sync के दौरान एक ही स्थान-विशेष में समवर्ती रूप से संसाधित की जाने वाली फ़ाइलों की अधिकतम संख्या। जब 1 से अधिक मान पर सेट किया जाता है, तो मेमोरी उपयोग को नियंत्रित करने के लिए एक सेमाफोर का उपयोग करके एक ही स्थान-विशेष के भीतर फ़ाइलों को समानांतर में संसाधित किया जाता है। छोड़े जाने पर डिफ़ॉल्ट 1 (अनुक्रमिक प्रसंस्करण)। उच्च मान I/O-बाउंड ऑपरेशनों के लिए थ्रूपुट में काफी सुधार कर सकते हैं, खासकर जब सभी सेगमेंट पहले से ही कैश किए गए हों (किसी API कॉल की आवश्यकता नहीं)।
उदाहरण:
{
"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। कॉन्फ़िग लोड पर डुप्लिकेट सामान्यीकृत लोकेल कुंजियों को अस्वीकार कर दिया जाता है।baseUrlOpenAI-संगत बेस URL। प्रीसेट बेस URL को ओवरराइड करता है; गैर-प्रीसेट प्रदाता के लिए आवश्यक है।apiKeyEnvAPI कुंजी रखने वाला पर्यावरण चर। प्रीसेट 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पंक्ति पर संग्रहीत की जाती है।
लागत स्रोत इस क्रम में हल किया जाता है:
- एक मिलान वाली
modelPricingप्रविष्टि (इस प्रदाता डिफ़ॉल्ट को ओवरराइड करती है); - एक प्रदाता-रिपोर्टेड लागत (कभी प्रतिस्थापित नहीं की जाती);
- यह
pricingदर; - उस मॉडल 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):
| प्रदाता | बेस यूआरएल | एपीआई-की एनवायरनमेंट वेरिएबल |
|---|---|---|
alibaba | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 | ALIBABA_API_KEY |
anthropic | https://api.anthropic.com/v1 | ANTHROPIC_API_KEY |
apikeyfan | https://api.apikey.fan/v1 | APIKEYFAN_API_KEY |
cerebras | https://api.cerebras.ai/v1 | CEREBRAS_API_KEY |
cheaperinference | https://api.cheaperinference.com/v1 | CHEAPERINFERENCE_API_KEY |
deepseek | https://api.deepseek.com | DEEPSEEK_API_KEY |
gemini | https://generativelanguage.googleapis.com/v1beta/openai | GOOGLE_API_KEY |
groq | https://api.groq.com/openai/v1 | GROQ_API_KEY |
mistral | https://api.mistral.ai/v1 | MISTRAL_API_KEY |
nvidia | https://integrate.api.nvidia.com/v1 | NVIDIA_API_KEY |
ollama | http://localhost:11434/v1 | (कोई नहीं) |
openai | https://api.openai.com/v1 | OPENAI_API_KEY |
openrouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
xai | https://api.x.ai/v1 | XAI_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 ट्रांसलेशनमॉडल सूची
"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
"uiModels": [
"~anthropic/claude-sonnet-latest",
"z-ai/glm-5.2"
]एशियाई भाषाओं के लिए अनुशंसित localeModels: जापानी, कोरियाई और चीनी लोकेल अक्सर उन स्क्रिप्ट के लिए ट्यून किए गए मॉडल से लाभान्वित होते हैं। प्रति-लोकेल ओवरराइड जोड़ें जिन्हें लक्षित लोकेल के मिलान होने पर पहले (uiModels / translationModels से पहले) आज़माया जाता है:
जा, को, झ-हंस, झ-हंत के लिए अनुशंसित लोकेलमॉडल
"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
| फ़ील्ड | पाइपलाइन | विवरण |
|---|---|---|
translateUIStrings | 1 | t("…") / i18n.t("…") को strings.json में निकालें, फिर प्रविष्टियों का अनुवाद करें और प्रति-लोकेल फ़्लैट JSON लिखें (निष्कर्षण स्वचालित रूप से चलता है; केवल कैटलॉग को ताज़ा करने के लिए स्टैंडअलोन extract का उपयोग करें)। |
translateDocs | 2 | .md / .mdx / .astro / .html / .htm पृष्ठों का अनुवाद करें; जब docs[].docusaurusCatalogDir सेट हो तो Docusaurus शेल JSON; कॉन्फ़िगर होने पर Nextra _meta / शब्दकोश; जब docsOutput.vitepressThemeCatalog सेट हो तो VitePress थीम; जब docsOutput.style "fumadocs" हो तो Fumadocs meta.json / UI कैटलॉग। |
translateJson | 3 | json[] (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के दौरान सैटेलाइट्स पढ़ता है।neutralFileLoginButtonजैसी लेगेसी नामित कुंजियों को न्यूट्रल मान के माध्यम से मैप करता है। संदर्भ कुंजियाँ U+2404 का उपयोग करती हैं। बहुवचन रूप{singular}[{form}]नामक अलग प्रविष्टियाँ हैं।flatOutput: falseवाले ब्लॉक कोgettextयाresxसेट करना होगा।gettextइस ब्लॉक के लिए वैकल्पिक GNU gettext आउटपुट।outputDir(डिफ़ॉल्ट./locales)<locale>/LC_MESSAGES/<domain>.poप्राप्त करता है और, जबcompileMotrue (डिफ़ॉल्ट) होता है, तो मिलान करने वाला.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.jsontranslate-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.jsondescriptionको 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
cacheDirSQLite कैश निर्देशिका (सभी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।
# Cache
.translation-cache/*
!.translation-cache/cache.db
benchmark-scores.json
# Environment
.env
.env.local
.env.*.local
# Temporary files
*.tmp
*.backup.*docs
डॉक्यूमेंटेशन पाइपलाइन ब्लॉक का ऐरे। translate-docs और sync का डॉक्स चरण प्रत्येक ब्लॉक को क्रम में प्रोसेस करता है। लेगेसी कुंजियाँ लोड समय पर अभी भी स्वीकार की जाती हैं और जब कॉन्फ़िग फ़ाइल लिखने योग्य होती है तो फिर से लिखी जाती हैं; नई कॉन्फ़िग में वर्तमान नामों को प्राथमिकता दें।
| लेगेसी कुंजी | वर्तमान कुंजी / व्यवहार |
|---|---|
documentations | docs |
markdownOutput | docs[].docsOutput |
jsonSource | docs[].docusaurusCatalogDir |
शीर्ष-स्तरीय openrouter | providers.openrouter + provider: "openrouter" |
features.translateMarkdown | features.translateDocs |
features.translateJSON | हटा दिया गया (docs[].docusaurusCatalogDir या json[] का उपयोग करें) |
features.extractUIStrings | हटा दिया गया (extract UI अनुवाद से पहले चलता है) |
glossary.uiGlossary और glossary.uiGlossaryFromStringsJson | हटाए गए; कॉन्फ़िग लोड विफल रहता है। ui[].uiGlossary (बूलियन, डिफ़ॉल्ट true) का उपयोग करें |
ui.reactExtractor | ui.uiExtractor (उपनाम अभी भी स्वीकार किया गया) |
svg.svgExtractor.forceLowercase | svg.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.docsRootDocusaurus लेआउट के लिए स्रोत डॉक्स रूट (जैसे"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.jsi18nके लिए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}.jsoncatalogPathके बगल में)।docs[].fumadocsMetaGlobजबdocsOutput.style"fumadocs"हो तोmeta.jsonसंग्रह के लिए वैकल्पिक ग्लोब। डिफ़ॉल्ट:docsOutput.docsRootके अंतर्गत रिकर्सिवmeta.json।docs[].fumadocsMetaTranslatableKeysप्रॉपर्टी नाम जिनके स्ट्रिंग मानों का Fumadocsmeta.jsonमें अनुवाद किया जाता है (डिफ़ॉल्ट:title,description)।docsOutput.localizedAssetsजब कोई लोकेल फ़ाइल मौजूद हो तो अनुवादित HTML में छवि और आइकन URL का वैकल्पिक पुनर्नामकरण। फ़ील्ड:include(डिफ़ॉल्टimg/**),pattern(डिफ़ॉल्ट{stem}-{locale}{ext}),onlyIfExists(डिफ़ॉल्टtrue),assetRoot(रूट-रिलेटिव URL का परीक्षण करने के लिए उपयोग की जाने वाली डायरेक्टरी; डिफ़ॉल्ट HTML फ़ाइल की डायरेक्टरी है)। प्लेसहोल्डर:{stem},{ext},{basename},{locale},{llocale},{LOCALE}। CSSurl()को फिर से नहीं लिखा जाता है। HTML पृष्ठ देखें।docsOutput.htmlHTML दस्तावेज़ों के लिए वैकल्पिक भाषा सूची और 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"? }। जबenabledtrueहो (segmentSplittingछोड़े जाने पर डिफ़ॉल्ट), तो सघन पैराग्राफ, GFM पाइप टेबल (पहले चंक में हेडर, सेपरेटर और पहली डेटा पंक्ति शामिल होती है), और लंबी सूचियाँ विभाजित हो जाती हैं; उप-भाग एकल नई लाइनों (tightJoinPrevious) के साथ फिर से जुड़ते हैं। केवल प्रति खाली-पंक्ति-सीमांकित बॉडी ब्लॉक एक खंड का उपयोग करने के लिए"enabled": falseसेट करें। जबqualityRetrySplittrueहो (डिफ़ॉल्ट), तो मॉडल सूची रुकने के बाद 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, साथ ही लागू होने परTabItemvalue)।
- मार्कडाउन/एस्ट्रो सेगमेंट अनुवाद के दौरान MDX प्लेसहोल्डर निष्कर्षण (पूंजीकृत JSX टैग पर
उदाहरण: "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" — स्क्रीनशॉट पथ + वैकल्पिक भाषा सूची रैपर):
फ्लैट लेआउट पोस्टप्रोसेसिंग उदाहरण (स्क्रीनशॉट + भाषा सूची ब्लॉक)
"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 देखें।
| फ़ील्ड | विवरण |
|---|---|
description | CLI / status के लिए वैकल्पिक नोट (अनुवादित नहीं)। |
contentPaths | प्रोजेक्ट रूट के तहत स्रोत .json फ़ाइलें, निर्देशिकाएँ, या ग्लोब। विशिष्ट i18next नेमस्पेस फ़ाइलें (public/locales/en/*.json) समर्थित हैं: नेस्टेड ऑब्जेक्ट, एरे, स्ट्रिंग मानों में {{var}} इंटरपोलेशन, और स्वतंत्र बहुवचन प्रत्यय कुंजियाँ (key_one, key_other)। |
outputPathTemplate | प्रति लक्ष्य लोकेल आवश्यक आउटपुट पथ। प्लेसहोल्डर: {locale}, {LOCALE}, {llocale}, {stem}, {basename}, {extension}, {relativeToSourceRoot}। |
targetLocales | इस ब्लॉक के लिए वैकल्पिक उपसमूह; अन्यथा रूट targetLocales। |
keyPolicy.mode | allowlist, 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 आउटपुट के लिए रूट डायरेक्टरी। |
style | pathTemplate अनसेट होने पर "flat" या "nested"। |
pathTemplate | कस्टम SVG आउटपुट पाथ। प्लेसहोल्डर: "{outputDir}", "{locale}", "{LOCALE}", "{llocale}", "{relPath}", "{stem}", "{basename}", "{extension}", "{relativeToSourceRoot}"। |
localePathLowercase | जब true होता है, तो बिल्ट-इन flat / nested SVG लेआउट लोअरकेस लोकेल सेगमेंट का उपयोग करते हैं। कस्टम pathTemplate मान अपरिवर्तित रहते हैं; लोअरकेस सेगमेंट के लिए {llocale} का उपयोग करें। |
forceLowercase | SVG रीअसेंबली पर अनुवादित टेक्स्ट को लोअर-केस करें। उन डिज़ाइनों के लिए उपयोगी है जो सभी-लोअरकेस लेबल पर निर्भर करते हैं। |
modelSuggestion (वैकल्पिक)
ChrF और Arena वज़न, साथ ही एक वैकल्पिक गुणवत्ता सीमा, suggest-models और डैशबोर्ड के मॉडल टैब के लिए। इंडेक्स केवल गुणवत्ता का है। ब्लॉक को छोड़ दें, या एक प्रोफ़ाइल को छोड़ दें, और वह प्रोफ़ाइल अंतर्निहित वज़न को बनाए रखेगी। ब्लॉक को --apply या कॉन्फ़िग अपडेट करें द्वारा फिर से नहीं लिखा जाता है; वे केवल मॉडल आईडी लिखते हैं। कॉन्फ़िग लोड होने पर प्रोफ़ाइल पर एक पुराना price वज़न हटा दिया जाता है।
quality— डिफ़ॉल्ट ChrF0.55, Arena0.45, गुणवत्ता सीमा0.7price— डिफ़ॉल्ट ChrF0.55, Arena0.45, गुणवत्ता सीमा0.6
प्रत्येक प्रोफ़ाइल ऑब्जेक्ट को chrf और arena की आवश्यकता होती है। प्रत्येक मान सीमित और कम से कम 0 है, और कम से कम एक 0 से अधिक है। उन्हें 1 तक योग करने के लिए सामान्यीकृत किया जाता है, ताकि 55 और 45 डिफ़ॉल्ट से मेल खाते हों। qualityFloor वैकल्पिक है, (0, 1] की सीमा में है, और उम्मीदवार पूल में सर्वश्रेष्ठ ChrF का अंश है। सीमा से नीचे के मॉडल, जिसमें ChrF माप के बिना कोई भी मॉडल शामिल है, उन मॉडलों के बाद क्रमबद्ध होते हैं जो इसे पार करते हैं। दोनों प्रोफ़ाइल एक ही डिफ़ॉल्ट मिश्रण साझा करते हैं; वे सॉर्ट ऑर्डर (इंडेक्स द्वारा --quality, पेरेटो फ्रंटियर द्वारा --price) और सीमा में भिन्न होते हैं।
"modelSuggestion": {
"quality": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.7 },
"price": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.6 }
}glossary
| फ़ील्ड | विवरण |
|---|---|
userGlossary | Original 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 ध्वजांकित पंक्तियों को हर दूसरे खंड के साथ फिर से अनुवादित करता है।
उदाहरण:
{
"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 जनरेट करें:
ai-i18n-tools glossary-generateरिपॉजिटरी से contextFiles का ड्राफ्ट तैयार करने के लिए, AI एजेंट के साथ कॉन्टेक्स्ट फ़ाइल जनरेट करें में कॉपी-पेस्ट एजेंट प्रॉम्प्ट का उपयोग करें। शब्द पंक्तियों और कॉन्टेक्स्ट फ़ाइलों को कैसे लागू किया जाता है, यह जानने के लिए शब्दावली देखें।