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

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

अनुवाद मोड

• UI स्ट्रिंग्स — JS/TS स्रोत से t("…") कॉल (और इसी तरह के मार्कर) निकालें और i18next या स्थिर लुकअप के लिए प्रति-स्थानिक JSON फ़ाइलें लिखें। कमांड: extract, translate-ui। मार्गदर्शिका: UI स्ट्रिंग्स।
• दस्तावेज़ — docs[].contentPaths में सूचीबद्ध Markdown, MDX और .astro पृष्ठों का अनुवाद करें। VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro और अन्य स्थिर दस्तावेज़ साइटों के साथ काम करता है। कमांड: translate-docs। मार्गदर्शिका: दस्तावेज़।
• JSON — शीर्ष-स्तरीय json[] में परिभाषित नेस्टेड JSON स्थानीय बंडलों (थीम लेबल, i18n ओवरराइड, स्रोत में नहीं ऐप कॉपी) का अनुवाद करें। कमांड: translate-json। मार्गदर्शिका: JSON।
• SVG — SVG चित्रों (<text>, <title>, <desc>) के अंदर दृश्यमान टेक्स्ट का अनुवाद करें और प्रति स्थानीय एक आउटपुट फ़ाइल लिखें। दस्तावेज़ अनुवाद से अलग — translate-docs SVG संपत्तियों को संशोधित नहीं करता है। कमांड: translate-svg। मार्गदर्शिका: SVG अनुवाद।

सभी चार मोड सक्रिय LLM प्रदाता का उपयोग करते हैं, एक ही कॉन्फ़िग फ़ाइल साझा करते हैं, और एक SQLite कैश का पुन: उपयोग करते हैं ताकि पुनरावृत्ति केवल नए या बदले हुए टेक्स्ट को मॉडल पर भेजें।

मुझे किसका उपयोग करना चाहिए?

आपकी सामग्री	मोड	कमांड
स्रोत कोड t() या HTML data-i18n मार्कर का उपयोग करता है	UI स्ट्रिंग्स	extract / translate-ui
स्थानीयकृत पृष्ठ या दस्तावेज़ साइटें	दस्तावेज़	translate-docs
स्टैंडअलोन नेस्टेड JSON स्थानीय फ़ाइलें	JSON	translate-json
SVG में लेबल वाले आरेख या चित्र	SVG	translate-svg

कई प्रोजेक्ट मोड को जोड़ते हैं — उदाहरण के लिए VitePress साइट के लिए UI स्ट्रिंग्स और दस्तावेज़, या सचित्र गाइड के लिए दस्तावेज़ और SVG। स्केफोल्ड टेम्प्लेट के लिए त्वरित प्रारंभ और पूर्ण कॉन्फ़िग स्कीमा के लिए कॉन्फ़िगरेशन देखें।

उदाहरण

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

उदाहरण	यह क्या दिखाता है
कंसोल-ऐप	सबसे छोटा एंड-टू-एंड ऐप: t() UI स्ट्रिंग्स प्लस README अनुवाद
नेक्स्टजेएस-ऐप	नेक्स्ट.जेएस UI, बहुवचन, SVG, नेस्टेड डोक्यूसौरस डॉक्स, फ्लैट README, डैशबोर्ड
डोक्यूसौरस-डॉक्स	स्टैंडअलोन डोक्यूसौरस दस्तावेज़ साइट
एस्ट्रो-वेबसाइट	एस्ट्रो मार्केटिंग साइट: पूर्ण-पृष्ठ HTML अनुवाद प्लस t() स्ट्रिंग्स
एस्ट्रो-डॉक्स	एस्ट्रो स्टारलाइट दस्तावेज़ साइट
वाइटप्रेस-डॉक्स	वाइटप्रेस डॉक्स प्लस थीम कैटलॉग
नेक्स्ट्रा-डॉक्स	नेक्स्ट्रा डॉक्स प्लस _meta.ts साइडबार लेबल और थीम डिक्शनरी
फ्यूमाडॉक्स-डॉक्स	फ्यूमाडॉक्स डॉक्स प्लस meta.json साइडबार लेबल और यूआई कैटलॉग
plain-html	data-i18n* मार्कर और लोकेल JSON के साथ स्थैतिक HTML
मल्टी-प्रोवाइडर	एक ही दस्तावेज़ पर एलएलएम प्रोवाइडर की तुलना करें
टेस्ट-मार्कडाउन	मार्कडाउन पाइपलाइन स्ट्रेस टेस्ट (सीजेके, देवनागरी, एज केस)
intlayer-migration	Intlayer .content.ts → t() migrate-intlayer के माध्यम से

npx degit कॉपी कमांड और चुनने के लिए गाइड के लिए उदाहरण देखें।

अगले चरण

1. इंस्टॉलेशन — पैकेज इंस्टॉल करें और अपनी प्रोवाइडर एपीआई कुंजी सेट करें।
2. त्वरित शुरुआत — एक कॉन्फ़िग स्केफ़ोल्ड करें और अपना पहला अनुवाद चलाएँ।
3. प्रोवाइडर और मॉडल — एक प्रोवाइडर, मॉडल फ़ॉलबैक चेन और -P ओवरराइड चुनें।