Właśnie wkleiłem niektóre wygenerowane javadoc do projektu zaćmienia, aby odkryć, że żaden z HTML nie jest zgodny.Dlaczego Javadoc generuje niezgodny z XHTML?
Istnieją nawet przypadki zamykania znaczników, które nigdy nie zostały otwarte.
Czy jest jakiś sposób, aby to naprawić? Być może opcja "bądź zgodna" ...
Po pewnym przeszukaniu go, odkryłem XHTML Doclet 0.4.
XHTML doclet jest zgodnych ze standardami alternatywą dla standardowego Javadoc HTML doclet. Projekt zmienia strukturę dokumentu , aby wykluczyć nieaktualne znaczniki i style śródliniowe, tworzy poprawne oznaczenia XHTML i zapewnia lepsze haki dla bardziej elastycznej manipulacji CSS .
Wygląda na to, że ktoś zrobił wtyczkę.
Jakieś lepsze opcje?
Edit: Oto pluginu Official page jako związana przez Sun's Javadoc FAQ.
To doclet o wiele ładniejszy xhtml, ale korzysta z doctype przejściowym i stawia
Krótka odpowiedź brzmi, że JavaDocs wcześniej XHTML.
Był ciekawy wątek na grupie Java Posse o tym niedawno, że można znaleźć ciekawe: why is javadoc stuck in 1997?
Źródło
2008-11-06 01:20:37 dshaw