Acabo de pegar algunos javadoc generados en un proyecto eclipse, para descubrir que ninguno de los HTML es compatible.¿Por qué Javadoc genera XHTML no conforme?
Incluso hay casos de etiquetas de cierre que nunca se abrieron.
¿Hay alguna manera de arreglar esto? Tal vez una opción de "ser obediente" ...
Después de buscar en Google, descubrí XHTML Doclet 0.4.
XHTML Doclet es una compatible con los estándares alternativa al estándar HTML Javadoc doclet. El proyecto revisa la estructura de documento para excluir las etiquetas obsoletas y los estilos en línea, crea una marca XHTML válida y proporciona mejores ganchos para una manipulación CSS más flexible .
Parece que alguien hizo un plugin.
¿Alguna mejor opción?
Editar: Aquí es de Official page el plugin como vinculado a por Sun's Javadoc FAQ.
Eso Doclet hizo XHTML mucho más agradable, sino que utiliza el tipo de documento de Transición, y pone
La respuesta corta es que los JavaDocs son anteriores a XHTML.
Se ha producido un interesante hilo en el grupo de Java Posse sobre esto recientemente que le puede resultar interesante: why is javadoc stuck in 1997?
Fuente
2008-11-06 01:20:37 dshaw