Afficher JavaDocs sur GitHub

Je cherche un moyen de convertir les javadocs de mon projet open source (généré dans Eclipse ) en Github MarkDown , ou de trouver une autre solution simple pour afficher ma documentation sur GitHub (timide de simplement ajouter un répertoire docs). Est-il une solution simple pour cela? Puis-je simplement pointer le github README.md dans mon répertoire docs? Est-il quelque chose de plus élégant? J'ai été frappant sur Google .

28
demandé sur Phil 2013-03-12 00:18:31

2 réponses

Je ne pense pas qu'il soit possible de faire un Javadoc utilisable avec MarkDown. La meilleure solution est probablement de valider le Javadoc que vous avez généré sur la branche gh-pages (ou dans le répertoire docs/ en fonction des paramètres de votre projet). Il sera disponible à:

Http://username.github.io/projectname

Voici un exemple d'un de mes projets:

Http://ebourg.github.io/jsign/apidocs/

23
répondu Emmanuel Bourg 2017-01-18 16:17:48

Actuellement, vous pouvez également héberger votre Javadoc avec Github Pages non seulement d'une gh-pages branche, mais directement à partir de la /docs dossier au sein de votre master branche. Vous pouvez consulter la section d'aide sur ce sujet, ici (aussi vérifier image jointe ci-dessous).

entrez la description de l'image ici

En outre, il y a un projet sur Github qui cible une certaine conversion de Javadoc en Markdown (Je ne l'ai pas encore essayé, juste en laissant la référence).

18
répondu acoelhosantos 2016-10-19 10:23:54