सीएलआई — यूआई स्ट्रिंग्स
extract
सारांश: ai-i18n-tools extract
includeUiLanguageEnglishNames सक्षम होने पर t("…") / i18n.t("…") लिटरल्स, वैकल्पिक package.json विवरण, और वैकल्पिक बंडल-मास्टर englishName प्रविष्टियों से strings.json को अपडेट करें (ui.uiExtractor देखें; languagesManifestPath को नहीं पढ़ता)। साथ ही प्रत्येक ब्लॉक के ui-languages.json को पुनः उत्पन्न करता है। जब .html / .htm को ui.uiExtractor.extensions में सूचीबद्ध किया जाता है, तो HTML से data-i18n / data-i18n-title / data-i18n-placeholder मार्कर स्ट्रिंग्स को भी कैप्चर करता है। sourceRoots वाले प्रत्येक ui ब्लॉक को प्रोसेस करता है। --ui-block रन को एक ब्लॉक (इंडेक्स, विवरण, या stringsJson पाथ) तक सीमित करता है। LLM को कॉल नहीं करता है।
यह भी देखें: यूआई स्ट्रिंग्स अवलोकन, प्लेन एचटीएमएल ऐप्स
migrate-intlayer
सारांश: ai-i18n-tools migrate-intlayer [paths...] [--write] [--report <path>] [--content-glob <glob>] [--t-import <specifier>]
Intlayer *.content.ts डिक्शनरी को strings.json और फ़्लैट लोकैल फ़ाइलों में आयात करें, और साधारण useIntlayer / getIntlayer कॉल साइटों को t('source string') में फिर से लिखें। स्ट्रिंग sourceLocale में लिखी गई है, जो कोई भी भाषा हो सकती है। डिफ़ॉल्ट रूप से ड्राई रन (रिपोर्ट फिर भी लिखी जाती है)। --write कैटलॉग को सीड करता है और सुरक्षित रीराइट लागू करता है। LLM को कॉल नहीं करता है।
रिपोर्ट --write द्वारा छोड़ी गई हर चीज़ के हैंडऑफ़ के रूप में कार्य करती है, और यह एक चरण-दर-चरण TODO के साथ समाप्त होती है जो बाकी कार्य को क्रमबद्ध करता है: प्रत्येक मैन्युअल साइट के लिए एक ठोस t() या JSX कॉल, import { t } लाइन, डिक्शनरी फ़ाइलें और बाद में हटाने के लिए IntlayerProvider के अवशेष, स्रोत स्ट्रिंग्स जिन्हें पहले extract और फिर translate-ui की आवश्यकता होती है, और ऐप के i18n मॉड्यूल पर पेस्ट करने के लिए एक i18next रनटाइम बूटस्ट्रैप। लोकेल नियंत्रण को i18n.changeLanguage के साथ-साथ loadLocale को भी कॉल करना होगा। extract ui-languages.json लिखता है, जिसे वह बूटस्ट्रैप इम्पोर्ट करता है। strings.json, फ्लैट लोकेल फ़ाइलों, या ui-languages.json को मैन्युअल रूप से संपादित न करें।
मुख्य विकल्प: --write, --report, --content-glob (डिफ़ॉल्ट **/*.content.ts), --t-import
यह भी देखें: इंटलेयर से माइग्रेट करना
translate-intlayer
सारांश: ai-i18n-tools translate-intlayer [paths...] [-l <codes>] [--ui-block <selector>] [--dry-run] [-j <n>]
Intlayer *.content.ts डिक्शनरी के अंदर गुम और बासी लोकैल लीफ का वहीं अनुवाद करें, डिक्शनरी को सत्य के स्रोत के रूप में रखते हुए। migrate-intlayer के विपरीत, यह ऐप को Intlayer से बाहर नहीं ले जाता है; यह केवल t({ … }) लीफ को भरता है। इसका उपयोग तब करें जब आप रनटाइम पर Intlayer को रखना चाहते हैं और ai-i18n-tools को अनुवाद इंजन के रूप में उपयोग करना चाहते हैं।
यह हर t({ … }) लीफ़ को निकालता है, चुने गए UI ब्लॉक के strings.json को स्रोत पाठ से भरता है, translate-ui के समान इंजन चलाता है (प्रदाता चयन, शब्दावली, अनुवाद संदर्भ, और मॉडल फ़ॉलबैक), फिर नई प्रति-स्थानिक स्ट्रिंग को प्रत्येक t({ … }) ऑब्जेक्ट में वापस लिखता है। संपादन सटीक होते हैं: केवल गुम या पुरानी स्थानीय लाइनें बदलती हैं, इसलिए आपकी फ़ॉर्मेटिंग और टिप्पणियाँ संरक्षित रहती हैं। इंटलेयर {token} प्लेसहोल्डर अनुवाद के लिए {{token}} तक राउंड-ट्रिप करते हैं और वापस आते हैं।
एक लीफ+लोकैल का अनुवाद तब होता है जब लोकैल लीफ से अनुपस्थित होता है (गुम), या जब उस लोकैल के लिए पिछली रन के बाद स्रोत-लोकैल टेक्स्ट बदल गया हो (बासी)। बासीपन को cacheDir में ट्रैक किया जाता है, इसलिए उस स्रोत स्ट्रिंग को संपादित करने से अगली रन पर उस एक लीफ का फिर से अनुवाद होता है। स्रोत भाषा sourceLocale है और कोई भी भाषा हो सकती है। --dry-run LLM को कॉल किए बिना या कुछ भी लिखे बिना गुम/बासी गणनाओं की रिपोर्ट करता है। features.translateUIStrings और UI ब्लॉक के stringsJson की आवश्यकता है (translate-ui के समान)।
मुख्य विकल्प: -l / --locale, --ui-block, --dry-run, -j / --concurrency
[paths...]: स्कैन करने के लिए फ़ाइलें/निर्देशिकाएँ/ग्लोब (डिफ़ॉल्ट: ब्लॉक का sourceRoots). -l / --locale: कॉमा-सेपरेटेड लक्ष्य लोकेल भरने के लिए (डिफ़ॉल्ट: ब्लॉक का कॉन्फ़िगर किया गया targetLocales). --ui-block: शून्य-आधारित इंडेक्स, विवरण, या stringsJson पाथ (डिफ़ॉल्ट: ब्लॉक 0). -j लोकेल को समानांतर करता है।
यह भी देखें: माइग्रेट-इंटलेयर, इंटलेयर से माइग्रेट करना
mark-html
सारांश: ai-i18n-tools mark-html [paths...] [--write]
HTML में बेयर data-i18n / data-i18n-title / data-i18n-placeholder मार्कर्स डालें ताकि सोर्स टेक्स्ट केवल एक बार (स्वयं एलिमेंट पर) लिखा जाए। दी गई फ़ाइलों/डायरेक्ट्रीज़/ग्लोब्स को स्कैन करता है (डिफ़ॉल्ट: प्रत्येक ब्लॉक के sourceRoots के अंतर्गत .html / .htm)। डिफ़ॉल्ट रूप से ड्राई रन (प्रति-फ़ाइल जोड़े गए काउंट्स और किसी भी मिक्स्ड-कंटेंट एलिमेंट्स की रिपोर्ट करता है जिन्हें मैन्युअल <span data-i18n> की आवश्यकता है); --write परिवर्तन लागू करता है। इडेम्पोटेंट, data-i18n-ignore का सम्मान करता है (एलिमेंट और उसके सबट्री को छोड़ देता है), कभी भी कोड-जैसे एलिमेंट्स (code, pre, kbd, samp, var) या खाली/केवल-संख्यात्मक टेक्स्ट को नहीं छेड़ता, और कभी भी वैल्यूड मार्कर उत्सर्जित नहीं करता। LLM को कॉल नहीं करता है।
मुख्य विकल्प: --write
यह भी देखें: अनुवाद के लिए एचटीएमएल को चिह्नित करना
generate-ui-languages
सारांश: ai-i18n-tools generate-ui-languages [--master <path>] [--dry-run]
ui-languages.json को languagesManifestPath (डिफ़ॉल्ट {ui.flatOutputDir}/ui-languages.json) में sourceLocale + targetLocales और बंडल किए गए data/ui-languages-complete.json (या --master) का उपयोग करके लिखें। मास्टर फ़ाइल से गायब लोकेल के लिए TODO प्लेसहोल्डर की चेतावनी देता है और उत्सर्जित करता है। यदि आपके पास अनुकूलित label या englishName मानों के साथ एक मौजूदा मैनिफेस्ट है, तो उन्हें मास्टर कैटलॉग डिफ़ॉल्ट द्वारा प्रतिस्थापित किया जाएगा — उत्पन्न फ़ाइल की समीक्षा करें और बाद में समायोजित करें।
मुख्य विकल्प: --master, --dry-run
translate-ui
सारांश: ai-i18n-tools translate-ui [-l <codes>] [--force] [--dry-run] [-j <n>]
केवल यूआई स्ट्रिंग्स का अनुवाद करें (strings.json → लोकेल JSON)। features.translateUIStrings की आवश्यकता है।
मुख्य विकल्प: -l / --locale, --force, --dry-run, -j / --concurrency
-l / --locale: कॉमा-सेपरेटेड लक्ष्य लोकेल (डिफ़ॉल्ट: कॉन्फ़िग targetLocales माइनस sourceLocale)। --force: प्रति लोकेल सभी प्रविष्टियों का पुनः अनुवाद करें (मौजूदा अनुवादों को अनदेखा करें)। --dry-run: कोई राइट्स नहीं, कोई API कॉल नहीं। -j लोकेल को समानांतर करता है; प्रत्येक लोकेल के भीतर, कॉन्फ़िग uiBatchConcurrency (डिफ़ॉल्ट 2) LLM बैचों (50 स्ट्रिंग के चंक, फिर बहुवचन समूह) को समानांतर करता है। uiBatchConcurrency के लिए कोई CLI फ़्लैग नहीं है। प्रत्येक सफल बैच को अगले बैच के शुरू होने से पहले strings.json और फ़्लैट लोकेल फ़ाइल में लिखा जाता है। sync-ui और sync का UI चरण एक ही राइट का उपयोग करते हैं।
एक संग्रहीत अनुवाद जिसके प्लेसहोल्डर उसके स्रोत से मेल नहीं खाते, उसका फिर से अनुवाद किया जाता है। यह जाँच एक बदले हुए नाम ({schedule} का {cronograma} बनना), एक छोड़े गए या बनाए गए टोकन, और एक प्रारूप-विनिर्देश परिवर्तन ({price:,.2f} का {price} बनना) को कवर करती है। बैच से पहले संख्या मुद्रित की जाती है, जिसमें --dry-run भी शामिल है। एक पंक्ति जिसका मॉडल user-edited है, उसे यथावत रखा जाता है और केवल उसके बारे में चेतावनी दी जाती है। एक स्ट्रिंग जिसमें केवल प्लेसहोल्डर और विराम चिह्न हैं, जैसे कि {state} · {title}, उसे कॉपी किया जाता है और मॉडल को नहीं भेजा जाता है। एक बैच जो एक प्लेसहोल्डर का नाम बदलता है, उसे अस्वीकृत कर दिया जाता है और उस त्रुटि को जोड़कर श्रृंखला में अगले मॉडल को आज़माया जाता है। डैशबोर्ड उन्हीं पंक्तियों को चिह्नित करता है और एक ऐसे अनुवाद को सहेजने से पहले पूछता है जो एक प्लेसहोल्डर को तोड़ता है।
sync-ui
सारांश: ai-i18n-tools sync-ui [-l <codes>] [--force] [--dry-run] [-j <n>]
UI स्ट्रिंग निकालें, फिर उनका अनुवाद करें (इसके लिए features.translateUIStrings आवश्यक है)। केवल UI — कोई दस्तावेज़, SVG, या json[] नहीं। translate-ui के समान -l, --force, --dry-run, और -j विकल्प।
proofread-ui
सारांश: ai-i18n-tools proofread-ui [-l <code>] [--chunk <n>] [--dry-run] [--json] [-j <n>]
पहले extract चलाता है (जिसके लिए features.translateUIStrings की आवश्यकता है) ताकि प्रत्येक चयनित कैटलॉग स्रोत से मेल खाए, फिर स्रोत-लोकेल UI स्ट्रिंग (वर्तनी, व्याकरण) की LLM समीक्षा करता है। --ui-block एक्सट्रैक्ट और समीक्षा को एक ब्लॉक तक सीमित करता है। शब्दावली के संकेत केवल glossary.userGlossary CSV से आते हैं (जो translate-ui के समान दायरे में है — UI कैटलॉग वापस नहीं डाले जाते हैं, ताकि खराब कॉपी को शब्दावली के रूप में पुष्ट न किया जाए)। सक्रिय LLM प्रदाता (उसके API-की env var) का उपयोग करता है।
विफलता पर 1 के साथ एग्ज़िट करता है (लापता फ़ीचर फ़्लैग, एक्सट्रैक्ट विफलता, लापता/अमान्य कैटलॉग, लापता API कुंजी, या जब सभी बैच विफल हो जाते हैं); जब रन सफलतापूर्वक पूरा हो जाता है तो 0 के साथ एग्ज़िट करता है (निष्कर्ष केवल सलाहात्मक होते हैं)। cacheDir के अंतर्गत proofread-ui-results_<timestamp>.log को एक मानव-पठनीय रिपोर्ट (सारांश, समस्याएँ, समीक्षा न की गई पंक्तियाँ, और प्रति-स्ट्रिंग OK पंक्तियाँ) के रूप में लिखता है; टर्मिनल केवल सारांश गणना और समस्याएँ प्रिंट करता है (प्रति स्ट्रिंग कोई [ok] पंक्तियाँ नहीं)। जो बैच विफल हो जाता है, या मॉडल प्रतिक्रिया जो बैच से छोटी होती है और जिसमें प्रत्येक स्लॉट पर कोई उपयोगी index नहीं होता, वह उन स्ट्रिंग्स को 'समीक्षा नहीं की गई' के रूप में गिनता है। उनकी समस्याओं को हटा दिया जाता है ताकि छोटी सरणी गलत स्ट्रिंग्स पर लागू न हो। अंतिम पंक्ति पर लॉग फ़ाइल नाम प्रिंट करता है। --json के साथ, मानव-शैली आउटपुट stderr पर जाता है। लिंक path:line का उपयोग करते हैं, ठीक वैसे ही जैसे डैशबोर्ड UI स्ट्रिंग्स लिंक बटन।
मुख्य विकल्प: -l / --locale, --chunk (डिफ़ॉल्ट 50), --dry-run, --json, -j / --concurrency
export-ui-xliff
सारांश: ai-i18n-tools export-ui-xliff [-l <codes>] [-o <dir>] [--untranslated-only] [--dry-run]
strings.json को XLIFF 2.0 में निर्यात करें (प्रति लक्ष्य स्थानीय एक .xliff)। केवल पढ़ने के लिए; कोई API नहीं।
मुख्य विकल्प: -l / --locale, -o / --output-dir, --untranslated-only, --dry-run
-o / --output-dir: आउटपुट डायरेक्टरी (डिफ़ॉल्ट: कैटलॉग के समान फ़ोल्डर)। --untranslated-only: उस स्थानीय के लिए अनुवाद गुम होने वाली इकाइयाँ ही।