Skip to content

CLI — आरंभ करना ​

version ​

सारांश: ai-i18n-tools version

सीएलआई संस्करण और बिल्ड टाइमस्टैम्प प्रिंट करें (रूट प्रोग्राम पर -V / --version के समान जानकारी)।


upgrade ​

सारांश: ai-i18n-tools upgrade [--yes]

चल रहे इंस्टाल को नवीनतम प्रकाशित संस्करण में अपग्रेड करें। कमांड स्थापित संस्करण और नया संस्करण प्रिंट करता है, फिर y की प्रतीक्षा करता है। --yes प्रॉम्प्ट का उत्तर देता है, जिसमें तब भी जब stdin टर्मिनल न हो। कोई अन्य उत्तर इंस्टाल को अपरिवर्तित छोड़ देता है। --yes के बिना एक गैर-इंटरैक्टिव stdin एक त्रुटि के साथ बाहर निकलता है और कुछ भी नहीं बदलता है। जब इंस्टाल पहले से ही वर्तमान हो, या प्रकाशित संस्करण से नया हो, तो कमांड उसे प्रिंट करता है और प्रॉम्प्ट नहीं करता है।

एक Node.js इंस्टाल npm रजिस्ट्री से latest डिस्ट-टैग पढ़ता है। एक प्रोजेक्ट डिपेंडेंसी package.json में अपडेट की जाती है (मौजूदा ^, ~, या सटीक ऑपरेटर रखा जाता है) और npm, pnpm, yarn, या bun के साथ स्थापित की जाती है, जिसे packageManager फ़ील्ड या लॉकफ़ाइल से चुना जाता है। एक ग्लोबल Node.js इंस्टाल उस पैकेज मैनेजर का ग्लोबल इंस्टाल चलाता है और वर्तमान डायरेक्टरी में package.json को संपादित नहीं करता है। workspace:, file:, link:, और git स्पेसिफायर अपरिवर्तित रहते हैं और कमांड रुक जाता है। इस रिपॉजिटरी का एक स्रोत चेकआउट अस्वीकृत कर दिया जाता है।

एक स्टैंडअलोन निष्पादन योग्य नवीनतम GitHub रिलीज़ पढ़ता है, वर्तमान ऑपरेटिंग सिस्टम और आर्किटेक्चर के लिए gzip संग्रह डाउनलोड करता है, SHA256SUMS.txt की जाँच करता है, और चल रही फ़ाइल को बदल देता है। प्रकाशित संग्रह Linux x64, Linux arm64, macOS arm64, macOS x64, और Windows x64 हैं।

bash
ai-i18n-tools upgrade
ai-i18n-tools upgrade --yes

init ​

सारांश: ai-i18n-tools init -P <provider> [-t <template>] [-o <path>] [--with-readme] [--with-translate-ignore]

एक स्टार्टर कॉन्फ़िग फ़ाइल लिखें (इसमें provider / providers, concurrency, uiBatchConcurrency, batchConcurrency, batchSize, maxBatchChars, और docs[].addFrontmatter शामिल हैं)। LLM को कॉल करने वाले अनुवाद कमांड के लिए सक्रिय प्रदाता की API कुंजी वातावरण में या .env (ओलामा को छोड़कर) में होनी चाहिए — प्रदाता और API कुंजी देखें।

मुख्य विकल्प: -P / --provider (आवश्यक), -t / --template, -o / --output, --with-readme, --with-translate-ignore

-P / --provider आवश्यक है। यह निर्धारित करता है कि कौन सा अंतर्निहित प्रीसेट स्कैफ़ोल्ड करना है। यह इनमें से एक होना चाहिए: openrouter, openai, anthropic, gemini, deepseek, cerebras, groq, mistral, xai, nvidia, alibaba, apikeyfan, cheaperinference, ollama।

टेम्पलेट (-t):

