Skip to content

ai-i18n-tools क्या है? ​

आपके पास एक भाषा में कोई ऐप, वेबसाइट, दस्तावेज़ीकरण साइट या रिपॉजिटरी README है और आप और भाषाएँ चाहते हैं। वह भाषा sourceLocale है और यह कोई भी भाषा हो सकती है। इन गाइड में अंग्रेज़ी एक आम उदाहरण है। ai-i18n-tools टेक्स्ट को ढूंढता है, आपके चुने हुए LLM प्रोवाइडर पर मॉडल के साथ इसका अनुवाद करता है और उन फ़ाइलों को लिखता है जिन्हें आपका प्रोजेक्ट पहले से लोड करता है। यह हर परिणाम को कैश करता है, इसलिए दोबारा चलाने पर यह मॉडल को केवल नया या बदला हुआ टेक्स्ट भेजता है।

आप क्या करते हैं और टूल क्या करता है ​

आपटूल
भाषाएँ, एक प्रोवाइडर और आज़माने के लिए मॉडल चुनेंटेक्स्ट निकालता है, उसका अनुवाद करता है, परिणाम को मान्य करता है और कैटलॉग या पेज लिखता है
उपयोगकर्ता-सामने वाले टेक्स्ट को टूल के लिए दृश्यमान बनाएं: ऐप कोड में t() कॉल, किसी साइट के लिए आपके फ्रेमवर्क का अपना i18n, या README में एक भाषा-सूची मार्करअनुवादों को कैश करता है और हर बार दोबारा चलाने पर उनका पुन: उपयोग करता है
परिणाम को ऐप, साइट की रूटिंग, या README की भाषा पंक्ति से कनेक्ट करेंप्रगति दिखाता है और आपको डैशबोर्ड में अनुवादों की समीक्षा करने देता है

उपकरण आपके स्रोत कोड को फिर से नहीं लिखता है जब तक आप migrate-python-i18n या migrate-dotnet-i18n को --write के साथ नहीं चलाते हैं। रैपिंग चरण के लिए कोडिंग-एजेंट प्रॉम्प्ट प्रदान किए जाते हैं। यह i18next या आपके साइट फ्रेमवर्क का i18n स्थापित नहीं करता है, और यह आपका भाषा स्विचर नहीं बनाता है, हालांकि उसके लिए रनटाइम हेल्पर प्रदान किए जाते हैं।

मैं कहाँ से शुरू करूँ? ​

वॉकथ्रू अपने प्रोजेक्ट में i18n जोड़ें में समूहित किए गए हैं, जिसमें साझा सेटअप और प्रत्येक प्रकार के प्रोजेक्ट के लिए एक पेज है। एक पंक्ति चुनें:

आपके पास हैयहाँ से शुरू करें
स्रोत में सादे टेक्स्ट वाला एक JS/TS ऐप (React, Next.js, Node, CLI)एक JS/TS ऐप में i18n जोड़ें
एक पायथन ऐप (स्ट्रीमलेट, फास्टएपीआई, फ्लास्क, डेस्कटॉप, स्क्रिप्ट)पायथन ऐप में i18n जोड़ें
एक .NET ऐप (Avalonia, WPF, MAUI, ASP.NET, Blazor, कंसोल).NET ऐप में i18n जोड़ें
एक .NET ऐप जो पहले से ही ResourceManager या IStringLocalizer का उपयोग करता है.NET ResourceManager ऐप में i18n जोड़ें
एक जैंगो ऐप, फ्लास्क-बैबेल कैटलॉग, या एक ऐसा ऐप जो पहले से जीएनयू गेटटेक्स्ट का उपयोग करता हैजैंगो / पायथन गेटटेक्स्ट ऐप में i18n जोड़ें
एक वेबसाइट या दस्तावेज़ साइट (VitePress, Docusaurus, Starlight, Nextra, Fumadocs, Astro, सादा HTML)एक वेबसाइट या दस्तावेज़ साइट में i18n जोड़ें
एक रिपॉजिटरी README और अन्य Markdown फ़ाइलें, आमतौर पर एक ऐप के बगल मेंअपने README और Markdown दस्तावेज़ों में i18n जोड़ें
स्टैंडअलोन नेस्टेड JSON लोकल फ़ाइलेंJSON
टेक्स्ट लेबल वाले SVG डायग्रामSVG अनुवाद
इंटलेयर डिक्शनरी (इंटलेयर से हटें)इंटलेयर से माइग्रेट करना
इंटलेयर डिक्शनरी (इंटलेयर रखें, वहीं अनुवाद करें)इंटलेयर का वहीं अनुवाद करना

