किसी वेबसाइट या दस्तावेज़ साइट में i18n जोड़ें
यह पेज एक भाषा में एक डॉक्यूमेंटेशन साइट (Markdown या MDX) या मार्केटिंग या स्टैटिक साइट (एक Astro वेबसाइट या प्लेन HTML) के लिए है। यह टूल आपके LLM प्रोवाइडर पर मौजूद मॉडल के साथ आपके पेज के कंटेंट का अनुवाद करता है और हर भाषा के लिए एक स्थानीय कॉपी लिखता है। आपका साइट फ्रेमवर्क उन कॉपियों को सर्व करता है और भाषा स्विचर प्रदान करता है।
ऐसे ऐप के लिए जिसके UI स्ट्रिंग t() कॉल में रहते हैं, इसके बजाय JS/TS ऐप में i18n जोड़ें या पायथन ऐप में i18n जोड़ें का उपयोग करें।
आपके पास क्या है?
| आपकी साइट | प्रारंभिक टेम्पलेट | यहां से शुरू करें |
|---|---|---|
| एस्ट्रो स्टारलाइट या सादा एस्ट्रो | ui-starlight / हाइब्रिड UI स्ट्रिंग्स | एस्ट्रो |
| डॉक्यूसॉरस | ui-docusaurus | डॉक्यूसॉरस |
| वाइटप्रेस | ui-vitepress | वाइटप्रेस |
| नेक्सट्रा 4 (नेक्स्ट.जेएस ऐप राउटर) | ui-nextra | नेक्सट्रा |
| फुमाडॉक्स 4 (नेक्स्ट.जेएस ऐप राउटर) | ui-fumadocs | फुमाडॉक्स |
| सादे एचटीएमएल पेज | ui-plain-html या docs-plain-html | सादे एचटीएमएल ऐप |
| कोई साइट फ्रेमवर्क नहीं, केवल एक README और मार्कडाउन फ़ाइलें | docs-markdown, या कोई भी टेम्प्लेट और --with-readme | अपनी README और मार्कडाउन डॉक्स में i18n जोड़ें |
एजेंट प्रॉम्प्ट
- एस्ट्रो स्टारलाइट: केवल नोट्स। एस्ट्रो
t()फ़ाइलें: JS/TS प्रॉम्प्ट (i18next छोड़ें)। - डॉक्यूसॉरस: केवल नोट्स (
<Translate>डॉक्यूसॉरस का अपना एपीआई है)। - वाइटप्रेस: थीम कैटलॉग प्रॉम्प्ट।
- नेक्सट्रा: डिक्शनरी प्रॉम्प्ट और हाइब्रिड
t()प्रॉम्प्ट। - फुमाडॉक्स: UI कैटलॉग प्रॉम्प्ट।
- README और मार्कडाउन फ़ाइलें: README प्रॉम्प्ट।
चरण
हर फ्रेमवर्क के लिए समान आकार काम करता है; विवरण ऊपर दिए गए फ्रेमवर्क गाइड में हैं।
- सीएलआई इंस्टॉल करें और एपीआई कुंजी सेट करें: इंस्टॉलेशन, प्रदाता और एपीआई कुंजी।
- स्केफोल्ड:
ai-i18n-tools init -t <template> -P <provider>। sourceLocale,targetLocales, औरdocs[].contentPathsसेट करें (आपके स्रोत भाषा में लिखे गए पेज और फ़ोल्डर)।sourceLocaleकोई भी भाषा हो सकती है। फ्रेमवर्क गाइड सहीdocsOutput.styleदिखाता है।- अपने फ्रेमवर्क के स्वयं के i18n को सक्षम करें ताकि यह स्थानीयकृत पेजों को परोस सके और लिंक कर सके। प्रत्येक गाइड में "मौजूदा साइट में i18n सक्षम करें" अनुभाग है: वाइटप्रेस, डॉक्यूसॉरस, नेक्सट्रा, फुमाडॉक्स, एस्ट्रो।
ai-i18n-tools sync(याtranslate-docs) चलाएँ, फिर साइट बनाएँ।- ब्राउज़र में एक स्थानीयकृत मार्ग की जाँच करें। फ्रेमवर्क का अपना लोकल ड्रॉपडाउन स्विचर है। README जैसी एक सपाट मार्कडाउन फ़ाइल के लिए, languageListBlock के साथ एक लिंक पंक्ति जोड़ें।
क्या अनुवादित होता है
पेज बॉडी हमेशा दस्तावेज़ पाइपलाइन से गुजरती हैं। फ्रेमवर्क क्रोम (नेविगेशन, साइडबार, थीम लेबल) को उसी रन में संभाला जाता है जहाँ फ्रेमवर्क इसका समर्थन करता है, अलग JSON पाइपलाइन के माध्यम से नहीं।
| फ्रेमवर्क | शेल और थीम स्ट्रिंग | कैसे |
|---|---|---|
| डॉक्यूसॉरस | write-translations कैटलॉग ({ message, description }) | docs[].docusaurusCatalogDir और translate-docs |
| वाइटप्रेस | थीम, नेविगेशन और साइडबार कैटलॉग | docsOutput.vitepressThemeCatalog और translate-docs |
| नेक्सट्रा | _meta.ts साइडबार लेबल | style: "nextra" के साथ स्वचालित |
| नेक्सट्रा | थीम डिक्शनरी .ts | docs[].nextraDictionaryPath |
| फुमाडॉक्स | meta.json साइडबार लेबल | style: "fumadocs" के साथ स्वचालित |
| Fumadocs | UI ओवरराइड कैटलॉग | docsOutput.fumadocsUiCatalog |
| Astro Starlight | कई लोकेल में अंतर्निहित UI स्ट्रिंग्स | केवल पृष्ठ |
छवियां और स्क्रीनशॉट translate-docs द्वारा अनुवादित नहीं होते हैं। लोकेल-विशिष्ट फ़ाइलों के लिए, छवियां और स्क्रीनशॉट देखें।
सादा HTML
दो विकल्प, इस बात पर निर्भर करता है कि पृष्ठ को कैसे व्यवहार करना चाहिए:
- एक पृष्ठ जो ब्राउज़र में भाषा बदलता है: पाठ को
data-i18n*एट्रिब्यूट के साथ चिह्नित करें और UI स्ट्रिंग्स रनटाइम (ui-plain-html) का उपयोग करें। सादे HTML ऐप्स देखें। - प्रति लोकेल एक अनुवादित HTML फ़ाइल: डॉक्यूमेंट्स पाइपलाइन (
docs-plain-html) का उपयोग करें। HTML पृष्ठ देखें।
एक फ़ाइल एक पाथ से संबंधित है।
आपका मामला नहीं?
- ऐप UI स्ट्रिंग्स: एक JS/TS ऐप में i18n जोड़ें या एक Python ऐप में i18n जोड़ें।
- साइट के बगल में एक रिपॉजिटरी README, या मार्कडाउन फ़ाइलें और कोई साइट फ़्रेमवर्क नहीं: अपनी README और मार्कडाउन डॉक्स में i18n जोड़ें।
init … --with-readmeउस ब्लॉक को साइट टेम्पलेट के बगल में जोड़ता है। - स्टैंडअलोन नेस्टेड लोकेल JSON: JSON।
- एक साइट और ऐप स्ट्रिंग्स दोनों का अनुवाद करना: पाइपलाइनों का संयोजन।
साझा विकल्पों और प्रति-फ़्रेमवर्क अंतर के लिए संदर्भ: एकीकरण।