Neues Erscheinungsbild der Java SE 7 Javadoc API-Dokumentation

In meinem letzten Beitrag habe ich kurz auf den Beitrag von Jonathan Gibbons verwiesen. What's Up, JavaDoc? Hier werden einige kürzlich an Javadoc vorgenommene Änderungen beschrieben, einschließlich Änderungen, mit denen ein CSS-Stylesheet auf die Dokumentation angewendet werden kann. Mark Reinholds Beitrag JDK 7: Sind wir schon da? spricht über die Änderungen am Standardanzeigestil der Java SE 7-API. In diesem Beitrag werde ich kurz auf diese Änderung eingehen.

Die nächsten beiden Screenshots zeigen das traditionelle Standard-Erscheinungsbild der Javadoc-Dokumentation, das wir seit Jahren sehen, und zeigen dann das neue Standard-Erscheinungsbild.

Dieser Standardstil ist nicht auf die Standarddokumentation der SDK-API beschränkt. Es wird auch zum Generieren von benutzerdefiniertem Javadoc für andere Java-Anwendungen verwendet. Der nächste Screenshot zeigt, wie Javadoc über Ant mit JDK 7 Build 146 (dem Build, der das neue Styling unterstützt) aufgerufen wird. Das in diesem Fall erstellte Beispiel ist der Code aus meinem Beitrag Wie ich gelernt habe, mich nicht mehr zu sorgen und Javas ternären Operator zu lieben.

Wie aus dem Screenshot hervorgeht, habe ich nichts Besonderes getan, um das neue Styling anzuwenden. Die Ausgabe ist jedoch neu (und ich denke verbessert), wie in den nächsten Schnappschüssen gezeigt.

Das generierte Javadoc-Verzeichnis enthält eine Datei mit dem Namen stylesheet.css. Diese Textdatei kann geändert werden, um das Erscheinungsbild einfach zu ändern. Der nächste Bildschirm - Schnappschuss zeigt , wie es aussieht , wenn ich das ändern .rowColor, .altColorund die background-colorvon der body.

Ich empfehle die Farben im obigen Screenshot nicht. Sie sollen lediglich zeigen, wie einfach es ist, das Erscheinungsbild der Präsentation zu ändern.

Fazit

Ich mag das neue Standard-Styling und es kommt "out of the box" ohne neuen Aufwand ab JDK 7 Build 146. Dies ist nur eine geringfügige und weitgehend kosmetische Verbesserung, aber dennoch willkommen.

Originalbeitrag verfügbar unter //marxsoftware.blogspot.com/ (Inspiriert von tatsächlichen Ereignissen)

Diese Geschichte "Neues Erscheinungsbild der Java SE 7 Javadoc API-Dokumentation" wurde ursprünglich von JavaWorld veröffentlicht.