इंटीग्रेशन
फ्रेमवर्क एकीकरण के लिए संदर्भ: वे क्या साझा करते हैं और उनकी शेल स्ट्रिंग कैसे भिन्न होती हैं। किसी साइट में भाषाएँ जोड़ने के लिए, किसी वेबसाइट या डॉक्स साइट में i18n जोड़ें से शुरू करें। किसी ऐप के लिए, किसी JS/TS ऐप में i18n जोड़ें, किसी Python ऐप में i18n जोड़ें, या किसी .NET ऐप में i18n जोड़ें से शुरू करें। किसी रिपॉजिटरी README और अन्य Markdown फ़ाइलों के लिए, अपनी README और Markdown डॉक्स में i18n जोड़ें से शुरू करें।
डॉक्यूमेंटेशन इंटीग्रेशन पेज सामग्री के लिए डॉक्यूमेंट्स पाइपलाइन (translate-docs / sync) का उपयोग करते हैं; शेल स्ट्रिंग (नेविगेशन, साइडबार, थीम) को उसी पाइपलाइन के भीतर संभाला जाता है जहाँ उल्लेख किया गया है — अलग JSON पाइपलाइन के माध्यम से नहीं। Python एप्लिकेशन UI स्ट्रिंग पाइपलाइन (extract / translate-ui) का उपयोग करते हैं।
कौन सी गाइड पढ़ें
चयन तालिका, जिसमें प्रति फ्रेमवर्क एक इनिट टेम्पलेट है, किसी वेबसाइट या दस्तावेज़ साइट में i18n जोड़ें में है। उस पृष्ठ पर दिया गया वॉकथ्रू प्रॉम्प्ट फ्रेमवर्क के i18n को सक्षम करता है। नीचे दिए गए एकीकरण पृष्ठ शेल-कैटलॉग विवरण रखते हैं। पाइथन फ्रेमवर्क: पाइथन।
साझा अवधारणाएं
डॉक्यूमेंटेशन-फ्रेमवर्क इंटीग्रेशन Documents में वर्णित समान docs[] ब्लॉक मॉडल साझा करते हैं। अपने फ्रेमवर्क ("docusaurus", "vitepress", "nextra", "fumadocs", या "astro-starlight") से मेल खाने के लिए docsOutput.style सेट करें। आउटपुट फ़ोल्डर लेआउट और लिंक रीराइटिंग व्यवहार के लिए, Output layouts और Link rewriting देखें। Python सेटअप अलग है: Python।
प्रत्येक init -t ui-* -P <provider> स्कैफ़ोल्ड उस प्रीसेट का एलएलएम प्रोवाइडर ब्लॉक लिखता है। translate-docs या sync से पहले, संबंधित एपीआई कुंजी सेट करें — प्रोवाइडर और एपीआई कुंजी देखें।
क्रॉस-फ्रेमवर्क तुलना के लिए फ्रेमवर्क शेल अनुवाद देखें। नीचे दिया गया प्रत्येक लिंक किया गया गाइड उस फ्रेमवर्क के लिए सेटअप को कवर करता है।
फ्रेमवर्क शेल अनुवाद
| फ्रेमवर्क | शेल / थीम स्ट्रिंग्स | पाइपलाइन |
|---|---|---|
| डॉक्यूसॉरस | write-translations कैटलॉग ({ message, description }) | डॉक्यूमेंट्स — docs[].docusaurusCatalogDir + translate-docs |
| वाइटप्रेस | थीम/नेविगेशन/साइडबार कैटलॉग | डॉक्यूमेंट्स — docsOutput.vitepressThemeCatalog + translate-docs |
| नेक्सट्रा | _meta.ts साइडबार लेबल | डॉक्यूमेंट्स — style: "nextra" + translate-docs होने पर ऑटो |
| नेक्सट्रा | थीम डिक्शनरी .ts | डॉक्यूमेंट्स — docs[].nextraDictionaryPath + translate-docs |
| फुमाडॉक्स | meta.json साइडबार लेबल | डॉक्यूमेंट्स — style: "fumadocs" + translate-docs होने पर ऑटो |
| फुमाडॉक्स | UI ओवरराइड कैटलॉग | डॉक्यूमेंट्स — docsOutput.fumadocsUiCatalog + translate-docs |
| एस्ट्रो स्टारलाइट | बिल्ट-इन UI स्ट्रिंग्स (कई लोकेल); कोई अतिरिक्त शेल पाइपलाइन नहीं | डॉक्यूमेंट्स — translate-docs (केवल पेज) |
फ्रेमवर्क शेल/थीम स्ट्रिंग्स को json[] में न डालें — वह पाइपलाइन असंबंधित ऐप लोकेल बंडलों के लिए है। प्रति-फ्रेमवर्क सेटअप विवरण कौन सा गाइड पढ़ना है से लिंक किए गए गाइड में हैं।
चलाने योग्य उदाहरण
| फ़्रेमवर्क | उदाहरण रेपो |
|---|---|
| Astro Starlight | examples/astro-docs |
| सामान्य Astro वेबसाइट | examples/astro-website |
| Docusaurus | examples/docusaurus-docs |
| VitePress | examples/vitepress-docs |
| Nextra | examples/nextra-docs |
| Fumadocs | examples/fumadocs-docs |
| Streamlit | examples/python-streamlit |
| Flask | examples/python-flask |
| FastAPI | examples/python-fastapi |
| GNU gettext | examples/python-gettext |
| .NET JSON हेल्पर | examples/dotnet-console |
| .NET ResourceManager हेल्पर | examples/dotnet-resx |