Skip to content

इंटीग्रेशन ​

फ्रेमवर्क एकीकरण के लिए संदर्भ: वे क्या साझा करते हैं और उनकी शेल स्ट्रिंग कैसे भिन्न होती हैं। किसी साइट में भाषाएँ जोड़ने के लिए, किसी वेबसाइट या डॉक्स साइट में 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 Starlightexamples/astro-docs
सामान्य Astro वेबसाइटexamples/astro-website
Docusaurusexamples/docusaurus-docs
VitePressexamples/vitepress-docs
Nextraexamples/nextra-docs
Fumadocsexamples/fumadocs-docs
Streamlitexamples/python-streamlit
Flaskexamples/python-flask
FastAPIexamples/python-fastapi
GNU gettextexamples/python-gettext
.NET JSON हेल्परexamples/dotnet-console
.NET ResourceManager हेल्परexamples/dotnet-resx

MIT लाइसेंस के तहत जारी किया गया।