मानस्काफोल्ड्स
ui-markdownयूआई स्ट्रिंग्स और रीडमी (फ्लैट आउटपुट, भाषा सूची)
ui-docusaurusडॉक्यूसॉरस यूआई + डॉक्स
ui-starlightस्टारलाइट डॉक्स
ui-vitepressवाइटप्रेस डॉक्स (docsOutput.style: "vitepress") प्लस थीम स्ट्रिंग्स के लिए vitepressThemeCatalog
ui-nextraनेक्सट्रा डॉक्स (docsOutput.style: "nextra") प्लस थीम डिक्शनरी के लिए nextraDictionaryPath (साइडबार _meta.ts स्वचालित रूप से एकत्र किया जाता है)
ui-fumadocsफ़्यूमाडॉक्स डॉक्स (docsOutput.style: "fumadocs") प्लस यूआई ओवरराइड के लिए fumadocsUiCatalog (साइडबार meta.json स्वचालित रूप से एकत्र किया जाता है)
ui-astro-websiteएस्ट्रो वेबसाइट यूआई स्ट्रिंग्स
ui-plain-htmlसादा HTML कैटलॉग (data-i18n* मार्कर, फ्लैट लोकेल JSON)
docs-plain-htmlसादे HTML दस्तावेज़ (प्रति लोकेल एक फ़ाइल, भाषा सूची, hreflang)
docs-markdownमार्कडाउन डॉक्स: रीडमी और .md फ़ाइलें, फ्लैट आउटपुट, भाषा सूची
ui-json-bundlesJSON (केवल json[])
ui-pythonपायथन यूआई स्ट्रिंग्स, स्रोत-भाषा स्ट्रिंग द्वारा कुंजीबद्ध फ्लैट JSON, और i18n.py
ui-python-gettextफ़्लैट JSON और GNU .po / .mo के साथ Python UI स्ट्रिंग्स, साथ ही i18n.py
ui-python-djangoDjango gettext / {% blocktrans %} कैटलॉग (flatOutput: false, डोमेन django, कोई i18n.py नहीं)
ui-python-flasktranslations/ (flatOutput: false) के अंतर्गत Flask / Jinja कैटलॉग, साथ ही i18n.py
ui-dotnet.NET UI स्ट्रिंग, सोर्स-लैंग्वेज स्ट्रिंग द्वारा कुंजीबद्ध फ़्लैट JSON, और I18n.cs
ui-dotnet-resx.NET UI स्ट्रिंग .resx सैटेलाइट (flatOutput: false) और I18nResx.cs के रूप में

--with-readme एक README.md डॉक्स ब्लॉक जोड़ता है (outputDir translated-docs, docsOutput.style "flat", एक languageListBlock) और features.translateDocs को true पर सेट करता है। यह कुछ नहीं करता है जब एक डॉक्स ब्लॉक में पहले से ही README.md सूचीबद्ध होता है, जो ui-markdown और docs-markdown के लिए मामला है। यह केवल कॉन्फ़िग लिखता है। यह README.md में पेस्ट करने के लिए मार्कर लाइन प्रिंट करता है और जब वह फ़ाइल गुम होती है तो चेतावनी देता है। गाइड: अपने रीडमी और मार्कडाउन डॉक्स में i18n जोड़ें।

bash
ai-i18n-tools init -t docs-markdown -P openrouter
ai-i18n-tools init -t ui-python -P openrouter --with-readme

--with-translate-ignore एक स्टार्टर .translate-ignore बनाता है (जिसमें Python virtualenv और कैश डायरेक्टरी शामिल हैं)।

