कोड टिप्पणियाँ और दस्तावेज़ स्ट्रिंग्स (Docstrings): केवल टिप्पणियों का अनुवाद कैसे करें, कोड को बिना बदले?
“यदि आप सीधे सोर्स कोड फ़ाइल को अनुवादक में डालते हैं, तो अक्सर वेरिएबल नाम और लॉजिक कीवर्ड (if/for) भी अनुवाद हो जाते हैं, जिससे कोड निष्क्रिय हो जाता है।”
मूल कारण विश्लेषण
AST (अमूर्त सिंटैक्स ट्री) स्तर की पहचान
商译 AI केवल रेगुलर एक्सप्रेशन पर निर्भर नहीं है, बल्कि यह हल्का सिंटैक्स विश्लेषण भी कर सकता है।Python के लिए, यह `'''...'''` में प्रस्तुत Docstrings की सटीक पहचान कर सकता है।Java/JS के लिए, यह `/**...*/` ब्लॉक को पहचान सकता है।
निर्देश संरक्षित
टिप्पणी ब्लॉक के भीतर, `@param`, `@return`, `@author` जैसी विशिष्ट निर्देशों के लिए, सिस्टम निर्देश शीर्षक को यथावत रखते हुए उसके बाद की वर्णनात्मक सामग्री का अनुवाद करता है, ताकि API दस्तावेज़ (जैसे Javadoc, Sphinx) बनाते समय फ़ॉर्मेट सही बना रहे।
अंतिम समाधान सारांश
ओपन-सोर्स प्रोजेक्ट्स को बहुभाषीय दस्तावेज़ जल्दी बनाने में मदद करता है, जिससे वैश्विक डेवलपर्स के लिए योगदान की बाधाएँ कम होती हैं।