Skip to content

त्वरित शुरुआत ​

यह पृष्ठ एक एकल-भाषा परियोजना को उसकी पहली अनुवादित फ़ाइलों तक मार्गदर्शन करता है। यह एक JS/TS ऐप, एक Python ऐप, एक .NET ऐप, एक वेबसाइट या दस्तावेज़ीकरण साइट, या एक रिपॉजिटरी README और अन्य Markdown फ़ाइलों के लिए है। यह मानता है:

  • Node.js >=22.16.0, या Python या .NET प्रोजेक्ट के लिए स्टैंडअलोन निष्पादन योग्य।
  • किसी LLM प्रदाता के लिए एक API कुंजी, या एक स्थानीय Ollama इंस्टाल।
  • प्रोजेक्ट वर्ज़न कंट्रोल में है, ताकि आप टूल द्वारा लिखी गई चीज़ों की समीक्षा कर सकें।

परियोजनाओं के बीच दो चीजें भिन्न होती हैं: उपकरण आपके टेक्स्ट को कैसे ढूंढता है, और आपका ऐप परिणाम को कैसे लोड करता है। नीचे अपना मार्ग चुनें आपको उसके लिए सही मार्गदर्शिका पर भेजता है।

चलाने योग्य उदाहरण ​

पहले एक पूर्ण परियोजना देखना पसंद करेंगे? रिपॉजिटरी को क्लोन किए बिना एक कॉपी करें:

bash
npx degit wsj-br/ai-i18n-tools/examples/console-app console-app
cd console-app
pnpm install
pnpm run i18n:sync

console-app को किसी अन्य Node.js उदाहरण से बदलें। Python और .NET उदाहरणों में कोई package.json नहीं है; उन्हें वैसे ही कॉपी करें। GitHub रिलीज़ पर चार Python उदाहरण ai-i18n-tools-python-examples.zip में भी हैं, और दो .NET उदाहरण ai-i18n-tools-dotnet-examples.zip में हैं। प्रत्येक उदाहरण क्या दिखाता है, उसकी पूरी सूची उदाहरण पेज पर है।

इंस्टॉल करें ​

bash
pnpm add -D ai-i18n-tools

npm 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) को कॉल करती है, उसे इन दोनों की आवश्यकता होती है:

  1. ai-i18n-tools.config.json में कम से कम एक प्रोवाइडर: translationModels के साथ एक providers.<name> ब्लॉक, और जब एक से ज़्यादा प्रोवाइडर कॉन्फ़िगर किए गए हों, तो एक टॉप-लेवल provider की. init -P <provider> उस प्रीसेट को स्कैफ़ोल्ड करता है. प्रोवाइडर जोड़ने के लिए, LLM प्रोवाइडर देखें. मॉडल की सूची चुनने के लिए, AI मॉडल देखें.
  2. आपके एनवायरमेंट में मैचिंग API की, या जब कोई प्रोवाइडर API की पहले से सेट नहीं है, तो ai-i18n-tools.config.json के बगल में .env / .env.local में. हर बिल्ट-इन प्रीसेट प्रीसेट टेबल से एक नामित वैरिएबल पढ़ता है, उदाहरण के लिए, -P openrouter के साथ OPENROUTER_API_KEY या -P openai के साथ OPENAI_API_KEY. Ollama एक लोकल एंडपॉइंट का इस्तेमाल करता है और उसे किसी की की ज़रूरत नहीं होती.
bash
export OPENROUTER_API_KEY=sk-or-v1-your-key-here

extract, status, और अन्य कमांड जो LLM को कॉल नहीं करते हैं, उन्हें इनमें से किसी की भी आवश्यकता नहीं होती है। पर्यावरण फ़ाइलों और PATH के बारे में अधिक जानकारी: इंस्टॉलेशन।

अपना मार्ग चुनें ​

आपके पास जो है उसे ढूंढें, उसके ब्लॉक में कमांड चलाएं, फिर लिंक की गई मार्गदर्शिका में जारी रखें।

एक JS/TS ऐप ​

आपके बटन और संदेश स्रोत में अभी भी सादे टेक्स्ट में हैं, इसलिए उपकरण को अभी तक कुछ भी नहीं मिला है। उन्हें पहले t() में लपेटा जाना चाहिए, और ऐप को एक छोटी i18next सेटअप फ़ाइल की आवश्यकता है।

bash
ai-i18n-tools init -P openrouter
ai-i18n-tools suggest-models --apply

फिर एक JS/TS ऐप में i18n जोड़ें का पालन करें। यह extract और translate-ui से पहले, एक एजेंट प्रॉम्प्ट के साथ, रैपिंग चरण को कवर करता है।

एक Python ऐप ​

bash
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 ऐप ​

bash
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
bash
ai-i18n-tools init -t ui-vitepress -P openrouter

फिर एक वेबसाइट या डॉक्स साइट में i18n जोड़ें का पालन करें। इसका एजेंट प्रॉम्प्ट फ्रेमवर्क की i18n रूटिंग को सक्षम करता है। उस काम की समीक्षा करने के बाद आप sync चलाते हैं।

एक README या मार्कडाउन डॉक्स ​

अधिकांश रिपॉजिटरी इसे ऐप के साथ चाहते हैं: डिफ़ॉल्ट ui-markdown टेम्पलेट में पहले से ही एक फ़्लैट README ब्लॉक शामिल है। किसी अन्य टेम्पलेट के लिए, --with-readme जोड़ें। केवल मार्कडाउन वाली रिपॉजिटरी docs-markdown का उपयोग करती है।

bash
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 है।

कुछ और ​

प्रत्येक init विकल्प के साथ पूरी टेम्पलेट सूची CLI सेटअप संदर्भ में है।

चलाएँ और जाँचें ​

जब आपका प्रोजेक्ट तैयार हो:

bash
ai-i18n-tools doctor
ai-i18n-tools sync
ai-i18n-tools status

doctor जाँचता है कि कॉन्फ़िग, पाथ, प्रोवाइडर और एनवायरनमेंट तैयार हैं। यह प्रोवाइडर के साथ मॉडल आईडी को भी सत्यापित करता है, जब तक कि आप --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 का उपयोग करना।

json
{
  "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 भाषा देखें।

एक से अधिक प्रकार की सामग्री का अनुवाद कर रहे हैं, जैसे कि ऐप स्ट्रिंग और एक डॉक्स साइट एक साथ? देखें पाइपलाइन को संयोजित करना।

अगला: अपना पथ चुनें के अंतर्गत आपके पथ के लिए मार्गदर्शिका।

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