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 अनुवाद |
| इंटलेयर डिक्शनरी (इंटलेयर से हटें) | इंटलेयर से माइग्रेट करना |
| इंटलेयर डिक्शनरी (इंटलेयर रखें, वहीं अनुवाद करें) | इंटलेयर का वहीं अनुवाद करना |
यह कैसे काम करता है
- CLI इंस्टॉल करें और अपने प्रोवाइडर की API कुंजी सेट करें: इंस्टॉलेशन।
ai-i18n-tools.config.jsonलिखने के लिएinitचलाएँ: त्वरित शुरुआत।- प्रोजेक्ट तैयार करें: स्ट्रिंग को
t()में रैप करें, अपनी साइट फ्रेमवर्क का i18n सक्षम करें, या README में भाषा-सूची मार्कर जोड़ें। syncचलाएँ। यह टेक्स्ट निकालता है, नए टेक्स्ट का अनुवाद करता है, और आउटपुट लिखता है।- आउटपुट को अपने ऐप या साइट में लोड करें, एक भाषा स्विचर जोड़ें, और जब स्रोत बदलता है तो
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 |
| एक ऐप के बगल में एक रिपॉजिटरी README | console-app, nextjs-app |
| एक Python ऐप | python-streamlit, python-fastapi, python-gettext |
| एक .NET हेल्पर | dotnet-console, dotnet-resx |
| एक डॉक्स साइट | docusaurus-docs, vitepress-docs, astro-docs |
| एक वेबसाइट या सादा HTML | astro-website, plain-html |
पूरी सूची और npx degit कॉपी कमांड के लिए उदाहरण देखें।
अगले चरण
- इंस्टॉलेशन — npm पैकेज इंस्टॉल करें, या Python प्रोजेक्ट के लिए स्टैंडअलोन एक्ज़ीक्यूटेबल डाउनलोड करें, और अपनी प्रोवाइडर API की सेट करें।
- क्विक स्टार्ट — एक कॉन्फ़िग स्कैफ़ोल्ड करें और अपना पहला ट्रांसलेशन चलाएँ।
- LLM प्रोवाइडर — एक प्रोवाइडर, API की, और
-Pओवरराइड चुनें। - AI मॉडल —
suggest-modelsया डैशबोर्ड मॉडल टैब के साथ एक शॉर्टलिस्ट को रैंक करें, और कई मॉडल रखें ताकि एक असफल ट्रांसलेशन अगले वाले को आज़मा सके।