समस्या निवारण

अनुवादित दस्तावेज़ों में अनुभाग एंकर लिंक काम नहीं करते हैं

[label](other.md#section-id) जैसा लिंक सही अनुवादित फ़ाइल खोल सकता है लेकिन इच्छित शीर्षक तक स्क्रॉल करने में विफल रहता है — या गलत अनुभाग पर कूद जाता है। #… खंड अब उस स्थान में किसी भी शीर्षक id से मेल नहीं खाता है।

सामान्य कारण:

• स्रोत शीर्षकों में कभी भी स्पष्ट एंकर आईडी नहीं थे; साइट दृश्यमान शीर्षक पाठ से स्लग प्राप्त करती है, जो अनुवाद के बाद बदल जाता है।
• आपने स्रोत में एक शीर्षक का नाम बदला है लेकिन पहले की <a id="…"></a> पंक्ति गायब है या अभी भी पुरानी आईडी है।
• एंकर लिंक अंग्रेजी शब्दों से अनुमानित #… खंड का उपयोग करते हैं, न कि आईडी write-heading-ids उत्पन्न करेगा।

ठीक करें

1. अपने स्रोत ai-i18n-tools write-heading-ids पर .md / .mdx (समान docs[] / contentPaths जैसे translate-docs) चलाएं। डिफ़ॉल्ट रूप से, यह प्रत्येक एटीएक्स हेडिंग से पहले <a id="slug"></a> डालता है, या जब हेडिंग पाठ वर्तमान स्लग से मेल नहीं खाता है तो एक मौजूदा एंकर को ताज़ा करता है। Docusaurus MDX कमेंट आईडी के लिए, --slug-style mdx-comment का उपयोग करें।
2. एंकर लिंक्स को उन आईडी पर निर्देशित करें — उदाहरण के लिए [setup](guide.md#first-run) जहां #first-run लक्ष्य हेडिंग के ऊपर एंकर लाइन से मेल खाता है, केवल अंग्रेजी शीर्षक से अनुमानित स्लग नहीं।
3. translate-docs (या sync --force-update) को पुनः चलाएं ताकि हर स्थानीयकृत प्रति में अद्यतन एंकर लाइनें शामिल हों।

परिवर्तनों का पूर्वावलोकन करने के लिए पहले write-heading-ids पर --dry-run का उपयोग करें। पूर्ण पैटर्न के लिए एंकर लिंक देखें।

अनुवादित दस्तावेज़ों में छवि या संपत्ति लिंक 404

एक मार्कडाउन लिंक या ![alt](url) अंग्रेजी में काम करता है लेकिन अनुवादित प्रतियों में 404 लौटाता है — अक्सर क्योंकि URL अभी भी स्रोत-स्थान फ़ोल्डर या केवल-अंग्रेजी स्थिर पथ पर इंगित करता है।

ठीक करें

1. पुष्टि करें कि आपकी संपत्ति लेआउट आपके docsOutput.style (फ्लैट बनाम डॉक-सिस्टम) से मेल खाता है। लिंक पुनर्लेखन और छवियाँ और स्क्रीनशॉट देखें।
2. स्थान खंडों को स्वैप करने या पूर्ण /img/… पथों को जोड़ने के लिए docsOutput.postProcessing.regexAdjustments जोड़ें या समायोजित करें। फ्लैट लेआउट के लिए, याद रखें कि फ्लैट लिंक रीराइटर regexAdjustments से पहले चलता है — पहले से उपसर्गित URL के विरुद्ध पैटर्न का मिलान करें।
3. सुनिश्चित करें कि स्थान-विशिष्ट संपत्ति फ़ाइलें उन पथों पर मौजूद हैं जिन्हें पुनर्लिखित मार्कडाउन संदर्भित करता है (translate-docs URL को फिर से लिखता है लेकिन रास्टर फ़ाइलों की प्रतिलिपि नहीं बनाता है)।

हिंदी, अरबी, CJK, या सिरिलिक आउटपुट को रोमन में लिखा गया है (लैटिन अक्षर)

कुछ मॉडल अर्थ का अनुवाद करते हैं लेकिन परिणाम लैटिन/रोमन अक्षरों में लिखते हैं (उदाहरण के लिए हिंदी को Namaste के बजाय नमस्ते के रूप में)। केवल hi का अर्थ देवनागरी है; hi-Latn का उपयोग तभी करें जब आप रोमन में लिखी हिंदी चाहते हों।

ठीक करें

1. पुष्टि करें कि लोकेल कोड उस स्क्रिप्ट से मेल खाता है जिसे आप चाहते हैं (hi बनाम hi-Latn, zh-Hans बनाम zh-Hant, sr बनाम sr-Latn)।
2. अनुवाद को फिर से चलाएँ ताकि गलत-स्क्रिप्ट कैश पंक्तियों को अस्वीकार कर दिया जाए: UI स्ट्रिंग के लिए translate-ui --force, या translate-docs --check-cache / sync --check-cache (फ़ाइल-स्तर स्किप केवल अपेक्षित स्क्रिप्ट वाले लोकेल के लिए बायपास किया जाता है; वैध सेगमेंट कैश अभी भी पुन: उपयोग किया जाता है)। --force-update प्रत्येक लोकेल को फिर से संसाधित करता है।
3. यदि कोई मॉडल स्क्रिप्ट जांच में विफल होता रहता है, तो उस लोकेल के लिए एक localeModels प्रविष्टि जोड़ें ताकि पहले एक मजबूत मॉडल का प्रयास किया जा सके — प्रदाता और मॉडल देखें।