सामान्य गलतियाँ और समस्या निवारण

स्क्रीनशॉट पाथ में कोई लोकेल डायरेक्टरी नहींimages/screenshots/screenshot.png — लोकेल वेरिएंट को अलग नहीं कर सकता और इसे फिर से नहीं लिखा जा सकता। प्रति-लोकेल फ़ोल्डर रीराइटिंग का उपयोग करने से पहले images/screenshots/<locale>/screenshot.png में पुनर्गठन करें।

रेगेक्स में हार्डकोडेड स्रोत लोकेल"search": "screenshots/en-GB/" — यदि sourceLocale बदलता है तो चुपचाप टूट जाता है। इसके बजाय "search": "screenshots/[^/]+/" का उपयोग करें।

एक ही डायरेक्टरी में SVG स्रोत और आउटपुट यदि svg.sourcePath और svg.outputDir ओवरलैप होते हैं, तो जेनरेट की गई फ़ाइलें हाथ से संपादित स्रोतों के साथ मिल जाती हैं। उन्हें अलग-अलग डायरेक्टरी में रखें।

सह-स्थित SVGs के लिए निरपेक्ष Docusaurus स्थैतिक URL/img/diagram.svg (static/img/ से) को अनुवादित आउटपुट में ../assets/ पर फिर से लिखने के लिए regexAdjustments नियम की आवश्यकता होती है। स्रोत SVGs को static/assets/ में रखें और इसे पूरी तरह से टालने के लिए शुरुआत से ही सापेक्ष ../assets/diagram.svg का उपयोग करें।

Docusaurus में docs/assets सिम्लिंक गायब है सिम्लिंक के बिना, docs/user-guide/ में स्रोत डॉक्स static/assets/ में PNG या SVG को सापेक्ष पाथ के माध्यम से संदर्भित नहीं कर सकते हैं। प्रोजेक्ट निर्माण के समय सिम्लिंक सेट करें: ln -s ../static/assets documentation/docs/assets।

take-screenshots स्क्रिप्ट केवल स्रोत लोकेल को कैप्चर करती है प्रति-लोकेल फ़ोल्डर लेआउट को प्रत्येक लोकेल के लिए PNG फ़ाइलों की आवश्यकता होती है। यदि स्क्रिप्ट केवल en-GB को कैप्चर करती है, तो अनुवादित डॉक्स में गुम फ़ाइलों की ओर इशारा करने वाले फिर से लिखे गए पाथ होंगे।

फ़ेंस्ड कॉन्फ़िग उदाहरणों के अंदर regexAdjustments रीराइटिंगpostProcessing फेंस्ड कोड ब्लॉक सहित, पूर्ण अनुवादित मार्कडाउन बॉडी पर चलता है। यदि कोई डॉक पेज एक कॉन्फ़िग स्निपेट एम्बेड करता है जिसमें एक मिलान पाथ होता है (उदाहरण के लिए screenshots/en-GB/), तो वह स्निपेट अनुवादित आउटपुट में भी फिर से लिखा जाता है। पुन: प्रयोज्य उदाहरणों में सामान्य screenshots/[^/]+/ फ़ॉर्म को प्राथमिकता दें, या स्वीकार करें कि अनुवादित डॉक्स में चित्रों के अंदर लोकेल-विशिष्ट पाथ दिखाई देंगे।