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

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

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

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

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

ठीक करें

1. अपने स्रोत .md / .mdx (translate-docs के समान docs[] / contentPaths) पर ai-i18n-tools write-heading-ids चलाएँ। यह प्रत्येक ATX शीर्षक से पहले <a id="slug"></a> सम्मिलित करता है, या जब शीर्षक पाठ वर्तमान स्लग से मेल नहीं खाता है तो एक मौजूदा एंकर को ताज़ा करता है।
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 को फिर से लिखता है लेकिन रास्टर फ़ाइलों की प्रतिलिपि नहीं बनाता है)।