यूआई स्ट्रिंग
extract और translate-ui के लिए संदर्भ, वह पाइपलाइन जो t() कॉल को प्रति-स्थानिक कैटलॉग में बदलती है। पहली बार किसी ऐप में i18n जोड़ रहे हैं? किसी JS/TS ऐप में i18n जोड़ें, किसी Python ऐप में i18n जोड़ें, या किसी .NET ऐप में i18n जोड़ें से शुरू करें। वे रैपिंग चरण को कवर करते हैं, फिर आपको चरण 2 से 4 के लिए यहां वापस भेजते हैं।
यह पाइपलाइन JS/TS प्रोजेक्ट (React, Next.js क्लाइंट और सर्वर कंपोनेंट, Node.js सेवाएं, सादा HTML, Astro वेबसाइट और CLI टूल), Python एप्लिकेशन और .NET एप्लिकेशन के लिए है। JS/TS स्रोत t() को कॉल करने के बाद i18next के साथ स्ट्रिंग खोजता है। Python एक जनरेटेड i18n.py के माध्यम से t() या gettext को कॉल करता है (Django, Django के gettext को रखता है)। .NET एक जनरेटेड I18n.cs के माध्यम से T() को कॉल करता है।
कौन सी गाइड पढ़ें
| आपका ऐप | आगे पढ़ें |
|---|---|
हार्डकोडेड स्रोत स्ट्रिंग्स के साथ JS/TS, अभी तक कोई t() नहीं | JS/TS ऐप में i18n जोड़ें |
React / Next.js / Node, t() पहले से ही स्रोत में है | i18next को वायर करें |
Python (t(), _(), gettext, Jinja, Django) | Python अनुप्रयोग। आरंभ करें: ui-python, ui-python-gettext, ui-python-flask, या ui-python-django। सहायक: i18n.py। किसी मौजूदा ऐप में लोकेल जोड़ने के लिए, Python ऐप में i18n जोड़ें देखें, या जब ऐप gettext का उपयोग करता है तो Django / Python gettext ऐप में i18n जोड़ें देखें। |
.NET (T(), Tn, Tp, XAML loc:Tr) | .NET एप्लिकेशन। आरंभ करें: ui-dotnet (I18n.cs) या ui-dotnet-resx (किसी .NET ResourceManager ऐप में i18n जोड़ें)। किसी मौजूदा ऐप में स्थानीय भाषाएँ जोड़ने के लिए, किसी .NET ऐप में i18n जोड़ें देखें। |
Plain HTML (मार्कअप में कोई t() नहीं) | Plain HTML ऐप्स |
| Astro मार्केटिंग साइट (हाइब्रिड) | Astro वेबसाइट |
t() नियम, इंटरपोलेशन, बहुवचन | t() कॉल और बहुवचन |
| भाषा पिकर / RTL | भाषा स्विचर और RTL |
| रनटाइम एपीआई हस्ताक्षर | रनटाइम हेल्पर |
Intlayer .content.ts डिक्शनरी, Intlayer से हट रहे हैं | Intlayer से माइग्रेट करना |
Intlayer .content.ts डिक्शनरी, Intlayer को रख रहे हैं | Intlayer का यथास्थान अनुवाद करना |
चरण 1: आरंभ करें
ai-i18n-tools init -P openrouterयह ui-markdown टेम्पलेट (उस प्रीसेट के लिए provider / providers ब्लॉक सहित) के साथ ai-i18n-tools.config.json लिखता है। वह टेम्पलेट README.md के लिए दस्तावेज़ अनुवाद भी चालू करता है, जिसे translated-docs/ के तहत फ्लैट फ़ाइलों के रूप में लिखा जाता है। केवल README वाले रिपॉजिटरी इसके बजाय init -t docs-markdown का उपयोग करते हैं। अपने README और Markdown डॉक्स में i18n जोड़ें देखें। translate-ui या sync चलाने से पहले, उस प्रदाता के लिए API कुंजी को पर्यावरण या .env में सेट करें — Ollama को छोड़कर; प्रदाता और API कुंजी देखें। UI स्ट्रिंग्स के लिए चार कुंजियाँ महत्वपूर्ण हैं:
sourceLocale: उस भाषा का BCP-47 कोड जिसमें आपका स्रोत पाठ लिखा गया है। कोई भी भाषा मान्य है;"en-GB"केवल एक उदाहरण है। इसे आपके रनटाइम i18n सेटअप फ़ाइल (src/i18n.ts/src/i18n.js) से निर्यात किए गएSOURCE_LOCALEसे मेल खाना चाहिए।t()के अंदर की स्ट्रिंग वह स्रोत भाषा है, और फ्लैट लोकल फ़ाइलें इसे कुंजी के रूप में उपयोग करती हैं।targetLocales: आपकी लक्ष्य भाषाओं के लिए BCP-47 कोड (उदाहरण के लिए["de", "fr", "pt-BR"])। इस सूची सेui-languages.jsonमैनिफेस्ट बनाने के लिएgenerate-ui-languagesचलाएँ।ui.sourceRoots:t("…")कॉल (उदाहरण के लिए["src/"]) को स्कैन करने के लिए निर्देशिकाएँ या ग्लोब पैटर्न।ui.stringsJsonऔरui.flatOutputDir: जहाँ मास्टर कैटलॉग और प्रति-स्थानिक फ़ाइलें (de.json,pt-BR.json) लिखी जाती हैं।
providers.<active>.uiModels सहित हर दूसरी कुंजी कॉन्फ़िगरेशन में है।
चरण 2: स्ट्रिंग निकालें
extract तब तक कुछ भी उपयोगी नहीं करता जब तक कि वे t() / i18n.t() कॉल मौजूद न हों। पहले हार्डकोडेड कॉपी को रैप करें: JS/TS ऐप में i18n जोड़ें।
ai-i18n-tools extractui.sourceRoots के तहत फ़ाइलों को t("literal") और i18n.t("literal") कॉल के लिए स्कैन करता है। ui.stringsJson में लिखता है (या मर्ज करता है)।
स्कैनर कॉन्फ़िगर करने योग्य है: ui.uiExtractor.funcNames (या लेगेसी ui.reactExtractor.funcNames) के माध्यम से कस्टम फ़ंक्शन नाम जोड़ें। Astro पेजों और कंपोनेंट के लिए, ui.uiExtractor.extensions में .astro जोड़ें। Plain HTML के लिए, Plain HTML ऐप्स देखें।
एक्सट्रैक्ट क्या स्कैन करता है
- डिफ़ॉल्ट एक्सटेंशन केवल
.js,.jsx,.tsऔर.tsxहैं।.mjs,.cjs,.mtsऔर.ctsतभी शामिल होते हैं जब आप उन्हेंui.uiExtractor.extensionsमें जोड़ते हैं। t(variable)या एक टेम्पलेट लिटरल जैसी गैर-लिटरल कुंजी को बिना किसी चेतावनी के छोड़ दिया जाता है।package.jsondescriptionडिफ़ॉल्ट रूप से शामिल है (ui.uiExtractor.includePackageDescription)।- Vue और Svelte सिंगल-फ़ाइल कंपोनेंट समर्थित नहीं हैं।
.vueया.svelteकोextensionsमें जोड़ने से टेम्पलेट टेक्स्ट एक्सट्रैक्ट नहीं होता है। कोई SFC पार्सर नहीं है।
चरण 3: UI स्ट्रिंग का अनुवाद करें
ai-i18n-tools translate-uistrings.json को पढ़ता है, प्रत्येक लक्ष्य लोकले के लिए सक्रिय LLM प्रदाता पर मॉडलों को बैच भेजता है, और फ़्लैट JSON फ़ाइलें (de.json, fr.json, आदि) ui.flatOutputDir में लिखता है। मॉडल चयन UI श्रृंखला का उपयोग करता है: localeModels(locale) → uiModels → translationModels (AI मॉडल्स देखें)। एक लोकले के भीतर, एक साथ uiBatchConcurrency तक बैच चलते हैं (डिफ़ॉल्ट 2; कॉन्फ़िगरेशन — uiBatchConcurrency देखें)। -j अभी भी केवल लक्ष्य लोकले को समानांतर करता है। प्रत्येक सफल बैच को strings.json और फ़्लैट लोकले फ़ाइल में अगले बैच के शुरू होने से पहले लिखा जाता है, इसलिए रन को रोकने या बाद में किसी API त्रुटि से पहले से समाप्त हो चुके बैच बने रहते हैं।
अनुवाद डेटाबेस (strings.json)
प्रत्येक प्रविष्टि के लिए, translate-ui एक वैकल्पिक models ऑब्जेक्ट (translated के समान लोकेल कुंजी) में प्रत्येक लोकेल का सफलतापूर्वक अनुवाद करने वाले सक्रिय प्रदाता से मॉडल आईडी को संग्रहीत करता है। अनुवाद डैशबोर्ड में संपादित स्ट्रिंग को उस लोकेल के लिए models में प्रहरी मान user-edited के साथ चिह्नित किया जाता है। ui.flatOutputDir के तहत प्रति-लोकेल फ्लैट फ़ाइलें केवल स्रोत स्ट्रिंग → अनुवाद रहती हैं; उनमें models शामिल नहीं है (इसलिए रनटाइम बंडल अपरिवर्तित रहते हैं)।
ध्यान दें: UI स्ट्रिंग में डैशबोर्ड संपादन
strings.jsonमें रहते हैं, न कि SQLite दस्तावेज़ कैश में। कैटलॉग से फ्लैट लोकेल फ़ाइलों को फिर से लिखने के लिए सादाsyncयाtranslate-ui(कोई विशेष फ़्लैग नहीं) चलाएँ —--force-updateUI चरण पर अग्रेषित नहीं किया जाता है। मैन्युअल संपादन के बाद UI कमांड पर--forceसे बचें: यह हर प्रविष्टि का फिर से अनुवाद करता है और आपकीuser-editedपंक्तियों को अधिलेखित कर सकता है। कैटलॉग पंक्तियाँ जिनकी संग्रहीत अनुवाद लोकेल लेखन-प्रणाली जाँच में विफल रहता है (उदाहरण के लिएhiके लिए रोमनकृत हिंदी) को गुम माना जाता है और--forceके बिना फिर से अनुवादित किया जाता है।
चरण 4: अपने ऐप में आउटपुट का उपयोग करें
translate-ui केवल फ़ाइलें लिखता है। ऐप को उन्हें लोड करना होगा।
- JS/TS: रनटाइम हेल्पर के साथ i18next सेट करें, उपयोगकर्ता द्वारा चुनी गई स्थानीय फ़ाइल लोड करें, और एक भाषा स्विचर जोड़ें। i18next वायर करें और भाषा स्विचर और RTL देखें।
- Python: जनरेटेड
i18n.pyया अपने gettext कैटलॉग का उपयोग करें। Python एप्लिकेशन देखें। - .NET: जनरेटेड
I18n.csका उपयोग करें, याI18nResx.csका उपयोग करें जब ऐप पहले से हीResourceManagerका उपयोग करता हो। .NET एप्लिकेशन और किसी .NET ResourceManager ऐप में i18n जोड़ें देखें।migrate-dotnet-i18nअसुरक्षितT()आर्ग्यूमेंट को फिर से लिखता है।--wrapबिना लेबल वाले लेबलों का ऑडिट करता है। - सादा HTML: पेज के बगल में रनटाइम स्क्रिप्ट लोड करें। सादे HTML ऐप देखें।
- Astro: Astro वेबसाइट देखें।
वैकल्पिक
प्रति-स्थानीय मॉडल ओवरराइड
कुछ मॉडल कुछ भाषाओं का दूसरों की तुलना में बेहतर अनुवाद करते हैं। उदाहरण के लिए, qwen और z-ai मॉडल एशियाई भाषाओं के साथ अच्छा प्रदर्शन करते हैं। प्रत्येक BCP-47 लोकेल के लिए एक प्राथमिकता वाली मॉडल सूची देने के लिए providers.<active>.localeModels प्रविष्टियाँ जोड़ें। उन सूचियों को उस लोकेल के लिए uiModels और translationModels से पहले आज़माया जाता है। लोकेल टैग केस-संवेदी नहीं होते हैं (zh-cn और ZH-CN समान हैं)। कोई मिलान प्रविष्टि न होने पर, उपकरण डिफ़ॉल्ट uiModels और translationModels क्रम का उपयोग करता है। वही localeModels तंत्र दस्तावेज़, JSON और SVG अनुवाद पर लागू होता है।
XLIFF 2.0 में निर्यात करना
UI स्ट्रिंग को किसी अनुवाद विक्रेता, TMS, या CAT टूल को सौंपने के लिए, कैटलॉग को XLIFF 2.0 (प्रति लक्ष्य लोकेल एक फ़ाइल) के रूप में निर्यात करें। यह कमांड केवल-पढ़ने के लिए है: यह strings.json को संशोधित नहीं करता है या किसी API को कॉल नहीं करता है।
ai-i18n-tools export-ui-xliffडिफ़ॉल्ट रूप से, फ़ाइलें ui.stringsJson के बगल में लिखी जाती हैं, जिनका नाम strings.de.xliff, strings.pt-BR.xliff (आपके कैटलॉग का बेसनेम + लोकेल + .xliff) जैसा होता है। कहीं और लिखने के लिए -o / --output-dir का उपयोग करें। strings.json से मौजूदा अनुवाद <target> में दिखाई देते हैं; गुम लोकेल state="initial" का उपयोग बिना <target> के करते हैं ताकि उपकरण उन्हें भर सकें। प्रत्येक लोकेल के लिए केवल उन इकाइयों को निर्यात करने के लिए --untranslated-only का उपयोग करें जिन्हें अभी भी अनुवाद की आवश्यकता है (विक्रेता बैचों के लिए उपयोगी)। --dry-run फ़ाइलें लिखे बिना पथ प्रिंट करता है।