2011-07-04 15 views
9

जब से मैंने स्कैला के साथ खेलना शुरू किया, तब से मैंने जावा एपीआई से संबंधित एक बड़ा सवाल किया है: ओरेकल same old HTML पृष्ठ को "फ्रेमसेट" टैग के साथ क्यों रखता है और कोई खोज फ़ंक्शन बिल्कुल नहीं होता है? ऐसा लगता है कि उन्होंने इसे वेब 2.0 पर नहीं बनाया है ...जावा एपीआई इंटरफ़ेस

दूसरी ओर Scala API documentation, जबकि वेब इतिहास में सबसे अच्छी वेबसाइट नहीं है, परिमाण के कई आदेश अधिक उपयोग योग्य हैं।

वैसे भी, अगर कोई जानता है कि यह क्यों है और, सबसे महत्वपूर्ण बात यह है कि यदि कोई बेहतर इंटरफ़ेस वाला जावा एपीआई दस्तावेज़ मौजूद है, तो कृपया मुझे बताएं!

+0

[जावा 7 एपीआई डॉक्स] (http://download.java.net/jdk7/docs/api/) थोड़ा अलग दिखता है ... लेकिन मैं सहमत हूं कि सुधार के लिए जगह है। –

+0

ध्यान दें कि स्कैलाडोक 2 के पहले संस्करणों के लिए मजबूत प्रतिरोध था - क्योंकि, ईमानदार होने के लिए, यह जावाडोक-जैसे स्कालाडोक से कम था। इसे उपयोग करने से पहले यह काफी कुछ पुनरावृत्तियों था, और हाल ही में इसे एक सभ्य सीएसएस मिला। –

+1

उसी प्रकार का सवाल यहां पूछा गया था: http://stackoverflow.com/questions/1026553/are-there-some-good-and-modern-alternatives-to-javadoc – paradigmatic

उत्तर

3

हाल ही में, जावा 7 के लिए, जावाडॉक में सुधार हुआ था ताकि यह कस्टम सीएसएस का उपयोग कर सके। यहां पहले परिणाम दिए गए हैं: http://download.java.net/jdk7/docs/api/। काम जारी है और मुझे लगता है कि नए अपडेट आने पर हम और अधिक देखेंगे। मैं सहमत हूं कि स्कालाडॉक बेहतर है, लेकिन उन्हें 15 साल की विरासत से निपटने की ज़रूरत नहीं थी।

enter image description here

enter image description here

+0

ठीक है, इसलिए उन्होंने सीएसएस जोड़ा, जो बहुत अच्छा है, लेकिन यह उपयोगिता में सुधार नहीं करता है, जो मेरे दृष्टिकोण से मुख्य समस्या है – seb

+0

जैसा मैंने कहा - उन्हें कुछ समय दें :) –

+0

हमेशा (कम से कम, 1.2 या इस तरह से) जावाडोक के लिए कस्टम स्टाइलशीट का उपयोग करने का एक तरीका (['-stylesheetfile' विकल्प] देखें (http://download.oracle.com/javase/6/docs/technotes/tools/solaris/javadoc.html #stylesheetfile))। हो सकता है कि अब वे HTML आउटपुट को आसान शैली के रूप में बदल दें, हालांकि। –

1

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

यदि आप javadocs को पुन: उत्पन्न करना चाहते हैं तो आप अतिरिक्त विकल्पों को उपलब्ध कराने के लिए javadoc -h चला सकते हैं। कुछ दिलचस्प लोग कस्टम हेडर/पाद लेख प्रदान करना और स्रोत से लिंक करना चाहते हैं, लेकिन आप जो प्रभाव पूछ रहे हैं उससे कुछ भी नहीं।

1

उन HTML पृष्ठों को Javadoc उपकरण, जावा में दस्तावेज़ बनाने के लिए एक मानक तरीका का उपयोग करके बनाया गया था।

मुझे नहीं पता कि एपीआई के बेहतर प्रारूपण के साथ अन्य वेबपृष्ठ हैं, लेकिन यदि यह आपको कुछ भी मदद करता है, और आप आईडीई और एसडीके का उपयोग कर रहे हैं, तो आप अधिकांश के लिए स्रोत कोड देख सकते हैं वहां फाइलें

0

JavaDoc सबसे कम आम विभाजक होने के लिए डिजाइन किया गया था। वस्तुतः कोई भी वेब ब्राउज़र इसे जावास्क्रिप्ट समर्थन के बिना भी प्रदर्शित कर सकता है।

यदि आप त्वरित पहुंच और खोज क्षमताओं की तलाश में हैं, तो आप जावाडोक को आईडीईई जैसे आईडीईसी से एक्सेस कर सकते हैं।

+1

हां, मुझे लगता है कि यह बस ** अच्छा था **।मुझे वास्तव में एक खोज फ़ंक्शन की आवश्यकता नहीं है। –

 संबंधित मुद्दे

  • कोई संबंधित समस्या नहीं^_^