Intlayer से स्रोत-स्ट्रिंग कॉल पर माइग्रेट करना
Intlayer उन एप्लिकेशन के लिए आदर्श है जो टाइप्ड कंटेंट डिक्शनरी या अनुवाद प्रबंधन सिस्टम के माध्यम से अनुवादों का प्रबंधन करते हैं। ai-i18n-tools एक अलग वर्कफ़्लो को लक्षित करता है: ऐसा कोड जो स्रोत-स्ट्रिंग कॉल का उपयोग करता है जैसे t('English source')। t() के अंदर की स्ट्रिंग sourceLocale में लिखी गई है, जो कोई भी भाषा हो सकती है। इन उदाहरणों में अंग्रेजी केवल एक नमूना है। उस स्रोत स्ट्रिंग को सीधे कोड में रखकर, यह तरीका रखरखाव को सरल बनाता है और जटिलता को कम करता है। जब यह मॉडल आपकी आवश्यकताओं के अनुरूप होता है, तो migrate-intlayer आपकी मौजूदा डिक्शनरी को आयात करता है और संगत कॉल साइटों को स्वचालित रूप से फिर से लिखता है। यह शेष साइटों को अपरिवर्तित छोड़ देता है और विशिष्ट प्रतिस्थापन निर्देशों के साथ एक रिपोर्ट तैयार करता है, जिससे आप माइग्रेशन को चरणों में पूरा कर सकते हैं या रिपोर्ट को किसी AI कोडिंग एजेंट को दे सकते हैं ताकि वह आपके लिए माइग्रेशन पूरा कर सके।
क्या आप पहले से ही i18next JSON ट्रांसलेशन फ़ाइलों का उपयोग कर रहे हैं? आपको इस माइग्रेशन कमांड की आवश्यकता नहीं है; इसके बजाय JSON pipeline का उपयोग करें।
जगह पर अनुवाद करें, या माइग्रेट करें?
यह पृष्ठ आपके ऐप को Intlayer से हटाकर ai-i18n-tools के स्रोत-स्ट्रिंग t() कॉल पर ले जाता है, जैसे t('English source')। स्ट्रिंग sourceLocale में लिखी गई है, जो कोई भी भाषा हो सकती है। यदि आप रनटाइम पर Intlayer को बनाए रखना चाहते हैं और केवल गुम अनुवादों को भरना चाहते हैं, तो इसके बजाय translate-intlayer का उपयोग करें — यह *.content.ts को वहीं अनुवादित करता है।
migrate-intlayer क्या करता है
*.content.tsडिफ़ॉल्ट एक्सपोर्ट्स को पार्स करता है (key+content+t({ locale: '…' })लीव्स)।- स्रोत-लोकेल टेक्स्ट और डिक्शनरी में पहले से मौजूद किसी भी अनुवाद से
ui.flatOutputDirके अंतर्गतui.stringsJsonऔर प्रति-लोकेल फ़ाइलों को सीड करता है। इम्पोर्ट की गई पंक्तियों में कोईmodelsफ़ील्ड नहीं होता (वे इस रन द्वारा मशीन-अनुवादित नहीं की गई थीं)। - सुरक्षित कॉल साइट्स को पुनः लिखता है:
binding.path.to.leaf.value→t('English source')binding.path.value.replace('{token}', expr)→t('English {{token}}', { token: expr })
- बाकी सब कुछ (डायनामिक कीज़, JSX स्प्रेड्स, चेन्ड
.replace().replace(), डिस्ट्रक्चरिंग) को बिना छेड़े छोड़ देता है। रिपोर्ट में सटीक एक्सप्रेशन, एक ठोसt()या JSX रिप्लेसमेंट, और जोड़ने के लिएimport { t } from '…';लाइन के साथ उनमें से प्रत्येक साइट की सूची दी गई है। - डिफ़ॉल्ट रूप से ड्राई रन। कैटलोग सीडिंग और सुरक्षित रिराइट्स लागू करने के लिए
--writeपास करें। रिपोर्ट हमेशा लिखी जाती है। यह डिक्शनरी फ़ाइलों और मैनुअल रिराइट्स के बाद डिलीट करने के लिए बचे हुएuseIntlayer/IntlayerProviderउपयोग, कैटलोग कीज़ जिन्हें अभी भीextractऔर फिरtranslate-uiकी आवश्यकता है, और ऐप के i18n मॉड्यूल पर पेस्ट करने के लिए रनटाइम बूटस्ट्रैप की सूची भी देता है।
अपना प्रोजेक्ट माइग्रेट करें
ai-i18n-toolsइंस्टॉल करें (इंस्टॉलेशन देखें)। यदि आपके प्रोजेक्ट में अभी तक कोईai-i18n-tools.config.jsonनहीं है, तो एक स्केफोल्ड करें:bashai-i18n-tools init -P gemini
sourceLocale और targetLocales को संपादित करें ताकि वे आपके Intlayer शब्दकोशों में पहले से मौजूद लोकेल्स से मेल खाएं, और ui.sourceRoots, ui.stringsJson, ui.flatOutputDir को अपने ऐप के स्रोत और वांछित कैटलॉग पथ की ओर इंगित करने के लिए सेट करें — वही कुंजियाँ जिनका उपयोग translate-ui करता है, देखें UI स्ट्रिंग्स — चरण 1: प्रारंभ करें। 2. पहले ड्राई रन करें: ai-i18n-tools migrate-intlayer (कोई --write नहीं)। यह देखने के लिए migrate-intlayer-report.md पढ़ें कि यह क्या खोजता है और किसी भी फ़ाइल परिवर्तन से पहले किन कॉल साइट्स को मैन्युअल समीक्षा की आवश्यकता है। 3. ui.stringsJson / ui.flatOutputDir को सीड करने और सुरक्षित कॉल साइट्स को फिर से लिखने के लिए ai-i18n-tools migrate-intlayer --write चलाएँ। 4. पुनर्जनित रिपोर्ट migrate-intlayer-report.md को एक AI कोडिंग एजेंट को दें (अनुशंसित), या निम्नलिखित चरणों का पालन करके इसे स्वयं पूरा करें:
- रिपोर्ट एक चरण-दर-चरण TODO के साथ समाप्त होती है: प्रत्येक मैन्युअल-समीक्षा साइट को वहां दिखाए गए विशिष्ट
t('…')/JSX के साथ पूरा करें,import { t } from '…';लाइन जोड़ें, फिर बची हुई*.content.tsफ़ाइलों और रिपोर्ट में सूचीबद्धuseIntlayer/IntlayerProviderउपयोग को हटा दें।- रिपोर्ट के रनटाइम बूटस्ट्रैप को अपने ऐप के i18n मॉड्यूल पर पेस्ट करें। लोकेल नियंत्रण में,
loadLocale(next)और फिरi18n.changeLanguage(next)को कॉल करें —loadLocaleकेवल फ्लैट बंडल को पंजीकृत करता है और सक्रिय भाषा को स्विच नहीं करता है। - रिपोर्ट द्वारा नई के रूप में चिह्नित किसी भी स्रोत स्ट्रिंग के लिए
ai-i18n-tools extractऔर फिरai-i18n-tools translate-ui(याsync) चलाएँ।extractui-languages.jsonभी लिखता है, जिसे बूटस्ट्रैप आयात करता है, इसलिए ऐप शुरू करने से पहले इसे चलाएँ, भले ही कोई नई स्ट्रिंग न जोड़ी गई हो।strings.json, फ्लैट लोकेल फ़ाइलों, याui-languages.jsonको मैन्युअल रूप से संपादित न करें — ये कमांड्स उन्हें प्रबंधित करते हैं। - एक बार जब रिपोर्ट की क्लीनअप सूची पूरी हो जाती है और ऐप ai-i18n-tools पर चलने लगता है, तो
intlayer/react-intlayerनिर्भरताओं और शब्दकोश फ़ाइलों को हटा दें।
- रिपोर्ट के रनटाइम बूटस्ट्रैप को अपने ऐप के i18n मॉड्यूल पर पेस्ट करें। लोकेल नियंत्रण में,
उदाहरण चलाएँ
उपरोक्त चरण किसी भी Intlayer प्रोजेक्ट पर लागू होते हैं। intlayer-migration उदाहरण एक छोटे Vite + React ऐप पर बुनियादी (ऑटो-रिराइट करने योग्य) और जटिल (मैन्युअल-समीक्षा) मामलों के साथ इन्हें समझाता है, ताकि आप अपने स्वयं के कोड पर इसे आज़माने से पहले रिपोर्ट और रनटाइम बूटस्ट्रैप देख सकें। intlayer-pristine/ को कभी भी संशोधित नहीं किया जाता है; src/ वर्किंग कॉपी है।
npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migration
cd intlayer-migration
pnpm install
pnpm reset
pnpm migrate:dry
pnpm migrate:writemigrate-intlayer-report.md को किसी AI कोडिंग एजेंट को सौंपें (या फ़्लैग की गई फ़ाइलों को स्वयं एडिट करें)। रिपोर्ट में src/i18n.ts पर पेस्ट करने के लिए रनटाइम मॉड्यूल शामिल है। लोकेल कंट्रोल में, loadLocale(next) और फिर i18n.changeLanguage(next) को कॉल करें। loadLocale केवल फ़्लैट बंडल को रजिस्टर करता है।
pnpm i18n:sync
pnpm devpnpm i18n:sync पहले extract चलाता है, जो ui-languages.json लिखता है। बूटस्ट्रैप उस फ़ाइल को आयात करता है, इसलिए एक्सट्रैक्ट करने के बाद ही ऐप शुरू करें। strings.json, फ्लैट लोकेल फ़ाइलों, या ui-languages.json को मैन्युअल रूप से संपादित न करें।
pnpm reset intlayer-pristine/ को src/ पर वापस कॉपी करता है और जेनरेट किए गए कैटलॉग को साफ़ करता है ताकि आप फिर से शुरू कर सकें।
पूर्ण वॉकथ्रू: examples/intlayer-migration/README.md।
कमांड
ai-i18n-tools migrate-intlayer [paths...] [--write] [--report <path>] [--content-glob <glob>] [--t-import <specifier>]कॉन्फ़िग में ui.stringsJson और ui.flatOutputDir की आवश्यकता है (translate-ui के समान)। LLM को कॉल नहीं करता है।
| विकल्प | अर्थ |
|---|---|
[paths...] | स्कैन करने के लिए फ़ाइलें/डिर/ग्लोब (डिफ़ॉल्ट: ui.sourceRoots) |
--write | कैटलॉग को सीड करें और सुरक्षित कॉल साइट्स को फिर से लिखें (डिफ़ॉल्ट: ड्राई रन) |
--report <path> | रिपोर्ट पाथ (डिफ़ॉल्ट: migrate-intlayer-report.md) |
--content-glob <glob> | शब्दकोश फ़ाइलनाम ग्लोब (डिफ़ॉल्ट: **/*.content.ts) |
--t-import <specifier> | जेनरेट किए गए t() के लिए इंपोर्ट स्पेसिफ़ायर (डिफ़ॉल्ट: यदि src/i18n.ts मौजूद है तो सापेक्ष ./i18n, अन्यथा i18next) |
--write के बाद, रिपोर्ट से मैन्युअल-समीक्षा साइटों का कार्य पूरा करें, इसके द्वारा सूचीबद्ध अप्रयुक्त *.content.ts फ़ाइलों और IntlayerProvider रैपर को हटाएं, रनटाइम बूटस्ट्रैप पेस्ट करें, और लोकेल नियंत्रण से i18n.changeLanguage को कॉल करें। रिपोर्ट द्वारा नए के रूप में चिह्नित स्रोत स्ट्रिंग्स के लिए extract और फिर translate-ui (या sync) चलाएं। extract ui-languages.json भी लिखता है, जिसे बूटस्ट्रैप आयात करता है। strings.json, फ्लैट लोकेल फ़ाइलों, या ui-languages.json को मैन्युअल रूप से संपादित न करें।
यह भी देखें: CLI — UI स्ट्रिंग्स, वायर i18next