2012-10-24 7 views
7

मैं अपने प्रोजेक्ट के लिए जावाडोक HTML फ़ाइलों उत्पन्न करने के लिए कोशिश कर रहा हूँ। मैं उन्हें मेवेन जावाडोक प्लगइन (मेवेन-जावाडोक-प्लगइन) के माध्यम से उत्पन्न कर रहा हूं। मैं मेवेन 2.2.1 का उपयोग कर रहा हूँ। सबकुछ ऐसा उत्पन्न करता है कि सभी उचित जानकारी वहां है, लेकिन एचटीएमएल सिर्फ भयानक दिखता है। इतना बुरा है कि मैं इसे इस तरह प्रकाशित नहीं करना चाहता हूं।मेरे जेनरेट किए गए जावाडॉक्स क्यों भयानक लगते हैं?

(नोट::। हाँ, मैं देख रहा हूँ संदेश 'जावास्क्रिप्ट आपके ब्राउज़र पर अक्षम है' यहां तक ​​कि अगर मैं सक्रिय सामग्री के बारे में आईई 8 चेतावनी क्लिक करें और इसे सक्षम है, यह कोई फर्क नहीं पड़ता)

यहाँ एक स्क्रीनशॉट है

Screenshot of messed up Javadoc formatting

अनावश्यक पंक्ति विराम के सभी प्रकार के होते हैं, और बुनियादी स्वरूपण सिर्फ बकवास है। क्या मैं कुछ भूल रहा हूँ? मैं उत्पन्न Javadocs कि मैं क्या ग्रहण में देखते हैं अगर मैं एक वर्ग या विधि पर जाएँ और पॉपअप जावाडोक पैनल को देखने के लिए समान लग देखने के लिए उम्मीद कर रहा था।

मैं अपने पोम फ़ाइल में सेटिंग जोड़ने की कोशिश की है, लेकिन मैं वास्तव में नहीं जानता कि मैं क्या कर रहा हूँ जब यह जावाडोक जनरेटर को विन्यस्त करने के लिए आता है। इस समय मेरे पास क्या है (<reporting> तत्व के अंदर):

<plugin> 
    <groupId>org.apache.maven.plugins</groupId> 
    <artifactId>maven-javadoc-plugin</artifactId> 
    <version>2.9</version> 
    <configuration> 
     <javadocExecutable>C:\Java\jdk1.7.0_05\bin\javadoc.exe</javadocExecutable> 
     <javadocVersion>1.7</javadocVersion> 
     <locale>en_US</locale> 
     <show>package</show> 
     <verbose /> 
    </configuration> 
</plugin> 

कोई सुझाव?


अद्यतन:

पौलिअस द्वारा प्रदान समाधान पूरी तरह से काम किया। मैंने उपरोक्त अनुभाग को अपने <reporting> अनुभाग से हटा दिया, क्योंकि यह पूरी तरह से अनावश्यक था। मैंने नया <plugin> तत्व जोड़ा जैसा कि उसने नीचे निर्दिष्ट किया है। मेरे पोम फ़ाइल अब इस नए ब्लॉक शामिल हैं:

<build> 
    <plugins> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
      <version>2.8.1</version> 
      <executions> 
       <execution> 
        <id>attach-javadocs</id> 
        <goals> 
         <goal>jar</goal> 
        </goals> 
       </execution> 
      </executions> 
     </plugin>   
     ... 
    </plugins> 
</build> 

यहाँ की तरह तय उत्पादन दिखता है: reporting अनुभाग से maven-javadoc-plugin दूर करने के लिए

Properly generated Javadoc

+3

यह शीर्ष पर त्रुटि संदेश के कारण नहीं हो सकता है: * * "जावास्क्रिप्ट आपके ब्राउज़र पर अक्षम है"? – assylias

+0

लगता है कि वास्तव में "बेहतर" आपके ब्राउज़र में: http://docs.oracle.com/javase/7/docs/api/ – PeterMmm

+0

जावाडोक जे एस के बिना प्रस्तुत करना चाहिए सक्षम ... – PeterMmm

उत्तर

2

प्रयास करें। यदि आप मेवेन 3 का उपयोग कर रहे हैं, तो रिपोर्टिंग सेक्शन को हटा दिया गया है और हटाया जाना चाहिए।

निम्नलिखित जोड़ने के लिए प्रयास करें:

<plugin> 
    <groupId>org.apache.maven.plugins</groupId> 
    <artifactId>maven-javadoc-plugin</artifactId> 
    <version>2.8.1</version> 
    <executions> 
     <execution> 
      <id>attach-javadocs</id> 
      <goals> 
       <goal>jar</goal> 
      </goals> 
     </execution> 
    </executions> 
</plugin> 

अपने Maven plugins अनुभाग के लिए और इसे चलाते हैं। मैं इस तरह maven-javadoc-plugin का उपयोग कर रहा हूं और यह सामान्य जावाडॉक्स उत्पन्न करता है।

उम्मीद है कि इससे मदद मिलती है।

+0

क्षमा करें, यह उल्लेख किया जाना चाहिए कि मैं मेवेन 2.2.1 का उपयोग कर रहा हूं। मेरे पास मूल रूप से यह ब्लॉक नहीं था। मैंने इसे केवल इस समस्या को हल करने और ठीक करने के लिए जोड़ा है। –

+0

हाँ, यह पूरी तरह से काम किया! बहुत बहुत धन्यवाद! –

+0

आपका स्वागत है :) –