init कार्यशील डायरेक्टरी में .gitignore भी बनाता है, या उसमें जोड़ता है। जोड़ी गई लाइनें .translation-cache/*, !.translation-cache/cache.db, benchmark-scores.json, .env, .env.local, .env.*.local, *.tmp, और *.backup.* हैं, प्रत्येक एक छोटी टिप्पणी के तहत। पहले से मौजूद लाइनें वैसी ही छोड़ दी जाती हैं, और दूसरी बार चलाने पर वे डुप्लिकेट नहीं होती हैं।

ui-python, ui-python-gettext, और ui-python-flask उस फ़ाइल के गुम होने पर i18n.py भी लिखते हैं। Django प्रोजेक्ट Django का अपना gettext रनटाइम रखते हैं, इसलिए ui-python-django i18n.py नहीं लिखता है। ui-dotnet उस फ़ाइल के गुम होने पर I18n.cs लिखता है और .csproj में जोड़ने के लिए EmbeddedResource आइटम प्रिंट करता है। ui-dotnet-resx इसके बजाय I18nResx.cs लिखता है और ui.resx को Resources/SharedResource.<culture>.resx पर इंगित करता है। --namespace C# नेमस्पेस को ओवरराइड करता है। गाइड: .NET एप्लिकेशन और .NET ResourceManager ऐप में i18n जोड़ें।

migrate-python-i18n असुरक्षित पूर्व-मूल्यांकित कॉल (_(f"..."), _("..." % expr), _("...".format(...))) को लुकअप-बिफोर-फॉर्मेट कॉल में फिर से लिखता है। डिफ़ॉल्ट रूप से यह एक ड्राई रन है। फ़ाइलों को संपादित करने के लिए --write पास करें, और समीक्षा नोट्स के लिए migrate-python-i18n-report.md पढ़ें। एक जटिल एक्सप्रेशन को एक्सप्रेशन से नाम दिया जाता है जब वह स्थिर होता है (start.isoformat() {start} बन जाता है, len(rows) {rows_count} बन जाता है)। एक बचा हुआ {value_1} रिपोर्ट किया जाता है ताकि उसका नाम बदला जा सके। जेनरेट की गई i18n.py फ़ाइलें छोड़ दी जाती हैं। एक साफ़ रिपोर्ट का मतलब यह नहीं है कि अनरैप्ड f-स्ट्रिंग्स कवर किए गए थे।

migrate-dotnet-i18n T($"..."), संयोजन, और string.Format के लिए T() के अंदर भी यही करता है। --wrap अचिह्नित XAML लेबल और उच्च-विश्वास वाले C# सिंक को भी चिह्नित करता है; --write के बिना, यह एक ऑडिट है। रिपोर्ट migrate-dotnet-i18n-report.md है। जनरेट किए गए I18n.cs और I18nResx.cs को छोड़ दिया जाता है। मार्गदर्शिका: .NET एप्लिकेशन।


doctor ​

सारांश: ai-i18n-tools doctor [--local] [--strict] [--json] [--fix-gitignore]

सुनिश्चित करें कि प्रोजेक्ट अनुवाद के लिए तैयार है। रिपोर्ट में कॉन्फ़िग सिंटैक्स और स्कीमा, व्यावसायिक नियम, स्थापित संस्करण, स्रोत और आउटपुट पाथ, UI कैटलॉग फ़ाइलें, उन कैटलॉग में प्लेसहोल्डर बेमेल, कैश आंकड़े, कॉन्फ़िगर किए गए प्रोवाइडर, सेट किए गए समर्थित पर्यावरण वैरिएबल और मॉडल आईडी शामिल हैं। एक कैटलॉग जिसमें किसी प्लेसहोल्डर का नाम बदला गया है, उसे हटा दिया गया है, या फिर से लिखा गया है, एक चेतावनी है और एक उदाहरण बताता है। प्रोवाइडर अनुभाग केवल उन प्रोवाइडरों को सूचीबद्ध करता है जिनका नाम कॉन्फ़िग फ़ाइल में है (एक लेगेसी टॉप-लेवल openrouter ब्लॉक सहित)। बिल्ट-इन OpenRouter डिफ़ॉल्ट केवल तभी सूचीबद्ध होता है जब फ़ाइल में किसी प्रोवाइडर का नाम न हो।

डिफ़ॉल्ट रूप से, doctor सक्रिय प्रोवाइडर के कैटलॉग के विरुद्ध कॉन्फ़िगर किए गए मॉडल आईडी की भी जाँच करता है और स्थापित संस्करण की तुलना नवीनतम GitHub रिलीज़ से करता है। --local दोनों नेटवर्क कॉल को छोड़ देता है। एक नया रिलीज़, या एक GitHub अनुरोध जो विफल हो जाता है, एक चेतावनी है। एक गुम या समाप्त मॉडल आईडी कमांड को विफल कर देता है। जब कोई भी जाँच चेतावनी देती है तो --strict त्रुटि के साथ बाहर निकलता है।

API कुंजी मान कभी प्रिंट नहीं किए जाते हैं। सेट वैरिएबल Configured variables: NAME, ... के रूप में वर्णानुक्रम में सूचीबद्ध किए जाते हैं। एक वैरिएबल जो API कुंजी नहीं है, उसका मान शामिल होता है।

गुम इनपुट पाथ विफल हो जाते हैं। गुम आउटपुट डायरेक्टरी एक नोट होती हैं, क्योंकि पहला अनुवाद रन उन्हें बनाता है। doctor कॉन्फ़िग को फिर से नहीं लिखता, डायरेक्टरी नहीं बनाता, या स्रोत टेक्स्ट को किसी मॉडल पर नहीं भेजता। --fix-gitignore गुम हुई .gitignore लाइनों को जोड़ता है और बाकी सभी फ़ाइलों को अकेला छोड़ देता है।

doctor चेतावनी देता है जब कॉन्फ़िग के बगल में .gitignore में एक आवश्यक पैटर्न गुम होता है। चेतावनी आपको ai-i18n-tools doctor --fix-gitignore चलाने के लिए कहती है। जब .gitignore पहले से मौजूद होता है, तो वह एक खाली लाइन, टिप्पणी # ai-i18n-tools doctor fix, और केवल गुम हुई लाइनों को जोड़ता है। यह पहले से मौजूद लाइनों को डुप्लिकेट नहीं करता है। एक गुम हुई फ़ाइल उसी ब्लॉक के साथ बनाई जाती है जिसे init लिखता है। दो कैश पैटर्न कॉन्फ़िगर किए गए cacheDir का पालन करते हैं, इसलिए .i18n-cache को डिफ़ॉल्ट .translation-cache लाइनों के बजाय .i18n-cache/* और !.i18n-cache/cache.db की आवश्यकता होती है। अन्य पैटर्न benchmark-scores.json, .env, .env.local, .env.*.local, *.tmp, और *.backup.* हैं। एक लाइन जो कैश डायरेक्टरी को ही अनदेखा करती है, जैसे .i18n-cache/, वह भी एक चेतावनी है, क्योंकि Git अनदेखी की गई डायरेक्टरी के तहत cache.db को ट्रैक नहीं करेगा। --fix-gitignore उस लाइन को नहीं हटाता है। चेतावनी केवल --strict के साथ कमांड को विफल करती है।

मुख्य विकल्प: --local, --strict, --json, --fix-gitignore

bash
ai-i18n-tools doctor
ai-i18n-tools doctor --local
ai-i18n-tools doctor --fix-gitignore

help ​

सारांश: ai-i18n-tools help [command]

एक सबकमांड के लिए सहायता प्रदर्शित करें (ai-i18n-tools <command> --help के समान आउटपुट)।

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