Почему Javadoc генерирует несовместимый XHTML? - PullRequest
Новая
       18

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

5 голосов
/ 06 ноября 2008

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

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

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

Ответы [ 2 ]

7 голосов
/ 06 ноября 2008

После некоторого поиска, я обнаружил XHTML Доклет 0,4 .

XHTML Doclet соответствует стандартам альтернатива стандарту Javadoc HTML доклет. Проект пересматривает структура документа для исключения устаревшего теги и встроенные стили, создает действительные Разметка XHTML и обеспечивает лучшее крючки для более гибкого CSS манипуляции.

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

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

Редактировать: Вот плагин Официальная страница , на которую ссылается FAQ по Javadoc от Sun .

4 голосов
/ 06 ноября 2008

Краткий ответ: JavaDocs предшествует XHTML.

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

...