Почему Javadoc генерирует несовместимый XHTML?

Я просто вставил сгенерированный javadoc в проект eclipse, чтобы обнаружить, что ни один из HTML не соответствует требованиям.

Бывают даже случаи закрытия тегов, которые никогда не открывались.

Есть ли способ исправить это? Может быть, вариант «быть послушным» ...

java javadoc xhtml

06.11.2008 02:28

Пользовательский скаляр GraphQL

Листовые узлы системы типов GraphQL называются скалярами. Достигнув скалярного типа, невозможно спуститься дальше по иерархии типов. Скалярный тип...

Как вычислять биты и понимать побитовые операторы в Java - объяснение с примерами

В компьютерном программировании биты играют важнейшую роль в представлении и манипулировании данными на двоичном уровне. Побитовые операции...

Поднятие тревоги для долго выполняющихся методов в Spring Boot

Приходилось ли вам сталкиваться с требованиями, в которых вас могли попросить поднять тревогу или выдать ошибку, когда метод Java занимает больше...

Принятие принципов SOLID в Spring Boot: Создание обслуживаемых и масштабируемых приложений

Коллекции (ArrayList , HashSet , HashMap)

Полный курс Java для разработчиков веб-сайтов и приложений

Получите сертификат Java Web и Application Developer, используя наш курс.

860

Перейти к ответу Данный вопрос помечен как решенный

Ответы 2

Ответ принят как подходящий

После некоторого поиска в Google я обнаружил Документ XHTML 0.4.

XHTML Doclet is a standards-compliant alternative to the Javadoc standard HTML doclet. The project revises the document structure to exclude outdated tags and inline styles, creates valid XHTML markup, and provides better hooks for more flexible CSS manipulation.

Похоже, кто-то сделал плагин.

Есть варианты лучше?

Редактировать: Вот Официальная страница плагина, на который ссылается Часто задаваемые вопросы о Sun Javadoc.

Этот doclet сделал xhtml намного лучше, но он использует Transitional doctype и помещает теги <script> в <body>, так что есть целый ряд предупреждений.

— 09.11.2008 12:35

06.11.2008 02:32

Короткий ответ заключается в том, что JavaDocs предшествуют XHTML.

Недавно в группе Java Posse была интересная тема, которая может вас заинтересовать: почему javadoc застрял в 1997 году?

06.11.2008 04:20