Tôi đang cố tạo các tệp HTML Javadoc cho dự án của mình. Tôi đang tạo chúng thông qua plugin Maven Javadoc (plugin maven-javadoc). Tôi đang sử dụng Maven 2.2.1. Tất cả mọi thứ tạo ra như vậy mà tất cả các thông tin thích hợp là có, nhưng HTML trông chỉ khủng khiếp. Tệ đến mức tôi không muốn xuất bản nó theo cách đó. Đây là một ảnh chụp màn hình:Tại sao Javadocs được tạo của tôi trông khủng khiếp?
(LƯU Ý:. Vâng, tôi thấy 'JavaScript bị vô hiệu hóa trên trình duyệt của bạn' nhắn Thậm chí nếu tôi nhấp vào cảnh báo IE 8 về nội dung hoạt động và kích hoạt nó, nó làm cho không có sự khác biệt)
Có tất cả các loại ngắt dòng không cần thiết và định dạng cơ bản chỉ là crap. Tui bỏ lỡ điều gì vậy? Tôi đã mong đợi để xem Javadocs được tạo ra trông giống như những gì tôi thấy trong Eclipse nếu tôi di chuột qua một lớp hoặc phương thức và xem bảng điều khiển Javadoc bật lên.
Tôi đã thử thêm cài đặt trong tệp POM của mình, nhưng tôi thực sự không biết mình đang làm gì khi cấu hình trình tạo Javadoc. Dưới đây là những gì tôi có vào lúc này (bên trong phần tử <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>
Bất kỳ đề xuất nào?
UPDATE:
Giải pháp được cung cấp bởi Paulius làm việc một cách hoàn hảo. Tôi đã xóa phần ở trên khỏi phần <reporting>
của mình, vì nó hoàn toàn không cần thiết. Tôi đã thêm phần tử <plugin>
mới như được chỉ định bên dưới. tập tin POM của tôi bây giờ chứa khối mới này:
<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>
Dưới đây là những gì mà sản lượng cố định hình như:
Có thể không phải do thông báo lỗi ở trên cùng: * "Javascript bị tắt trên trình duyệt của bạn" *? – assylias
Có vẻ thực sự "tốt hơn" trong trình duyệt của bạn: http://docs.oracle.com/javase/7/docs/api/ – PeterMmm
Javadoc sẽ hiển thị mà không cần bật JS ... – PeterMmm