Salesforce.com दस्तावेज शीर्षलेख फाइल

Question

क्योंकि Salesforce.com शीर्ष भाषा "जावा जैसी" है, इसलिए मैं ऐप एक्सचेंज पर रिलीज़ करने की योजना के लिए एपीआई दस्तावेज जेनरेट करने के लिए जावाडोक या डॉक्सिजन का उपयोग करना चाहता हूं।

मुझे Google Code पर ApexDoc प्रोजेक्ट मिला, लेकिन यह गंभीर रूप से सीमित है और HTML आउटपुट उत्पन्न करने के लिए एक निष्क्रिय पार्सर का उपयोग करता है। मैं स्क्रैच से उस पहिया को फिर से शुरू करने की कोशिश करने के बजाय मौजूदा डोक्सिजन पार्सर्स और आउटपुट जेनरेटर का अधिक फायदा उठाऊंगा।

तो, मेरे सवालों का:

1) किसी को भी जावाडोक या Doxygen उपयोग करने के लिए उनके एपेक्स कक्षाओं के लिए API दस्तावेज़ उत्पन्न करने में सक्षम हो गया है? आप इसे कैसे करने में सक्षम थे?

2) मुझे आश्चर्य है कि .cls एपेक्स क्लास फाइलों से .java फ़ाइलों की एक श्रृंखला बनाने के लिए एक साधारण स्क्रिप्ट लिखना कितना मुश्किल होगा, नकली import कथन जोड़ना और संभवतः डॉक्सीजन को खुश रखने के लिए कुछ घोषणाओं को संशोधित करना। जब कोई एपेक्स .cls फ़ाइल को पार्स करने का प्रयास करता है तो क्या डॉक्सिजन (या जावाडोक) पर कोई विचार हो रहा है?

मुझे आश्चर्य है कि सेल्सफोर्स ऐसे उपकरण प्रदान नहीं करता है या जैवडोक/डॉक्सीजन में एपेक्स पार्सर का योगदान नहीं दिया है। उनके दस्तावेज और डेवलपर उपकरण व्यापक हैं, और उनके पास एक महान स्वचालित परीक्षण सेटअप है। ऑटो जनरेटिंग कक्षाओं के लिए मुझे उनसे कुछ भी नहीं मिला है।

संपादित करें: Salesforce Stack Exchange पर updated version of this question देखें।

Answer 1

मैंने एपेक्सडॉक पर आधारित एक टूल लिखा है। JAR फ़ाइल और गिटहब प्रोजेक्ट के लिंक के साथ, एक संक्षिप्त लेखन here है। यदि आपको समस्याएं मिलती हैं तो कृपया मुझे अपने ब्लॉग पर एक टिप्पणी छोड़ दें।