उदाहरण
GitHub पर examples/ के तहत चलाने योग्य प्रोजेक्ट — प्रत्येक अपनी स्वयं की कॉन्फ़िग, कमिटेड लोकेल आउटपुट और README के साथ। आप API कुंजी के बिना अनुवादित फ़ाइलों का अन्वेषण कर सकते हैं; अनुवाद को फिर से चलाने के लिए एक प्रदाता कुंजी की आवश्यकता होती है (प्रदाता और मॉडल)।
स्टैंडअलोन चलाएँ (npx degit)
पूरे रिपॉजिटरी को क्लोन किए बिना एक उदाहरण कॉपी करें।
Node.js उदाहरण
प्रत्येक Node.js उदाहरण वर्तमान पैकेज संस्करण से मेल खाने वाली ai-i18n-tools की एक प्रकाशित कैरेट रेंज घोषित करता है और npm से CLI इंस्टॉल करता है:
npx degit wsj-br/ai-i18n-tools/examples/<name> <name>
cd <name>
pnpm installPython उदाहरण
python-streamlit, python-flask, python-fastapi, और python-gettext में कोई package.json नहीं है। नीचे दी गई तालिका में degit कमांड मान्य हैं। आप GitHub Release से ai-i18n-tools-python-examples.zip भी डाउनलोड कर सकते हैं। वह ज़िप वही चार निर्देशिकाएँ हैं। यह npm पैकेज का हिस्सा नहीं है, और यह स्टैंडअलोन निष्पादन योग्य फ़ाइल के अंदर नहीं है।
python-streamlit, python-flask, और python-fastapi एक virtualenv और pip install -r requirements.txt का उपयोग करते हैं। python-gettext केवल मानक लाइब्रेरी का उपयोग करता है। standalone executable के साथ अनुवाद करें।
npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit
cd python-streamlit
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtWindows पर, .venv\Scripts\activate को सक्रिय करें।
यदि आपने इसके बजाय पूरी ai-i18n-tools रिपॉजिटरी को क्लोन किया है, तो रिपॉजिटरी रूट पर pnpm install और pnpm run build चलाएँ, फिर cd examples/<name> चलाएँ। वर्कस्पेस (Node.js) उदाहरण अपने pnpm run i18n:* स्क्रिप्ट के माध्यम से स्थानीय CLI का उपयोग करते हैं, या PATH setup के बाद सीधे ai-i18n-tools … का उपयोग करते हैं। उस चेकआउट में Python उदाहरण बिल्ड के बाद node ../../bin/ai-i18n-tools.mjs के साथ अनुवाद करते हैं। Installation — Cloned monorepo देखें।
.NET उदाहरण
dotnet-console और dotnet-resx में कोई package.json नहीं है। नीचे दी गई तालिका में degit कमांड मान्य हैं। आप GitHub रिलीज़ से ai-i18n-tools-dotnet-examples.zip भी डाउनलोड कर सकते हैं। उस ज़िप में वही दो डायरेक्टरी और assets/dotnet शामिल हैं, जिन्हें प्रोजेक्ट ../../assets/dotnet के माध्यम से कंपाइल करते हैं। यह npm पैकेज का हिस्सा नहीं है, और यह स्टैंडअलोन एक्ज़ीक्यूटेबल के अंदर नहीं है। उस ज़िप से पहले प्रकाशित रिलीज़ में यह शामिल नहीं है।
दोनों xUnit प्रोजेक्ट हैं। dotnet-console I18n.cs की जाँच करता है। dotnet-resx I18nResx.cs और .resx सैटेलाइट्स की जाँच करता है। कोई भी अनुवाद API को कॉल नहीं करता है। डायरेक्टरी में dotnet test चलाएँ। एक पूर्ण क्लोन से, रिपॉजिटरी रूट पर pnpm test:dotnet दोनों को चलाता है और तब छोड़ देता है जब dotnet PATH पर नहीं होता है।
ai-i18n-tools-dotnet-examples.zip को अनपैक करें, फिर उदाहरण डायरेक्टरी से जाँचें चलाएँ। आर्काइव examples/ और assets/dotnet को साथ-साथ रखता है, जो वह पाथ है जिसे प्रोजेक्ट कंपाइल करते हैं:
cd examples/dotnet-console
dotnet testdegit एक डायरेक्टरी कॉपी करता है और इसमें assets/dotnet शामिल नहीं है। वे कंपाइल लिंक एक पूर्ण क्लोन में, या ज़िप को अनपैक करने के बाद हल होते हैं।
कौन सा उदाहरण मेरे प्रोजेक्ट से मेल खाता है?
- एक JS/TS ऐप: console-app (सबसे छोटा) या nextjs-app। गाइड: एक JS/TS ऐप में i18n जोड़ें।
- एक Python ऐप: python-streamlit, python-flask, या python-fastapi। गाइड: एक Python ऐप में i18n जोड़ें।
- एक Django या GNU gettext ऐप: python-gettext (एक gettext कमांड-लाइन टूल; कोई Django उदाहरण डायरेक्टरी नहीं है)। गाइड: एक Django / Python gettext ऐप में i18n जोड़ें।
- एक .NET हेल्पर: dotnet-console (
I18n.cs) या dotnet-resx (I18nResx.csऔर.resxसैटेलाइट्स)। गाइड: एक .NET ऐप में i18n जोड़ें और एक .NET ResourceManager ऐप में i18n जोड़ें। - एक वेबसाइट या डॉक्स साइट: docusaurus-docs, vitepress-docs, astro-docs, nextra-docs, fumadocs-docs, astro-website, plain-html, या plain-html-docs। गाइड: एक वेबसाइट या डॉक्स साइट में i18n जोड़ें।
- एक ऐप के बगल में एक रिपॉजिटरी README: console-app या nextjs-app (nextjs उदाहरण में एक डॉक्स साइट भी है)। गाइड: अपने README और Markdown डॉक्स में i18n जोड़ें।
- कुछ और: multi-provider, test-markdown, और intlayer-migration।
उदाहरणों की सूची
| उदाहरण | इसके लिए सबसे अच्छा | degit के साथ कॉपी करें | चलाएँ |
|---|---|---|---|
| console-app | t() UI स्ट्रिंग्स + README अनुवाद के साथ सबसे छोटा कार्यशील ऐप | npx degit wsj-br/ai-i18n-tools/examples/console-app console-app | pnpm start |
| nextjs-app | React / Next.js + बहुवचन + डैशबोर्ड; नेस्टेड Docusaurus डॉक्स + फ्लैट README + SVG एसेट | npx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-app | pnpm dev (ऐप :3030; डॉक्स के लिए cd docs-site && pnpm start :3040) |
| docusaurus-docs | Docusaurus दस्तावेज़ साइट केवल (docusaurus प्रीसेट) | npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docs | pnpm start (:3100; बिल्ड + सर्व, लोकेल मेनू काम करता है) |
| astro-website | Astro लैंडिंग पेज: पूर्ण-पृष्ठ HTML + t() हाइब्रिड | npx degit wsj-br/ai-i18n-tools/examples/astro-website astro-website | pnpm dev |
| astro-docs | Astro Starlight दस्तावेज़ साइट | npx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docs | pnpm dev (:3050) |
| vitepress-docs | VitePress डॉक्स साइट + थीम JSON (pt-BR, zh-Hans) | npx degit wsj-br/ai-i18n-tools/examples/vitepress-docs vitepress-docs | pnpm run docs:dev (:3060) |
| nextra-docs | Nextra 4 MDX + _meta.ts / डिक्शनरी .ts शेल, और एक t() सर्वर कंपोनेंट (pt-BR, zh-Hans) | npx degit wsj-br/ai-i18n-tools/examples/nextra-docs nextra-docs | pnpm run dev (:3070) |
| fumadocs-docs | Fumadocs 4 MDX + meta.json / UI कैटलॉग (pt, zh, डॉट पार्सर) | npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docs | pnpm run dev (:3080) |
| plain-html | सादा HTML + data-i18n* मार्कर; स्थिर लोकेल JSON (डैशबोर्ड-शैली UI) | npx degit wsj-br/ai-i18n-tools/examples/plain-html plain-html | pnpm dev (:3090) |
| प्लेन-एचटीएमएल-डॉक्स | दस्तावेज़ों के रूप में प्लेन HTML: प्रति लोकेल एक पृष्ठ, स्थानीयकृत छवियाँ, hreflang | npx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docs | pnpm dev (:3092) |
| multi-provider | एक LLM प्रदाता चुनें या बेंचमार्क करें (-P / --provider) | npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-provider | ai-i18n-tools translate-docs -P openai --force |
| test-markdown | रिग्रेशन-टेस्ट मार्कडाउन / CJK अनुवाद (देवनागरी, MDX) | npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdown | pnpm build |
| intlayer-migration | इंटलेयर .content.ts → t() (migrate-intlayer, रीसेट + AI-एजेंट रिपोर्ट) | npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migration | pnpm reset && pnpm dev (:3091) |
| intlayer-translate | Intlayer रखें, गायब लोकेल को वहीं भरें (translate-intlayer; en + pt-BR शामिल, es + zh-Hans गायब) | npx degit wsj-br/ai-i18n-tools/examples/intlayer-translate intlayer-translate | pnpm reset && pnpm translate (pnpm dev :3093) |
| python-streamlit | Streamlit डैशबोर्ड, t() / _(), सोर्स-स्ट्रिंग JSON | npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit | python3 -m venv .venv && pip install -r requirements.txt && streamlit run app.py |
| python-flask | Flask + Jinja, t() / _(), सोर्स-स्ट्रिंग JSON | npx degit wsj-br/ai-i18n-tools/examples/python-flask python-flask | python3 -m venv .venv && pip install -r requirements.txt && flask --app app run |
| python-fastapi | FastAPI, ContextVar लोकेल, t() / _(), सोर्स-स्ट्रिंग JSON | npx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapi | python3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app |
| python-gettext | मौजूदा GNU gettext CLI; extract / translate-ui रिफ्रेश .po और .mo | npx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettext | python3 app.py --lang es |
| dotnet-console | I18n.cs के xUnit जाँच: एम्बेडेड JSON, कल्चर फ़ॉलबैक, {0}, प्लुरल्स, और Configure | npx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-console | dotnet test |
| dotnet-resx | I18nResx.cs और स्रोत-स्ट्रिंग .resx सैटेलाइट्स के xUnit जाँच | npx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resx | dotnet test |
प्रत्येक उदाहरण नाम पूर्ण सेटअप, कमांड और प्रोजेक्ट लेआउट के साथ अपने GitHub README से लिंक करता है — या रिपॉजिटरी में उदाहरण इंडेक्स ब्राउज़ करें।
Node.js उदाहरण pnpm install के बाद npm से CLI इंस्टॉल करते हैं। चार Python उदाहरण venv और pip (python-gettext केवल मानक लाइब्रेरी का उपयोग करता है) और अनुवाद के लिए स्टैंडअलोन एक्ज़ीक्यूटेबल का उपयोग करते हैं। दो .NET उदाहरण xUnit प्रोजेक्ट हैं। उन्हें dotnet test के साथ चलाएँ। वे GitHub रिलीज़ पर ai-i18n-tools-dotnet-examples.zip में भी हैं।
अस्वीकरण
उत्पाद नाम और आइकन उनके संबंधित स्वामियों की संपत्ति हैं और केवल पहचान के उद्देश्य से उपयोग किए जाते हैं। यह सॉफ़्टवेयर उन ब्रांडों से संबद्ध नहीं है और न ही उनके द्वारा अनुमोदित है।