C'è un modo per incorporare immagini nel mio JavaDoc? Fondamentalmente voglio includere alcuni diagrammi UML che spiegano la gerarchia delle mie classi in alcuni documenti.Javadoc Inserimento di diagrammi UML
Grazie!
C'è un modo per incorporare immagini nel mio JavaDoc? Fondamentalmente voglio includere alcuni diagrammi UML che spiegano la gerarchia delle mie classi in alcuni documenti.Javadoc Inserimento di diagrammi UML
Grazie!
Consultare this section della documentazione Javadoc, che spiega come incorporare le immagini nel Javadoc.
Inoltre, ecco un article che descrive come eseguire il reverse engineering dei diagrammi UML e incorporarli in Javadoc utilizzando UMLGraph.
Sì.
The documentation spiega come incorporare immagini arbitrarie nella documentazione di javadoc.
Se si desidera generare diagrammi di classi UML dalla propria origine Java, dare un'occhiata allo UMLGraph doclet.
Questo article spiega come può essere fatto posizionando le immagini in una cartella accessibile allo strumento javadoc.
ApiViz è anche un bel doclet.
This article mostra come utilizzare UMLGraph con Maven plug Javadoc.
In breve:
Installa GraphViz.
Ubuntu: apt-get install graphviz4
.
Windows: download.
Aggiornamento pom.xml.
<plugin>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.7</version>
<configuration>
<aggregate>true</aggregate>
<show>private</show>
<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
<docletArtifact>
<groupId>org.umlgraph</groupId>
<artifactId>doclet</artifactId>
<version>5.1</version>
</docletArtifact>
<additionalparam>
-inferrel -attributes -types -visibility -inferdep -quiet -hide java.* -collpackages java.util.* -qualify -postfixpackage
-nodefontsize 9
-nodefontpackagesize 7
</additionalparam>
</configuration>
</plugin>
Run mvn javadoc:javadoc
.
Chiaramente l'approccio più semplice! Dovresti aggiungere un profilo per costruirli in modo da non rompere le altre build di ppl che non hanno GraphViz nel percorso. –
Risposta semplice:
/**
* This class does some stuff (see diagram).
* <img src="relative/path/to/image.png" />
*
*/
public class SomeClass{
}
+1 Vorrei avrei chiesto io stesso! – KLE