Je viens de coller un fichier javadoc généré dans un projet eclipse, pour découvrir qu'aucun code HTML n'est conforme.Pourquoi Javadoc génère-t-il du code XHTML non conforme?
Il y a même des cas de fermeture d'étiquettes qui n'ont jamais été ouvertes.
Y at-il un moyen de résoudre ce problème? Peut-être une option «être conforme» ...
Après quelques recherches, j'ai découvert XHTML Doclet 0.4.
XHTML Doclet est conforme aux normes alternative à la norme HTML Javadoc doclet. Le projet révise la structure de document pour exclure les balises obsolètes et les styles en ligne, crée un balisage XHTML valide et fournit de meilleurs hooks pour une manipulation CSS plus flexible.
On dirait que quelqu'un a fait un plugin.
De meilleures options?
Édition: Voici le Official page du plugin auquel est associé Sun's Javadoc FAQ.
Ce doclet fait xhtml beaucoup plus agréable, mais il utilise le doctype de transition, et met
La réponse courte est que JavaDocs est antérieur à XHTML.
Il y avait un fil intéressant sur le groupe Java Posse récemment à ce sujet que vous pourriez trouver intéressant: why is javadoc stuck in 1997?
Source
2008-11-06 01:20:37 dshaw