Oluşturulmuş Javadocs'larım neden korkunç görünüyor?

Question

Projem için Javadoc HTML dosyalarını oluşturmaya çalışıyorum. Onları Maven Javadoc eklentisi (maven-javadoc-plugin) aracılığıyla üretiyorum. Maven 2.2.1 kullanıyorum. Her şey, tüm uygun bilgilerin orada olduğu şekilde üretiyor, ancak HTML sadece korkunç görünüyor. O kadar kötü ki, bu şekilde yayınlamak istemiyorum.

(NOT:. Evet, bunu aktif içerik hakkında IE 8 uyarıyı tıklayın ve etkinleştirmek bile, hiç fark etmez mesajı 'JavaScript tarayıcınızda devre dışı' bakınız)

İşte bir ekran görüntüsü

gereksiz satır sonları her türlü vardır ve temel biçimlendirme sadece bok. Bir şey mi eksik? Bir sınıf veya yöntem üzerinde gezindiyse ve popup Javadoc panelini görsem Eclipse'de gördüğüm şeye benzeyen oluşturulmuş Javadocs'ları görmeyi bekliyordum.

benim POM dosyasında ayarı ekleyerek denedim ama Javadoc jeneratör yapılandırılması için geldiğinde ben gerçekten ne yaptığımı bilmiyorum. İşte şu anda (<reporting> öğesinin içinde) Ben ne:

<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> 

herhangi bir öneriniz?

---

GÜNCELLEME: Paulius tarafından sağlanan çözüm mükemmel çalıştı

. Yukarıdaki bölümü tamamen gereksiz olduğu için <reporting> bölümümden kaldırdım. Aşağıda belirtildiği gibi yeni <plugin> öğesini ekledim. Benim POM dosyası artık bu yeni bloğu içerir:

<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> 

İşte

gibi sabit çıkış görünür:

Answer 1

deneyin reporting bölümünden maven-javadoc-plugin kaldırın. Maven 3'ü kullanıyorsanız, raporlama bölümü kullanımdan kaldırılır ve kaldırılmalıdır.

aşağıdaki eklemeyi deneyin:

<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> 

sizin maven plugins bölümüne ve çalıştırın. Bu gibi maven-javadoc-plugin kullanıyorum ve normal javadocs üretir.

Bu yardımcı olur umarım.