बहु भाषा जावा डॉक्स कैसे बनाएं?

Question

एक अंग्रेजी संस्करण और एक चीनी संस्करण के साथ एक सामान्य जावा एपीआई का जावाडॉक है, लेकिन ऐसा लगता है कि प्रत्येक संस्करण के लिए अलग-अलग स्रोत कोड होना आवश्यक है। क्या ऐसा करने का कोई और सुविधाजनक तरीका है?

Answer 1

नहीं, अनिवार्य रूप से ऐसा करने का कोई तरीका नहीं है।

दिमाग में आने वाला एकमात्र काम जेनरेट किए गए HTML पृष्ठों पर लागू होता है: आप जावा दस्तावेज़ों को ब्लॉक तत्वों से घिरा सकते हैं जो सीएसएस का उपयोग करके भाषाओं के बीच टॉगल करते हैं। पर विचार करें:

/** 
* <div class="en">Documentation in English</div> 
* <div class="nl">Documentatie in Nederlands</div> 
*/ 
public void myFunction() {} 

इसके बाद Javadocs की सीएसएस संपादित करें ताकि उपयोगकर्ता भाषाओं स्विच कर सकते हैं, उदा .:

div.en { display:none; } 
div.nl { display:block; } 

Answer 2

कम जवाब नहीं है। मौजूदा जावाडोक टिप्पणियां और उपकरण इसका समर्थन नहीं करते हैं।

मुझे नहीं लगता कि स्रोत कोड में जावाडोक टिप्पणियों के एकाधिक अनुवाद एम्बेड करने के लिए समर्थन जोड़ने का एक अच्छा विचार होगा। यह एक स्केलेबल समाधान नहीं होगा:

• जैसा कि प्रत्येक नए अनुवाद को जोड़ा जाता है, स्रोत कोड फ़ाइलें बड़ी होती हैं।
• बहुभाषी विवरण प्रबंधित करना बहुत मुश्किल होगा।

मान लें कि मैं एक एपीआई डेवलपर हूं जो चीनी नहीं पढ़ता/लिखता है। जब मैं अंग्रेजी जावाडॉक्स अपडेट करता हूं, तो मैं कैसे ध्वजांकित करता हूं कि चीनी जावाडोक टिप्पणियों को अद्यतन करने की आवश्यकता है? समस्या के बारे में हम क्या करते हैं कि संभावित रूप से बड़ी संख्या में अनुवादकों को स्रोत कोड फ़ाइलों को अद्यतन करने की आवश्यकता होती है और गलती से वास्तविक कोड में प्रतिगमन शुरू कर सकते हैं? रिलीज मैनेजर कैसे सुनिश्चित करता है कि सभी अनुवाद "सोना" रिलीज से पहले किए जाते हैं?

मुझे लगता है कि एक बेहतर (काल्पनिक) समाधान एक संशोधित जावाडोक उपकरण है जो एक संस्करण डेटाबेस में जावाडोक टिप्पणियों को निकालता है। फिर एक ऐसा टूल लिखें जो नोटिस करता है जब प्राथमिक (उदा। अंग्रेजी) जावाडॉक टिप्पणी डेटाबेस में बदलती है, और तकनीकी लेखकों/अनुवादकों को जावा, डच, आदि में जवाडोक के अनुवादों में समान परिवर्तन करने के लिए संकेत देती है।