समस्या निवारण
अनुवादित दस्तावेज़ों में अनुभाग एंकर लिंक काम नहीं करते हैं
[label](other.md#section-id) जैसा लिंक सही अनुवादित फ़ाइल खोल सकता है लेकिन इच्छित शीर्षक तक स्क्रॉल करने में विफल रहता है — या गलत अनुभाग पर कूद जाता है। #… खंड अब उस स्थान में किसी भी शीर्षक id से मेल नहीं खाता है।
सामान्य कारण:
- स्रोत शीर्षकों में कभी भी स्पष्ट एंकर आईडी नहीं थे; साइट दृश्यमान शीर्षक पाठ से स्लग प्राप्त करती है, जो अनुवाद के बाद बदल जाता है।
- आपने स्रोत में एक शीर्षक का नाम बदला है लेकिन पहले की
<a id="…"></a>पंक्ति गायब है या अभी भी पुरानी आईडी है। - एंकर लिंक अंग्रेजी शब्दों से अनुमानित
#…खंड का उपयोग करते हैं, न कि आईडीwrite-heading-idsउत्पन्न करेगा।
ठीक करें
- अपने स्रोत
ai-i18n-tools write-heading-idsपर.md/.mdx(समानdocs[]/contentPathsजैसेtranslate-docs) चलाएं। डिफ़ॉल्ट रूप से, यह प्रत्येक एटीएक्स हेडिंग से पहले<a id="slug"></a>डालता है, या जब हेडिंग पाठ वर्तमान स्लग से मेल नहीं खाता है तो एक मौजूदा एंकर को ताज़ा करता है। Docusaurus MDX कमेंट आईडी के लिए,--slug-style mdx-commentका उपयोग करें। - एंकर लिंक्स को उन आईडी पर निर्देशित करें — उदाहरण के लिए
[setup](guide.md#first-run)जहां#first-runलक्ष्य हेडिंग के ऊपर एंकर लाइन से मेल खाता है, केवल अंग्रेजी शीर्षक से अनुमानित स्लग नहीं। translate-docs(याsync --force-update) को पुनः चलाएं ताकि हर स्थानीयकृत प्रति में अद्यतन एंकर लाइनें शामिल हों।
परिवर्तनों का पूर्वावलोकन करने के लिए पहले write-heading-ids पर --dry-run का उपयोग करें। पूर्ण पैटर्न के लिए एंकर लिंक देखें।
अनुवादित दस्तावेज़ों में छवि या संपत्ति लिंक 404
एक मार्कडाउन लिंक या  अंग्रेजी में काम करता है लेकिन अनुवादित प्रतियों में 404 लौटाता है — अक्सर क्योंकि URL अभी भी स्रोत-स्थान फ़ोल्डर या केवल-अंग्रेजी स्थिर पथ पर इंगित करता है।
ठीक करें
- पुष्टि करें कि आपकी संपत्ति लेआउट आपके
docsOutput.style(फ्लैट बनाम डॉक-सिस्टम) से मेल खाता है। लिंक पुनर्लेखन और छवियाँ और स्क्रीनशॉट देखें। - स्थान खंडों को स्वैप करने या पूर्ण
/img/…पथों को जोड़ने के लिएdocsOutput.postProcessing.regexAdjustmentsजोड़ें या समायोजित करें। फ्लैट लेआउट के लिए, याद रखें कि फ्लैट लिंक रीराइटरregexAdjustmentsसे पहले चलता है — पहले से उपसर्गित URL के विरुद्ध पैटर्न का मिलान करें। - सुनिश्चित करें कि स्थान-विशिष्ट संपत्ति फ़ाइलें उन पथों पर मौजूद हैं जिन्हें पुनर्लिखित मार्कडाउन संदर्भित करता है (
translate-docsURL को फिर से लिखता है लेकिन रास्टर फ़ाइलों की प्रतिलिपि नहीं बनाता है)।
हिंदी, अरबी, CJK, या सिरिलिक आउटपुट रोमन अक्षरों में है (लैटिन अक्षरों में)
कुछ मॉडल अर्थ का अनुवाद करते हैं लेकिन परिणाम लैटिन/रोमन अक्षरों में लिखते हैं (उदाहरण के लिए हिंदी को नमस्ते के बजाय Namaste के रूप में)। केवल hi का अर्थ देवनागरी है; hi-Latn का उपयोग तभी करें जब आप रोमनकृत हिंदी चाहते हों।
ठीक करें
- पुष्टि करें कि लोकेल कोड आपकी चाही गई स्क्रिप्ट से मेल खाता है (
hiबनामhi-Latn,zh-Hansबनामzh-Hant,srबनामsr-Latn)। - अनुवाद को फिर से चलाएँ ताकि गलत-स्क्रिप्ट वाली कैश पंक्तियों को अस्वीकार कर दिया जाए: UI स्ट्रिंग्स के लिए
translate-ui --force, याtranslate-docs --check-cache/sync --check-cache(फ़ाइल-स्तर का स्किप केवल अपेक्षित स्क्रिप्ट वाले लोकेल के लिए बायपास किया जाता है; मान्य सेगमेंट कैश का अभी भी पुनः उपयोग किया जाता है)।--force-updateहर लोकेल को फिर से प्रोसेस करता है। - अगर कोई मॉडल बार-बार स्क्रिप्ट जाँच में विफल रहता है, तो उस लोकेल के लिए एक
localeModelsप्रविष्टि जोड़ें ताकि पहले एक मज़बूत मॉडल को आज़माया जाए — AI मॉडल देखें।