त्वरित शुरुआत
यह पृष्ठ एक एकल-भाषा परियोजना को उसकी पहली अनुवादित फ़ाइलों तक मार्गदर्शन करता है। यह एक JS/TS ऐप, एक Python ऐप, एक .NET ऐप, एक वेबसाइट या दस्तावेज़ीकरण साइट, या एक रिपॉजिटरी README और अन्य Markdown फ़ाइलों के लिए है। यह मानता है:
- Node.js
>=22.16.0, या Python या .NET प्रोजेक्ट के लिए स्टैंडअलोन निष्पादन योग्य। - किसी LLM प्रदाता के लिए एक API कुंजी, या एक स्थानीय Ollama इंस्टाल।
- प्रोजेक्ट वर्ज़न कंट्रोल में है, ताकि आप टूल द्वारा लिखी गई चीज़ों की समीक्षा कर सकें।
परियोजनाओं के बीच दो चीजें भिन्न होती हैं: उपकरण आपके टेक्स्ट को कैसे ढूंढता है, और आपका ऐप परिणाम को कैसे लोड करता है। नीचे अपना मार्ग चुनें आपको उसके लिए सही मार्गदर्शिका पर भेजता है।
चलाने योग्य उदाहरण
पहले एक पूर्ण परियोजना देखना पसंद करेंगे? रिपॉजिटरी को क्लोन किए बिना एक कॉपी करें:
npx degit wsj-br/ai-i18n-tools/examples/console-app console-app
cd console-app
pnpm install
pnpm run i18n:syncconsole-app को किसी अन्य Node.js उदाहरण से बदलें। Python और .NET उदाहरणों में कोई package.json नहीं है; उन्हें वैसे ही कॉपी करें। GitHub रिलीज़ पर चार Python उदाहरण ai-i18n-tools-python-examples.zip में भी हैं, और दो .NET उदाहरण ai-i18n-tools-dotnet-examples.zip में हैं। प्रत्येक उदाहरण क्या दिखाता है, उसकी पूरी सूची उदाहरण पेज पर है।
इंस्टॉल करें
pnpm add -D ai-i18n-toolsnpm install --save-dev ai-i18n-tools और yarn add --dev ai-i18n-tools भी काम करते हैं। Python और .NET प्रोजेक्ट स्टैंडअलोन निष्पादन योग्य को इंस्टॉल करते हैं और उन्हें Node.js की आवश्यकता नहीं होती है। Linux और macOS: curl -fsSL https://raw.githubusercontent.com/wsj-br/ai-i18n-tools/main/install.sh | bash। Windows PowerShell: irm https://raw.githubusercontent.com/wsj-br/ai-i18n-tools/main/install.ps1 | iex। अन्य इंस्टाल विकल्प: इंस्टॉलेशन।
प्रदाता और API कुंजी
प्रत्येक कमांड जो एक LLM (translate-ui, translate-docs, translate-json, translate-svg, और sync) को कॉल करती है, उसे इन दोनों की आवश्यकता होती है:
ai-i18n-tools.config.jsonमें कम से कम एक प्रोवाइडर:translationModelsके साथ एकproviders.<name>ब्लॉक, और जब एक से ज़्यादा प्रोवाइडर कॉन्फ़िगर किए गए हों, तो एक टॉप-लेवलproviderकी.init -P <provider>उस प्रीसेट को स्कैफ़ोल्ड करता है. प्रोवाइडर जोड़ने के लिए, LLM प्रोवाइडर देखें. मॉडल की सूची चुनने के लिए, AI मॉडल देखें.- आपके एनवायरमेंट में मैचिंग API की, या जब कोई प्रोवाइडर API की पहले से सेट नहीं है, तो
ai-i18n-tools.config.jsonके बगल में.env/.env.localमें. हर बिल्ट-इन प्रीसेट प्रीसेट टेबल से एक नामित वैरिएबल पढ़ता है, उदाहरण के लिए,-P openrouterके साथOPENROUTER_API_KEYया-P openaiके साथOPENAI_API_KEY. Ollama एक लोकल एंडपॉइंट का इस्तेमाल करता है और उसे किसी की की ज़रूरत नहीं होती.
export OPENROUTER_API_KEY=sk-or-v1-your-key-hereextract, status, और अन्य कमांड जो LLM को कॉल नहीं करते हैं, उन्हें इनमें से किसी की भी आवश्यकता नहीं होती है। पर्यावरण फ़ाइलों और PATH के बारे में अधिक जानकारी: इंस्टॉलेशन।
अपना मार्ग चुनें
आपके पास जो है उसे ढूंढें, उसके ब्लॉक में कमांड चलाएं, फिर लिंक की गई मार्गदर्शिका में जारी रखें।
एक JS/TS ऐप
आपके बटन और संदेश स्रोत में अभी भी सादे टेक्स्ट में हैं, इसलिए उपकरण को अभी तक कुछ भी नहीं मिला है। उन्हें पहले t() में लपेटा जाना चाहिए, और ऐप को एक छोटी i18next सेटअप फ़ाइल की आवश्यकता है।
ai-i18n-tools init -P openrouter
ai-i18n-tools suggest-models --applyफिर एक JS/TS ऐप में i18n जोड़ें का पालन करें। यह extract और translate-ui से पहले, एक एजेंट प्रॉम्प्ट के साथ, रैपिंग चरण को कवर करता है।
एक Python ऐप
ai-i18n-tools init -t ui-python -P openrouter
ai-i18n-tools suggest-models --applyफिर एक Python ऐप में i18n जोड़ें का पालन करें।
एक Django ऐप, Flask-Babel कैटलॉग के साथ Flask, या एक ऐप जो पहले से ही gettext को कॉल करता है, उन कॉलों को बनाए रखता है। इसके बजाय ui-python-django, ui-python-flask, या ui-python-gettext के साथ स्कैफोल्ड करें, फिर एक Django / Python gettext ऐप में i18n जोड़ें का पालन करें।
.NET ऐप
ai-i18n-tools init -t ui-dotnet -P openrouter
ai-i18n-tools suggest-models --applyफिर Add i18n to a .NET app का पालन करें। एक ऐप जो पहले से ही ResourceManager या IStringLocalizer का उपयोग करता है, वह इसके बजाय ui-dotnet-resx का उपयोग करता है, फिर Add i18n to a .NET ResourceManager app। migrate-dotnet-i18n T($"…") को क्रमांकित {0} कॉल्स में फिर से लिखता है। --wrap अचिह्नित XAML और C# लेबलों का ऑडिट करता है। रिपोर्ट नामित resx कुंजियों, जैसे Resources.LoginButton, को सुझावों के रूप में सूचीबद्ध करती है और उन पंक्तियों को संपादित नहीं करती है।
एक वेबसाइट या दस्तावेज़ साइट
अपने फ्रेमवर्क के लिए टेम्पलेट चुनें:
| आपकी साइट | टेम्पलेट |
|---|---|
| एस्ट्रो स्टारलाइट | ui-starlight |
| डॉकुसॉरस | ui-docusaurus |
| वाइटप्रेस | ui-vitepress |
| नेक्स्ट्रा | ui-nextra |
| फ्यूमाडॉक्स | ui-fumadocs |
| साधारण एस्ट्रो वेबसाइट | ui-astro-website |
| साधारण HTML पेज | ui-plain-html या docs-plain-html |
ai-i18n-tools init -t ui-vitepress -P openrouterफिर एक वेबसाइट या डॉक्स साइट में i18n जोड़ें का पालन करें। इसका एजेंट प्रॉम्प्ट फ्रेमवर्क की i18n रूटिंग को सक्षम करता है। उस काम की समीक्षा करने के बाद आप sync चलाते हैं।
एक README या मार्कडाउन डॉक्स
अधिकांश रिपॉजिटरी इसे ऐप के साथ चाहते हैं: डिफ़ॉल्ट ui-markdown टेम्पलेट में पहले से ही एक फ़्लैट README ब्लॉक शामिल है। किसी अन्य टेम्पलेट के लिए, --with-readme जोड़ें। केवल मार्कडाउन वाली रिपॉजिटरी docs-markdown का उपयोग करती है।
ai-i18n-tools init -P openrouter
ai-i18n-tools init -t ui-python -P openrouter --with-readme
ai-i18n-tools init -t ui-dotnet -P openrouter --with-readme
ai-i18n-tools init -t docs-markdown -P openrouterफिर Add i18n to your README and Markdown docs का पालन करें। भाषा-सूची मार्कर को sync से पहले README.md में पेस्ट करें। ऐप पाथ, जब आपके पास एक हो, तो वह अभी भी Add i18n to a JS/TS app, Add i18n to a Python app, या Add i18n to a .NET app है।
कुछ और
- नेस्टेड i18next JSON जो जैसा है वैसा ही रहता है:
ai-i18n-tools init -t ui-json-bundles -P openrouter, फिर JSON। - टेक्स्ट लेबल वाले SVG डायग्राम: SVG अनुवाद।
- इंटलेयर से हटना: इंटलेयर से माइग्रेट करना।
- इंटलेयर को बनाए रखना और केवल उसके अनुवादों को भरना: इंटलेयर का यथास्थान अनुवाद करना।
प्रत्येक init विकल्प के साथ पूरी टेम्पलेट सूची CLI सेटअप संदर्भ में है।
चलाएँ और जाँचें
जब आपका प्रोजेक्ट तैयार हो:
ai-i18n-tools doctor
ai-i18n-tools sync
ai-i18n-tools statusdoctor जाँचता है कि कॉन्फ़िग, पाथ, प्रोवाइडर और एनवायरनमेंट तैयार हैं। यह प्रोवाइडर के साथ मॉडल आईडी को भी सत्यापित करता है, जब तक कि आप --local पास नहीं करते। sync आपकी कॉन्फ़िग द्वारा सक्षम किए गए हर चरण को क्रम में चलाता है। status दिखाता है कि प्रति लोकले क्या अनुवादित है। किसी ऐसे प्रोजेक्ट पर पहली बार चलाने पर जिसमें टूल टेक्स्ट नहीं देख सकता, वह बिना किसी त्रुटि के समाप्त होता है और कुछ भी उपयोगी नहीं लिखता है, इसलिए यदि status कोई स्ट्रिंग नहीं दिखाता है, तो अपने पाथ के लिए गाइड पर वापस जाएँ।
suggest-models प्रकाशित बेंचमार्क से सक्रिय प्रोवाइडर के चैट मॉडल को रैंक करता है। suggest-models --apply, translationModels को बदल देता है और uiModels और localeModels को वैसे ही छोड़ देता है। यही रैंकिंग डैशबोर्ड मॉडल टैब पर है। रैंकिंग कैसे काम करती है, और सूची में एक से ज़्यादा मॉडल क्यों हैं: AI मॉडल। कमांड रेफ़रेंस: suggest-models।
इसे अनुवादित रखें
जब भी स्रोत टेक्स्ट बदलता है, तो sync को फिर से चलाएँ। एक SQLite कैश का मतलब है कि केवल नया या बदला हुआ टेक्स्ट मॉडल में जाता है, इसलिए फिर से चलाना सस्ता है। CI में sync चलाने से अनुवादों को भटकने से रोका जा सकता है। ai-i18n-tools dashboard कैश्ड अनुवादों की समीक्षा और संपादन के लिए अनुवाद डैशबोर्ड खोलता है।
अनुशंसित package.json स्क्रिप्ट
पैकेज स्थानीय रूप से स्थापित होने पर, स्क्रिप्ट अतिरिक्त शेल सेटअप के बिना node_modules/.bin से ai-i18n-tools को हल करती हैं। एक इंटरैक्टिव शेल के लिए, पहले PATH कॉन्फ़िगर करें: देखें CLI का उपयोग करना।
{
"i18n:extract": "ai-i18n-tools extract",
"i18n:sync": "ai-i18n-tools sync",
"i18n:translate:ui": "ai-i18n-tools translate-ui",
"i18n:translate:svg": "ai-i18n-tools translate-svg",
"i18n:translate:docs": "ai-i18n-tools translate-docs",
"i18n:translate:json": "ai-i18n-tools translate-json",
"i18n:status": "ai-i18n-tools status",
"i18n:statistics": "ai-i18n-tools statistics",
"i18n:dashboard": "ai-i18n-tools dashboard",
"i18n:cleanup": "ai-i18n-tools cleanup"
}व्यक्तिगत अनुवाद स्क्रिप्ट को एक साथ जोड़ने के बजाय sync को प्राथमिकता दें। एकल-चरण स्क्रिप्ट का उपयोग तभी करें जब आपको किसी एक चरण की अकेले आवश्यकता हो।
CLI आउटपुट और डैशबोर्ड को किसी अन्य भाषा में दिखाने के लिए, -L <code> पास करें या AI_I18N_LANG सेट करें: टूल UI भाषा देखें।
एक से अधिक प्रकार की सामग्री का अनुवाद कर रहे हैं, जैसे कि ऐप स्ट्रिंग और एक डॉक्स साइट एक साथ? देखें पाइपलाइन को संयोजित करना।
अगला: अपना पथ चुनें के अंतर्गत आपके पथ के लिए मार्गदर्शिका।