Почему Javadoc генерирует несовместимый XHTML?
Прежде всего, его словарь, а не список, вы можете получить доступ к элементам из списка путем индексации, а в словаре это невозможно, вы можете получить доступ к элементам с помощью клавиши
contacts = {
"John" : 938477566,
"Jack" : 938377264,
"Jill" : 947662781
}
for k,v in contacts.items():
print(k,v)
или контактов [ «Джон»] вы можете получить доступ к значению
2 ответа
После некоторого поиска с помощью Google я обнаружил XHTML Doclet 0.4.
XHTML Doclet является совместимой стандартами альтернативой стандарту Javadoc HTML doclet. Проект пересматривает структуру документа для исключения устаревших тегов и встроенных стилей, создает допустимую разметку XHTML и обеспечивает лучшие рычаги для более гибкого управления CSS.
Похож на кого-то, сделал плагин.
Какие-либо более оптимальные варианты?
Править: Вот страница Official плагина, как связано с FAQ Sun Javadoc.
Короткий ответ - то, что JavaDocs предшествуют XHTML.
Был интересный поток на группе Отряда Java об этом недавно, что Вы могли бы найти интересным: почему javadoc застревает в 1997?