शब्दावली
शब्दावली अनुवादों में सुसंगत उत्पाद शब्दावली सुनिश्चित करती है। उपयोगकर्ता किसी शब्द का अनुवाद एक या कई भाषाओं में परिभाषित कर सकते हैं, जिससे AI मॉडल स्वयं चुनने के बजाय इस पूर्वनिर्धारित अनुवाद का उपयोग कर सके। इसका उपयोग कुछ शब्दों, जैसे उत्पाद नामों को, अन्य भाषाओं में अनुवाद के दौरान अपरिवर्तित रखने के लिए भी किया जा सकता है।
मॉडल को दो प्रकार के मार्गदर्शन भेजे जाते हैं:
glossary.userGlossaryमें शब्द पंक्तियाँ (और दस्तावेज़ीकरण, JSON, और SVG के लिए, प्रत्येकuiब्लॉक से मौजूदा UI अनुवाद जहाँuiGlossaryचालू छोड़ा गया है)। कोई पंक्ति केवल तभी शामिल की जाती है जब वह स्रोत शब्द अनुवादित किए जा रहे टेक्स्ट में दिखाई देता है।glossary.contextFilesमें प्रोजेक्ट संदर्भ फ़ाइलें। पूर्ण ब्रीफ़ को हर UI, दस्तावेज़, JSON, SVG, और प्रूफ़रीड प्रॉम्प्ट में इंजेक्ट किया जाता है। वह अनुभाग नीचे दिया गया है।
शब्दावली कैसे काम करती है
शब्द कहाँ से आते हैं
| स्रोत | कॉन्फ़िगरेशन | इसके द्वारा उपयोग किया गया |
|---|---|---|
| UI कैटलॉग | ui[].uiGlossary (बूलियन, डिफ़ॉल्ट true) — उस ब्लॉक का stringsJson | translate-docs, translate-json, translate-svg |
| उपयोगकर्ता CSV | glossary.userGlossary | translate-ui, proofread-ui, translate-docs, translate-json, translate-svg |
init glossary.userGlossary को glossary-user.csv पर इंगित करता है और उस फ़ाइल को नहीं बनाता है। जब यह गुम हो, तो glossary-generate चलाएँ, और पहले translate-ui से पहले इसमें डोमेन शब्द डालें। एक अपरिवर्तित स्ट्रिंग का दूसरा अनुवाद अलग तरह से शब्दबद्ध होकर वापस आ सकता है। शब्दावली ही है जो दोनों रन को सहमत कराती है।
uiGlossary: true वाला एक ब्लॉक अपने strings.json में पहले से संग्रहीत अनुवादों का उपयोग संकेतों के रूप में करता है, ताकि दस्तावेज़ीकरण, JSON, और SVG, UI के साथ संरेखित रहें। translate-ui और proofread-ui उन कैटलॉग को नहीं पढ़ते हैं — वे केवल उपयोगकर्ता CSV से संकेत लेते हैं, ताकि किसी खराब UI अनुवाद को पसंदीदा शब्द के रूप में वापस न भेजा जाए। किसी ऐसे ब्लॉक पर uiGlossary को false पर सेट करें जिसे अन्य पाइपलाइनों को निर्देशित नहीं करना चाहिए। जब कई ब्लॉक एक स्रोत शब्द साझा करते हैं, तो पहले वाला ब्लॉक एक लोकेल भरता है और बाद वाले ब्लॉक केवल उन्हीं लोकेल को जोड़ते हैं जो अभी भी अनुपलब्ध हैं। उपयोगकर्ता CSV को हर UI कैटलॉग पर प्राथमिकता दी जाती है। वह पंक्ति जिसका locale एक विशिष्ट कोड है, उस लोकेल के लिए * पंक्ति और UI-कैटलॉग अनुवाद दोनों को बदल देती है। * का locale उसी अनुवाद को हर उस लक्ष्य लोकेल पर लागू करता है जिसके पास पहले से UI कैटलॉग से कोई अनुवाद नहीं है।
संक्षिप्त UI-लेबल संक्षिप्ताक्षर (जैसे Alm. में अनुगामी बिंदु, या Size → Tam जैसा छोटा एकल-टोकन संपीड़न) UI अनुवाद के लिए उपलब्ध रहते हैं। दस्तावेज़ प्रॉम्प्ट उन्हें छोड़ देते हैं, ताकि वे मॉडलों को मार्कडाउन या MDX में काल्पनिक {{…}} टोकन की ओर न धकेलें।
दो या अधिक कैटलॉग कुंजियों द्वारा साझा किया गया एक बहु-शब्द उपसर्ग अपने आप में एक पद के रूप में जोड़ा जाता है जब वह उपसर्ग पहले से कुंजी नहीं होता है। प्रत्येक स्थान-विशेष के लिए, अनुवाद उन कैटलॉग अनुवादों की साझा शुरुआत होती है, जिसे शब्द सीमा पर काटा जाता है, और केवल तभी जब वह साझा शुरुआत कम से कम चार अक्षर की हो। Cursor Models run out और Cursor Models at renewal Cursor Models उत्पन्न कर सकते हैं जब दोनों जर्मन स्ट्रिंग Cursor-Modelle से शुरू होते हैं। उसी स्रोत के लिए एक उपयोगकर्ता CSV पंक्ति उस सीडेड अनुवाद को बदल देती है।
जब कोई शब्द भेजा जाता है
मिलान केस-असंवेदी होता है और शब्द सीमा (रिक्त स्थान या विराम चिह्न) पर रुक जाता है। लंबे शब्दों को प्राथमिकता दी जाती है, और अतिव्यापी मिलान हटा दिए जाते हैं। जब कोई शब्द वर्तमान बैच से मेल खाता है, तो प्रॉम्प्ट को "dashboard" → "Tableau" जैसा संकेत मिलता है। यदि उस पंक्ति में संदर्भ नोट है, तो वह नोट केवल उस मिलान के लिए जोड़ा जाता है।
संदर्भ स्रोत-भाषा उपयोग मार्गदर्शन (पद का क्या अर्थ है, या इसका उपयोग कैसे करें) है। यह अनुवाद नहीं है। संदर्भ नोट, या किसी भी glossary.contextFiles सामग्री को बदलने से अगली बार चलाने पर प्रभावित स्थान-विशेष के लिए कैश्ड अनुवाद रीफ़्रेश हो जाते हैं — आपको --force की आवश्यकता नहीं है। ऐसी पंक्ति पर केवल पसंदीदा अनुवाद को बदलना जो फ़ोर्स नहीं है, मौजूदा कैश को तब तक बनाए रखता है जब तक आप --force या --force-update पास नहीं करते। एक फ़ोर्स पंक्ति (नई, संपादित, या हटाई गई) केवल उन खंडों के लिए कैश को मिस करती है जिनके स्रोत में वह पद शामिल है, और केवल तभी जब संग्रहीत पाठ में पहले से ही फ़ोर्स किया गया अनुवाद शामिल न हो। इस संकीर्ण रीफ़्रेश के लिए उस पंक्ति पर संदर्भ को खाली छोड़ दें; एक संदर्भ नोट अभी भी पूरे स्थान-विशेष को रीफ़्रेश करता है। डैशबोर्ड में आपके द्वारा संपादित की गई पंक्तियाँ user-edited के रूप में रहती हैं।
मार्कडाउन अनुवाद एक यूआई लेबल की जाँच करता है जब स्रोत इसे पूरे बोल्ड या इनलाइन-कोड स्पैन के रूप में, एक शीर्षक में, या केवल उस लेबल वाली पंक्ति पर उद्धृत करता है। एक लंबा बोल्ड वाक्यांश जिसमें शब्द शामिल है, एक संकेत है, इसलिए **Ask for target language** को Target language के कैटलॉग रूप की आवश्यकता नहीं होती है। एक-शब्द संकेत अभी भी विभक्त हो सकते हैं। एक उपयोगकर्ता-सीएसवी संकेत जो यूआई लेबल नहीं है, वह संकेत बना रहता है। जाँच पूंजीकरण को अनदेखा करती है और कैटलॉग शब्दावली को सबस्ट्रिंग के रूप में देखती है, इसलिए एक विभक्त रूप अभी भी चूक सकता है। यह अगले मॉडल का प्रयास करता है जब तक कि वही गुणवत्ता त्रुटि तीन बार नहीं हुई हो या मॉडल सूची समाप्त न हो जाए, और यह लेबल चूक के लिए खंड को विभाजित नहीं करता है। यदि वे प्रयास केवल उस जाँच को चूकते हैं, तो रन सबसे कम चूक वाले प्रयास को रखता है, दस्तावेज़ लिखता है, और शब्दावली-लेबल चेतावनी के साथ खंड को कैश करता है। सारांश उन चेतावनियों को सूचीबद्ध करता है, और cacheDir को glossary-review-*.md प्राप्त होता है, एक प्रॉम्प्ट जिसे आप प्रत्येक चूक को झूठी सकारात्मक या वास्तविक चूक के रूप में चिह्नित करने के लिए एआई में पेस्ट कर सकते हैं। जब एकमात्र समस्या वह चेतावनी होती है, तो निकास कोड 0 रहता है।
गलत सकारात्मक को प्रोजेक्ट कॉन्फ़िग में glossary.labelCheckSkips के साथ छोड़ा जा सकता है (डैशबोर्ड का शब्दावली टैब उसी सूची को संपादित करता है)। प्रत्येक प्रविष्टि में अंग्रेज़ी term, छोड़ने के लिए locales (* का मतलब है हर स्थानीय भाषा), और वैकल्पिक files ग्लोब का नाम होता है। यह शब्द एक प्रॉम्प्ट संकेत बना रहता है। --recheck-glossary-warnings फ़्लैग किए गए खंडों का फिर से अनुवाद करता है और जब जाँच अब पास हो जाती है तो फ़्लैग हटा देता है। --force उनका हर दूसरे खंड के साथ फिर से अनुवाद करता है। कैश किए गए मार्कडाउन की फिर से जाँच की जाती है जब फ़ाइल को संसाधित किया जाता है (--force-update); एक फ़ाइल जिसे फ़ाइल ट्रैकिंग छोड़ देती है, उसे वैसे ही छोड़ दिया जाता है जब तक उस फ़ाइल में कोई फ़ोर्स शब्द आउटपुट से गायब न हो जाए, या जब तक --recheck-glossary-warnings एक ऐसी फ़ाइल नहीं खोलता जिसमें फ़्लैग किया गया खंड हो। एक कैटलॉग अनुवाद जो स्रोत से भिन्न है, जहाँ भी उस लेबल का उल्लेख किया गया है, वहाँ आवश्यक है, जिसमें एक अनुवादित उत्पाद नाम भी शामिल है। स्रोत वर्तनी को एक फ़ोर्स पंक्ति के साथ बनाए रखें जिसका अनुवाद स्रोत के बराबर है।
बलपूर्वक
जब बलपूर्वक true, yes, या 1 हो, तो स्रोत शब्द को मॉडल के देखने से पहले पाठ से हटा दिया जाता है और बाद में पसंदीदा अनुवाद वापस लिख दिया जाता है। शब्दांकन सटीक होता है, सुझाव नहीं। वही शब्द-सीमा और सबसे लंबे मिलान के नियम लागू होते हैं। जब मॉडल को अनुवाद पसंद करना चाहिए लेकिन फिर भी उसे विभक्त कर सकता है, तो बलपूर्वक को खाली छोड़ें (या false)।
शब्दावली जनरेट करें
glossary-generate मानक हेडर के साथ एक खाली CSV लिखता है। यह कॉन्फ़िग से glossary.userGlossary का उपयोग करता है, या जब वह कुंजी सेट न हो तो glossary-user.csv का। यह पहले से मौजूद फ़ाइल को अधिलेखित करने से मना करता है (एक्ज़िट 1)।
ai-i18n-tools glossary-generate
# or: ai-i18n-tools glossary-generate -o i18n/glossary.csvकॉन्फ़िग को फ़ाइल पर इंगित करें:
{
"glossary": {
"userGlossary": "i18n/glossary.csv"
}
}आप डैशबोर्ड से सीधे सीएसवी शब्दावली फ़ाइल भी बना सकते हैं। यदि glossary.userGlossary निर्दिष्ट है और फ़ाइल पहले से मौजूद नहीं है, तो शब्दावली टैब पर पहली जोड़ें कार्रवाई फ़ाइल बना देगी। जब glossary.autoAddUserEditedToGlossary का मान true (डिफ़ॉल्ट) होता है, तो डैशबोर्ड में किसी यूआई स्ट्रिंग को सुधारने पर अगले translate-ui रन के दौरान वह परिवर्तन सीएसवी में जोड़ा जा सकता है। डैशबोर्ड सीएसवी शब्दावली के संपादक के रूप में भी काम करता है, जिससे आप यूआई के भीतर पंक्तियों को जोड़, संपादित या फ़िल्टर कर सकते हैं।
CSV कॉलम
हेडर पंक्ति:
Original language string,locale,Translation,Force,Contexten या English, Original language string के बजाय स्वीकार किया जाता है। Notes, Context के बजाय स्वीकार किया जाता है।
| कॉलम | अर्थ |
|---|---|
| मूल भाषा स्ट्रिंग | स्रोत लोकेल में स्रोत शब्द या वाक्यांश |
| लोकेल | लक्ष्य लोकेल कोड, या हर लक्ष्य के लिए * |
| अनुवाद | पसंदीदा अनुवाद |
| फ़ोर्स | इस शब्दावली को अनिवार्य करने के लिए true, yes, या 1; अन्यथा यह एक संकेत है |
| संदर्भ | वैकल्पिक स्रोत-भाषा स्पष्टीकरण। यह केवल तभी भेजा जाता है जब यह शब्द मेल खाता है |
उदाहरण
हर लोकेल के लिए एक उत्पाद शब्द, एक अनिवार्य जर्मन लेबल, और एक फ्रेंच पंक्ति जो एक ऐसे शब्द की व्याख्या करती है जिसे मॉडल शाब्दिक रूप से ले सकता है:
"Original language string","locale","Translation","Force","Context"
"dashboard","*","Tableau","false","The analytics home, not a vehicle panel"
"Save","de","Speichern","true",""
"workspace","fr","espace de travail","false","A user's project container, not an office"एक प्रोजेक्ट ब्रीफ़ के साथ संयुक्त:
{
"glossary": {
"userGlossary": "i18n/glossary.csv",
"contextFiles": ["i18n/product-context.md"],
"contextMaxChars": 12000
}
}फ़ील्ड संदर्भ: कॉन्फ़िगरेशन में glossary। कमांड संदर्भ: glossary-generate।
प्रोजेक्ट संदर्भ फ़ाइलें
glossary.contextFiles उत्पाद-स्तर के मार्गदर्शन के लिए है जो एक CSV पंक्ति में नहीं आता है: उत्पाद क्या है, यह किसके लिए है, स्वर और वे शब्द जिन्हें गलत अनुवाद करना आसान है। कॉन्फ़िग को एक या अधिक cwd-सापेक्ष .md / .txt फ़ाइलों पर इंगित करें; उन्हें सूचीबद्ध क्रम में जोड़ा जाता है और हर UI, दस्तावेज़, JSON, SVG और प्रूफरीड प्रॉम्प्ट में इंजेक्ट किया जाता है।
{
"glossary": {
"userGlossary": "i18n/glossary.csv",
"contextFiles": ["i18n/product-context.md"]
}
}संक्षिप्त विवरण स्रोत स्थान-भाषा में लिखें, इसे glossary.contextMaxChars (डिफ़ॉल्ट 12000) से काफी कम रखें, और इसे docs[].contentPaths के बाहर संग्रहीत करें जब तक कि आप उस फ़ाइल का भी अनुवाद नहीं करना चाहते। कॉन्फ़िगरेशन में glossary देखें।
AI एजेंट के साथ संदर्भ फ़ाइल बनाएं
एक एजेंट (कर्सर, क्लाउड कोड, कोपायलट, और इसी तरह) से रेपो पढ़ने और संक्षिप्त विवरण लिखने के लिए कहें। इस तरह का एक प्रॉम्प्ट पेस्ट करें:
Create a translation-context Markdown file for this repository at i18n/product-context.md.
This file is injected verbatim into every ai-i18n-tools translation prompt (UI strings, docs, JSON, SVG, proofread). It must stay in the source language of the project (do not translate it). Translators already receive a glossary of preferred term mappings; this file should explain meaning, audience, and register — not duplicate every glossary row.
Requirements:
- Concise: aim for 1–4 KB, hard limit 8000 characters. No full manuals, README dumps, or changelog history.
- Source-language only. Short headings, bullet lists, and a few example sentences are enough.
- No secrets, API keys, credentials, personal data, internal URLs, or unpublished commercial figures.
- Do not invent product facts. If something is unclear, omit it or mark it as unknown.
- Do not put this file under a path that is also listed in docs[].contentPaths.
Cover, in this order:
1. Product in one paragraph: what it is, who uses it, and the default tone (formal / informal / technical).
2. Domain and disambiguation: terms that look ordinary in English but have a product-specific meaning (for example “dashboard” as an analytics home, not a vehicle panel).
3. Features or areas that change register (billing vs. onboarding vs. admin).
4. Things translators must preserve exactly: brand names, CLI flags, config keys, code identifiers, placeholder tokens.
5. Locale notes only when they affect meaning for every target (for example “use formal you”). Do not list per-locale translations here.
Write only the Markdown file. Afterward, remind me to add it to glossary.contextFiles in ai-i18n-tools.config.json if it is not already listed.अगले sync / translate-* रन से पहले फ़ाइल की समीक्षा करें। फ़ाइल बदलने से उस रन पर प्रत्येक स्थान-भाषा के लिए कैश किए गए अनुवाद अमान्य हो जाते हैं, इसलिए गुणवत्ता अच्छी होने के बाद संक्षिप्त विवरण को स्थिर रखें।