Docusaurus डॉक्स का दूसरी भाषा में अनुवाद करें, MDX और कोड छुए बिना
अपने डॉक्स फ़ोल्डर को Zip करें, अपलोड करें, और वही फ़ाइलें अनुवादित पाएं, जो सीधे i18n/<locale>/docusaurus-plugin-content-docs/current में रखने के लिए तैयार हैं। Import लाइनें, Tabs और अन्य कंपोनेंट, admonition मार्कर्स, कोड ब्लॉक्स और लिंक्स वैसे ही रहते हैं; टाइटल्स, साइडबार लेबल्स, विवरण और मुख्य टेक्स्ट का अनुवाद किया जाता है। बिना अकाउंट के पहला हिस्सा फ़्री है; 1,000,000 कैरेक्टर तक के टेक्स्ट के लिए सिर्फ़ एक बार पेमेंट $5।
- import और export लाइनें व JSX कंपोनेंट लाइनें जैसी हैं वैसी ही कॉपी की जाती हैं
- Admonition मार्कर्स (:::note, :::tip) सुरक्षित रहते हैं; उनके अंदर का टेक्स्ट अनुवादित होता है
- Front matter: title, description और sidebar_label अनुवादित; id, slug, sidebar_position सुरक्षित
- {#install} जैसे हेडिंग एंकर्स सुरक्षित रहते हैं ताकि लिंक्स काम करते रहें
- .zip के रूप में वही फ़ोल्डर पाथ वापस मिलते हैं; इमेज बिना बदलाव के कॉपी होती हैं
बिना कॉपी-पेस्ट के Docusaurus i18n
Docusaurus को लोकेल फ़ोल्डर में हर डॉक की अनुवादित कॉपी, उन्हीं फ़ाइल नामों के साथ चाहिए होती है। इसे हाथ से करना, या चैटबॉट में एक-एक फ़ाइल करके करना बहुत धीमा होता है, और MDX में गलतियां बहुत भारी पड़ती हैं: एक अनुवादित import नाम या बदला हुआ prop पूरे बिल्ड को तोड़ देता है। यह टूल सिर्फ़ उन्हीं हिस्सों का अनुवाद करता है जो पाठक देखते हैं और बाकी सब कुछ आपकी फ़ाइलों से हूबहू कॉपी कर लेता है।
इनलाइन कोड, लिंक टार्गेट्स, इमेज पाथ और MDX {expressions} को अनुवाद से पहले मार्कर्स से बदल दिया जाता है और बाद में वापस रख दिया जाता है, ताकि मॉडल उन्हें कभी देख ही न पाए। सिर्फ़ JSX वाली लाइनें, जैसे कि <Tabs> या <TabItem value="mac">, छोड़ दी जाती हैं। कोड ब्लॉक्स पूरी तरह छोड़ दिए जाते हैं, उनके कमेंट्स सहित।
डाउनलोड करने के बाद
- Unzip करें और docs-<locale> फ़ोल्डर की सामग्री को i18n/<locale>/docusaurus-plugin-content-docs/current में कॉपी करें
- थीम लेबल्स और साइडबार कैटेगरी के नामों के लिए docusaurus write-translations चलाएं, जो JSON में होते हैं
- --locale <locale> के साथ साइट शुरू करें और क्लिक करके जांचें
- अगर कोई चेतावनियों वाली फ़ाइल (warnings file) है, तो उसमें दिए गए किसी भी पैराग्राफ़ को ठीक करें
इसमें शामिल नहीं है
साइडबार कैटेगरी लेबल्स, navbar और फ़ूटर टेक्स्ट write-translations द्वारा जनरेट की गई JSON फ़ाइलों में होते हैं; उनका अनुवाद लोकलाइज़ेशन फ़ाइल टूल से करें। ब्लॉग पोस्ट भी डॉक्स की तरह ही काम करते हैं: ब्लॉग फ़ोल्डर को zip करें और इसे दूसरे जॉब के रूप में अपलोड करें, या डॉक्स के साथ एक ही .zip में अपलोड करें।
टूल कैसे काम करता है, कितना खर्च आता है और आपकी फ़ाइलें कैसे संभाली जाती हैं, यह Markdown डॉक्स अनुवाद पेज पर है; हर टूल की कीमत कीमत पेज पर है।
आख़िरी अपडेट:
सवाल और जवाब
क्या बिल्ड बिना किसी रुकावट के पास हो जाएगा?
Imports, कंपोनेंट्स, props, कोड और लिंक टार्गेट्स आपकी फ़ाइलों से ही कॉपी किए जाते हैं, जहाँ आमतौर पर MDX बिल्ड टूटते हैं। कॉपी करने के बाद एक बार बिल्ड चलाएं और चेतावनियों वाली फ़ाइल (warnings file) जांचें।
क्या admonitions का अनुवाद किया जाता है?
:::note और ::: लाइनें वैसी ही रखी जाती हैं; उनके बीच के टेक्स्ट का अनुवाद किया जाता है।
एक जॉब में कितना डेटा आ सकता है?
$5 में 1,000,000 कैरेक्टर तक का टेक्स्ट, यानी लगभग 300 पेज। कोड और front matter की कीज़ (keys) इसमें नहीं गिनी जाती हैं।
क्या मैं पहले कुछ फ़ाइलें आज़मा सकता हूँ?
हाँ। पहला हिस्सा फ़्री में अनुवादित होता है और स्क्रीन पर दिखाया जाता है; 40 पैराग्राफ़ तक का जॉब पूरी तरह फ़्री है।