यह कैसे काम करता है ​

  1. CLI इंस्टॉल करें और अपने प्रोवाइडर की API कुंजी सेट करें: इंस्टॉलेशन।
  2. ai-i18n-tools.config.json लिखने के लिए init चलाएँ: त्वरित शुरुआत।
  3. प्रोजेक्ट तैयार करें: स्ट्रिंग को t() में रैप करें, अपनी साइट फ्रेमवर्क का i18n सक्षम करें, या README में भाषा-सूची मार्कर जोड़ें।
  4. sync चलाएँ। यह टेक्स्ट निकालता है, नए टेक्स्ट का अनुवाद करता है, और आउटपुट लिखता है।
  5. आउटपुट को अपने ऐप या साइट में लोड करें, एक भाषा स्विचर जोड़ें, और जब स्रोत बदलता है तो sync को फिर से चलाएँ।

अनुवाद मोड ​

अंदरूनी तौर पर, टूल चार पाइपलाइन चलाता है। आपकी कॉन्फ़िग आपको आवश्यक पाइपलाइन को सक्षम करती है, और sync उन्हें क्रम में चलाता है।

  • UI स्ट्रिंग्स — JS/TS और Python से t("…") और _() कॉल, और C# और XAML से T("…") / {loc:Tr '…'} (GNU gettext और .NET .resx सैटेलाइट सहित) निकालें और प्रति-स्थानिक JSON, .po / .mo, या .resx लिखें। कमांड: extract, translate-ui, migrate-dotnet-i18n। गाइड: UI स्ट्रिंग्स। Python: Python एप्लिकेशन। .NET: .NET एप्लिकेशन और .NET ResourceManager ऐप में i18n जोड़ें।
  • दस्तावेज़ — docs[].contentPaths में सूचीबद्ध Markdown, MDX, और .astro पृष्ठों का अनुवाद करें। VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro, और अन्य स्थिर दस्तावेज़ साइटों के साथ, और एक रिपॉजिटरी README (docsOutput.style का flat) के साथ काम करता है। कमांड: translate-docs। गाइड: दस्तावेज़ और अपने README और Markdown दस्तावेज़ों में i18n जोड़ें।
  • JSON — शीर्ष-स्तरीय json[] में परिभाषित नेस्टेड JSON स्थानीय बंडलों (थीम लेबल, i18n ओवरराइड, स्रोत में नहीं ऐप कॉपी) का अनुवाद करें। कमांड: translate-json। गाइड: JSON।
  • SVG — SVG चित्रों (<text>, <title>, <desc>) के अंदर दृश्यमान टेक्स्ट का अनुवाद करें और प्रति-स्थानिक एक आउटपुट फ़ाइल लिखें। दस्तावेज़ अनुवाद से अलग। कमांड: translate-svg। गाइड: SVG अनुवाद।

कई प्रोजेक्ट मोड को जोड़ते हैं। सामान्य जोड़ी UI स्ट्रिंग और रिपॉजिटरी README है। VitePress जैसी डॉक्स साइट दूसरी अक्सर उपयोग की जाने वाली जोड़ी है। पाइपलाइन को संयोजित करना और अपनी README और मार्कडाउन डॉक्स में i18n जोड़ें देखें।

उदाहरण ​

रिपॉजिटरी examples/ के तहत चलाने योग्य उदाहरण प्रोजेक्ट भेजता है, प्रत्येक अपनी कॉन्फ़िग, कमिटेड लोकले आउटपुट और README के साथ। API कुंजी के बिना अनुवादित फ़ाइलों का अन्वेषण करें; अनुवाद को फिर से चलाने के लिए एक प्रदाता कुंजी की आवश्यकता होती है।

यदि आपके पास हैउदाहरण
एक JS/TS ऐपconsole-app, nextjs-app
एक ऐप के बगल में एक रिपॉजिटरी READMEconsole-app, nextjs-app
एक Python ऐपpython-streamlit, python-fastapi, python-gettext
एक .NET हेल्परdotnet-console, dotnet-resx
एक डॉक्स साइटdocusaurus-docs, vitepress-docs, astro-docs
एक वेबसाइट या सादा HTMLastro-website, plain-html

पूरी सूची और npx degit कॉपी कमांड के लिए उदाहरण देखें।

अगले चरण ​

  1. इंस्टॉलेशन — npm पैकेज इंस्टॉल करें, या Python प्रोजेक्ट के लिए स्टैंडअलोन एक्ज़ीक्यूटेबल डाउनलोड करें, और अपनी प्रोवाइडर API की सेट करें।
  2. क्विक स्टार्ट — एक कॉन्फ़िग स्कैफ़ोल्ड करें और अपना पहला ट्रांसलेशन चलाएँ।
  3. LLM प्रोवाइडर — एक प्रोवाइडर, API की, और -P ओवरराइड चुनें।
  4. AI मॉडल — suggest-models या डैशबोर्ड मॉडल टैब के साथ एक शॉर्टलिस्ट को रैंक करें, और कई मॉडल रखें ताकि एक असफल ट्रांसलेशन अगले वाले को आज़मा सके।

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