विफलताएँ (दस्तावेज़ अनुवाद)
विफलताएँ टैब केवल दस्तावेज़ अनुवाद के लिए है। यह उन विफलता रिकॉर्डों को पढ़ता है जो SQLite में लिखे गए थे जब किसी सेगमेंट का किसी स्थान के लिए सफलतापूर्वक अनुवाद नहीं किया जा सका — उदाहरण के लिए खाली या अमान्य मॉडल आउटपुट, अनुवाद के बाद के सत्यापन त्रुटियाँ (AST mismatch, प्लेसहोल्डर लीक, और इसी तरह की गुणवत्ता जाँचें), या एक घातक स्थिति जिसने प्रगति को अवरुद्ध कर दिया।
यह आपको यह उत्तर देने में मदद करता है: कौन सा स्रोत सेगमेंट टूटा, किस स्थान और मॉडल के लिए, और कौन सा त्रुटि पाठ रिकॉर्ड किया गया था?
इसका उपयोग कब करें
translate-docsयाsyncके त्रुटियों, आंशिक स्थानों, या भ्रमित करने वाले लॉग के साथ समाप्त होने के बाद — केवल टर्मिनल आउटपुट को स्क्रॉल करने के बजाय विफलताओं को सॉर्ट और फ़िल्टर करें।- जब आप पुनः कार्य को प्राथमिकता देना चाहते हैं: # विफलताएँ द्वारा सॉर्ट करें ताकि बार-बार विफल होने वाले सेगमेंट पहले दिखाई दें; वे स्रोत मार्कडाउन में सरल बनाने या पुनः स्वरूपित करने के लिए मजबूत उम्मीदवार हैं।
- जब आपको अपने रेपो में सही पैराग्राफ को संपादित करने के लिए सटीक सेगमेंट — फ़ाइलपाथ, लाइन संकेत, स्रोत हैश, और पूर्ण स्रोत पाठ — की आवश्यकता हो।
स्रोत संपादन क्यों मायने रखते हैं
घने इनलाइन मार्कअप (बोल्ड `code` के साथ मिश्रित, नेस्टेड जोर, कई स्पैन वाले लंबे वाक्य) मॉडल के लिए ऐसे अनुवाद वापस करना कठिन बनाते हैं जो अभी भी संरचनात्मक जाँचों को पास करते हैं। कई रिकॉर्ड की गई विफलताओं वाले सेगमेंट आमतौर पर अपरिवर्तित पाठ पर अनुवाद को फिर से चलाने की तुलना में स्रोत को फिर से लिखने या विभाजित करने (या उदाहरणों को फेंस किए गए कोड ब्लॉक में ले जाने) से अधिक सुधार करते हैं। यह जटिल मार्कडाउन और विफल गुणवत्ता जाँचें के साथ संरेखित है।
टैब का उपयोग कैसे करें
- डैशबोर्ड में विफलताएँ खोलें।
- सारांश पट्टी पढ़ें — किसी भी विफलता वाले सेगमेंट, साथ ही 1, 2, या 3+ विफलता रिकॉर्ड वाले सेगमेंट के लिए गणना।
- आंशिक फ़ाइलनाम, स्थान, मॉडल, गुणवत्ता त्रुटि (मान आपके कैश से आते हैं), केवल घातक, और वैकल्पिक स्रोत हैश, स्रोत पाठ, या त्रुटि संदेश सबस्ट्रिंग द्वारा फ़िल्टर करें — फिर लागू करें पर क्लिक करें।
- सॉर्ट करें: # विफलताएँ (डिफ़ॉल्ट) या सॉर्ट करें: फ़ाइलपाथ + लाइन # चुनें।
- तालिका के ऊपर या नीचे पेजिंग का उपयोग करें। पूर्ण स्रोत पाठ का विस्तार करने के लिए एक पंक्ति पर क्लिक करें। मॉडल कॉलम विफलता मॉडल और, जब उपलब्ध हो, बाद की सफल कैश प्रविष्टि से मॉडल दिखाता है।
- 🔗 लिंक नियंत्रण फ़ाइल/लाइन संकेत टर्मिनल पर लॉग करता है जहाँ
ai-i18n-tools dashboardचल रहा है। - एक पंक्ति जिसकी त्रुटि
Glossary label missingहै, उसमें स्किप जोड़ें होता है। वह पद, लोकेल और फ़ाइल के लिए एकglossary.labelCheckSkipsप्रविष्टि लिखता है। जब रन ने इसे संग्रहीत किया हो तो अस्वीकृत अनुवाद पढ़ने के लिए विस्तारित पंक्ति खोलें। - अपनी परियोजना में स्रोत फ़ाइल को ठीक करें, फिर से
translate-docsयाsyncचलाएँ। यदि सफल रन के बाद सूची पुरानी दिखती है, तोai-i18n-tools sync --force-updateचलाएँ और डैशबोर्ड को फिर से लोड करें। एक शब्दावली-लेबल चेतावनी रन को नहीं रोकती है; उन कैश किए गए खंडों को--recheck-glossary-warningsके साथ फिर से जाँचें।
UI के साथ फ़ाइल-आधारित डीबगिंग के लिए, प्रत्येक छोड़े गए मॉडल प्रयास (प्रॉम्प्ट, कच्चा आउटपुट, सत्यापन त्रुटि) के लिए cacheDir के तहत एक FAILED-TRANSLATION फ़ाइल लिखने के लिए --debug-failed को translate-docs, translate-ui, translate-json, translate-svg, या sync पर पास करें, जिसमें स्क्रिप्ट-फ़ॉलबैक चेतावनियाँ शामिल हैं — न केवल तब जब हर मॉडल विफल हो जाता है। कैश व्यवहार और translate-docs फ़्लैग देखें।
विफलताएँ बनाम मार्कडाउन समस्याएँ
| विफलताएँ | मार्कडाउन समस्याएँ | |
|---|---|---|
| कब रिकॉर्ड किया गया | अनुवाद के दौरान (प्रति स्थान) | अनुवाद से पहले (स्रोत स्कैन) |
| विशिष्ट कारण | खराब मॉडल आउटपुट, सत्यापन त्रुटियाँ | अयुग्मित जोर, अनक्लोज्ड कोड स्पैन, लिंक के बाहर बोल्ड |
| ठीक करें | स्रोत संपादित करें और पुनः अनुवाद करें | स्रोत मार्कडाउन को ठीक करें, फिर पुनः अनुवाद करें |
पूर्व-अनुवाद स्थिर जाँचों के लिए मार्कडाउन समस्याएँ देखें।