एस्ट्रो इंटीग्रेशन
ai-i18n-tools का उपयोग एस्ट्रो के साथ दो सामान्य सेटअप में करें: एस्ट्रो स्टारलाइट दस्तावेज़ साइटें और साधारण एस्ट्रो मार्केटिंग या ऐप साइटें। दोनों पृष्ठ सामग्री के लिए दस्तावेज़ (translate-docs) का उपयोग करते हैं; साधारण एस्ट्रो साइटें अक्सर फ्रंटमैटर और साझा डेटा में t() स्ट्रिंग के लिए UI स्ट्रिंग (extract / translate-ui) के साथ इसे जोड़ती हैं।
यह भी देखें यूआई स्ट्रिंग्स, दस्तावेज़, और नीचे दिए गए चलाने योग्य उदाहरण।
एस्ट्रो स्टारलाइट
एस्ट्रो स्टारलाइट दस्तावेज़ीकरण साइटों के लिए init -t ui-starlight और docsOutput.style: "astro-starlight" का उपयोग करें। प्रीसेट doc-system के लिए एक उपनाम है जिसमें एक खाली localeSubpath है — अनुवादित पृष्ठ स्रोत-स्थानीय ट्री के बगल में src/content/docs/<locale>/ के अंतर्गत आते हैं। sourceLocale कोई भी भाषा हो सकती है।
त्वरित शुरुआत
ai-i18n-tools init -t ui-starlight -P cheaperinference
# edit ai-i18n-tools.config.json (targetLocales, providers, contentPaths)
pnpm run i18n:sync # or: ai-i18n-tools sync
pnpm dev # Starlight dev server (project-specific script)पृष्ठ लेआउट
अंग्रेजी मार्कडाउन और MDX स्टारलाइट सामग्री रूट (आमतौर पर src/content/docs/) पर रहते हैं। अनुवादित प्रतियां स्रोत ट्री के बगल में लिखी जाती हैं:
src/content/docs/quick-start.md → src/content/docs/de/quick-start.md
src/content/docs/guide/setup.mdx → src/content/docs/fr/guide/setup.mdxएक docs[] ब्लॉक कॉन्फ़िगर करें:
{
"contentPaths": ["src/content/docs/"],
"outputDir": "src/content/docs",
"docsOutput": {
"style": "astro-starlight",
"docsRoot": "src/content/docs"
}
}contentPaths को sourceLocale में लिखी गई .md / .mdx फ़ाइलों और निर्देशिकाओं पर इंगित करें। वह भाषा कोई भी भाषा हो सकती है। docsRoot को उसी फ़ोल्डर पर सेट करें जिसे स्टारलाइट अपनी सामग्री रूट के रूप में उपयोग करता है।
स्टारलाइट UI ओवरराइड आवश्यकता पड़ने पर एक अलग docs[] ब्लॉक में src/content/i18n/en.json के साथ jsonPathTemplate का उपयोग कर सकते हैं — दस्तावेज़ — दस्तावेज़ों के लिए आरंभ करें देखें।
स्टारलाइट कई लोकेल (नेविगेशन लेबल, खोज प्लेसहोल्डर, सामग्री की तालिका, आदि) के लिए अंतर्निहित UI स्ट्रिंग भेजता है। कॉन्फ़िगर करने के लिए कोई अलग शेल/थीम पाइपलाइन नहीं है — केवल पृष्ठ सामग्री के लिए translate-docs का उपयोग करें। अन्य फ्रेमवर्क के लिए, फ्रेमवर्क शेल अनुवाद देखें।
स्पष्ट साइडबार labels, साइट title, और social[].label में astro.config.mjs अंग्रेजी शाब्दिक हैं जिन्हें यह उपकरण अनुवादित नहीं करता है। slug प्रविष्टियों को प्राथमिकता दें ताकि लेबल पृष्ठ के अनुवादित फ्रंटमैटर (title) से आए। एक समूह या एक बाहरी लिंक जिसे अपनी स्वयं की शब्दावली की आवश्यकता होती है, स्टारलाइट के प्रति-स्थानीय translations मैप का उपयोग करता है (डिफ़ॉल्ट स्थानीय के लिए label, दूसरों के लिए translations['pt-BR'])। वर्तमान स्टारलाइट स्कीमा में social[].label में कोई अनुवाद फ़ील्ड नहीं है; यह जैसा लिखा है वैसा ही रहता है। स्टारलाइट साइडबार और examples/astro-docs/astro.config.mjs देखें, जो slug प्रविष्टियों का उपयोग करता है।
किसी मौजूदा साइट में i18n सक्षम करें
पहली बार का सेटअप वेबसाइट या डॉक्स साइट में i18n जोड़ें पर दिए गए प्रॉम्प्ट का उपयोग करता है। नीचे दी गई चेकलिस्ट हाथ से किए गए काम के समान है।
- स्टारलाइट कॉन्फ़िग में
locales, जिसमें एकrootप्रविष्टि शामिल है जब अंग्रेजी अप्रत्यक्ष होनी चाहिए (labelऔर आवश्यकlang)। defaultLocale: 'root'जब डिफ़ॉल्ट भाषा वह रूट स्थानीय हो।defaultLocaleको तभी छोड़ें जब स्टारलाइट का डिफ़ॉल्ट पहले से मेल खाता हो।- अंग्रेजी पृष्ठ
src/content/docs/में रहते हैं;translate-docssrc/content/docs/<locale>/लिखता है। - गैर-रूट स्थानीय कुंजियों के साथ संरेखित
targetLocales(केस देखें: स्टारलाइट निर्देशिका कुंजियाँ अक्सर छोटे अक्षरों में होती हैं, जैसेpt-br)।
उदाहरण परियोजना
उदाहरण/एस्ट्रो-डॉक्स — src/content/docs/ पर अंग्रेजी स्रोत, src/content/docs/<locale>/ के तहत प्रतिबद्ध अनुवाद, RTL लोकेल (ar), और शब्दावली-संचालित अनुवाद। पोर्ट 3050 पर pnpm dev चलाएँ।
सादा एस्ट्रो (मार्केटिंग और ऐप साइटें)
स्टैटिक एस्ट्रो मार्केटिंग या ऐप साइटों (स्टारलाइट नहीं) के लिए, एस्ट्रो बिल्ट-इन i18n राउटिंग को ai-i18n-tools के साथ संयोजित करें। पहली बार का सेटअप वेबसाइट या डॉक्स साइट में i18n जोड़ें पर दिए गए प्रॉम्प्ट का उपयोग करता है। संदर्भ कार्यान्वयन examples/astro-website है: अंग्रेजी / पर, लक्षित लोकेल /{locale}/ पर।
अधिकांश टीमें एक ही पृष्ठ पर दो पाइपलाइनों के हाइब्रिड का उपयोग करती हैं:
| पाइपलाइन | इसके लिए उपयोग करें | कमांड | आउटपुट |
|---|---|---|---|
| पृष्ठ HTML | शीर्षक, पैराग्राफ, नेविगेशन लेबल, टेम्पलेट बॉडी में इनलाइन एरे | translate-docs | प्रति लोकेल src/pages/{locale}/index.astro |
यूआई स्ट्रिंग्स (t()) | फ्रंटमैटर डेटा, टैब लेबल, साझा एरे | extract → translate-ui | public/locales/{locale}.json (कुंजी के रूप में स्रोत-भाषा स्ट्रिंग) |
त्वरित शुरुआत
ai-i18n-tools init -t ui-astro-website -P ollama
# enable features.translateDocs and add a docs[] block for page HTML (see below)
pnpm run i18n:sync
pnpm devinit -t ui-astro-website -P ollama के साथ यूआई एक्सट्रैक्शन को स्केफ़ोल्ड करें, फिर, जब आप पेज एचटीएमएल का भी अनुवाद करें, तो एक docs[] ब्लॉक में मर्ज करें:
{
"features": {
"translateUIStrings": true,
"translateDocs": true
},
"ui": {
"sourceRoots": ["src/"],
"stringsJson": "public/locales/strings.json",
"flatOutputDir": "public/locales/"
},
"docs": [{
"contentPaths": ["src/pages/index.astro"],
"outputDir": "src/pages",
"docsOutput": {
"style": "astro-starlight",
"docsRoot": "src/pages"
},
"addFrontmatter": false
}]
}जब आप कोई भाषा जोड़ते या हटाते हैं, तो तीन सूचियों को संरेखित रखें: targetLocales में ai-i18n-tools.config.json, i18n.locales में astro.config.mjs (एस्ट्रो pt-br जैसे छोटे अक्षरों वाले रूट कोड का उपयोग करता है), और ui-languages.json (generate-ui-languages के माध्यम से)। फ्लैट बंडल फ़ाइलनाम कॉन्फ़िग केसिंग (pt-BR.json) का उपयोग करते हैं; एस्ट्रो के pt-br रूट को अपनी मेनिफेस्ट code फ़ील्ड के माध्यम से उस फ़ाइल पर मैप करें।
कुंजी के रूप में स्रोत-भाषा शाब्दिक को देखकर बिल्ड टाइम पर t('…') को हल करें — examples/astro-website/src/i18n/t.ts देखें। sourceLocale कोई भी भाषा हो सकती है। उदाहरण अंग्रेजी का उपयोग करता है। आपको एक स्थिर साइट के लिए ai-i18n-tools/runtime या i18next की आवश्यकता नहीं है जब तक कि आप क्लाइंट आइलैंड्स नहीं जोड़ते जो लोड होने के बाद भाषा बदलते हैं।
उदाहरण प्रोजेक्ट
examples/astro-website — translate-docs के माध्यम से HTML के साथ हाइब्रिड लैंडिंग पेज और t() + translate-ui के माध्यम से स्क्रीनशॉट टैब लेबल।
उदाहरण प्रोजेक्ट
| प्रोजेक्ट | उपयोग का मामला | पोर्ट |
|---|---|---|
| examples/astro-docs | स्टारलाइट दस्तावेज़ | 3050 |
| examples/astro-website | प्लेन एस्ट्रो मार्केटिंग साइट (HTML + t() हाइब्रिड) | (रीडमी देखें) |
examples/astro-docs की तुलना examples/docusaurus-docs से करें — समान ट्यूटोरियल सामग्री, स्टारलाइट के बजाय डॉक्यूसॉरस आउटपुट शैली।