Comment pouvons-nous générer Javadoc en tant que document Word au lieu des pages HTML traditionnelles?
4 Réponses :
regarder dans les doclets, http://doclet.com qui possède de nombreux exemples de rendu Javadoc personnalisé (c'est-à-dire dans PDF's, etc.) et consultez également Apache POI ( http://poi.apache.org/ ) Pour la génération de fichiers Office MS
Si vous pouviez vivre avec pdf au lieu de mot, vous devriez donner pdfdoclet une chance. Je l'ai découvert sur Doclet.com (grâce à la marque pour le lien). Cela fonctionne assez bien, est une utilisation facile et permet une configuration. Pour mon but, PDF est mieux adapté que Word car un document PDF est mieux adapté à la lecture qu'un mot concernant l'application visualiseur nécessaire.
Voici mon petit fichier de lots Windows: P>
echo OFF set JAVA_HOME=C:/program files/Java/jdk1.6.0_23 set PATH=%JAVA_HOME%/bin;%PATH% set VERSION=1.0.2 set DOCLET=com.tarsec.javadoc.pdfdoclet.PDFDoclet set JARS=jar/pdfdoclet-%VERSION%-all.jar set PACKAGE="cvu.html" javadoc -doclet %DOCLET% -docletpath %JARS% -pdf html.pdf -config example/html/config_html.properties -private -sourcepath example/html -subpackges %PACKAGE%
Eh bien, oui sûrement. Mon point est: choisissez le bon outil pour le travail. Pour PDF, il existe plusieurs petits lecteurs relativement insuffisants pendant que Word exige un éditeur plutôt gonflé juste pour la lecture d'un document Javadoc. Je mettrai à jour ma réponse pour effacer ma pensée.
Votre fichier de lot a une faute de frappe sur le paramètre -Subbackages
Merci, pdfdoclet fait très bien le travail et facile à lauch dans le projet Eclipse> génère Javadoc. Si nécessaire, le fichier PDF de sortie peut toujours être converti en mot, I Utilisez Personnaly TOUS PDF Converter Pro, cela fonctionne comme un charme.
http://doclet.com/ liens Un doculet RTF ("DOCUT RTF génère une documentation au format RTF".) Le RTF résultant s'ouvre dans Word et Work Office Writer.
Vous pouvez utiliser Maven pour exécuter le pdfdoclet . Bien que je ne trouvais pas de référentiel de Maven "officiel", ce qui suit me semble plus clair, opposé à la violation de scripts shell ou d'utiliser des commandes de fourmis dans Maven comme proposé sur leur site web : Notez la désactivation des options standard, sinon Javadoc se plaint d'options inconnues (apparemment non pris en charge par le PDFDoclet) à partir de là, vous pouvez commencer à personnaliser, en utilisant le toujours concis documentation Maven