Cześć!
Mam znów pytanie - jak zmienić wygląd html'i generowanych przez javadoc ?
Nie chodzi mi o kolorki, bardziej chciałbym mieć mniej "rozlazłe" wyjście, np. dokładne opisy metod chciałbym zamieścić bezpośrednio w tabelce, a nie pod spodem ...
Da się coś takiego osiągnąć w prosty sposób na czystym javadocu lub przy użyciu darmowego narzędzia ?
Zaglądałeś tu http://java.sun.com/j2se/javadoc/index.jsp ?
bogdans napisał(a)
Zaglądałeś tu http://java.sun.com/j2se/javadoc/index.jsp ?
Tak, przejrzałem dość pobieżnie.
Na pierwszy rzut oka widać sporo instrukcji jak zmienić kolorek lub dodać jakiś duperelek, ale trudno mi było znaleźć łatwy sposób na zmianę układu. Doclet'y nie-sunowskie też wyglądają dość podobnie ...
Za bardzo nie chce mi się głęboko wnikać, bo jeśli sprawa jest skomplikowana, to lepiej mi ręcznie się pobawić, niż tracić kilka dni na grzebanie we flakach javadoc'a.
Ale pomyślałem, że może kiedyś ktoś coś podobnego robił i może przez przypadek mi podpowie. ;)
modyfikacja standardowego docletu.
http://java.sun.com/j2se/javadoc/faq/index.html#sourcedoclet
Ponad to warto pogrzebać w kodzie źródłowym docletów i dostosować go do swoich potrzeb.
Tak jak mówię, wolę sobie ręcznie tabelkę w OO zrobić i kilkanaście razy klepnąć ctrl-c + ctrl-v, niż grzebać w źródłach ;)
Bardzo fajnie wygląda Deluxe Doclet => http://www.ida.liu.se/~eribe/deluxe/sample/index.html
Opis metod i pól jest rozwijalny, czyli generowany jest html wsparty javascriptem.
Niestety, nie potrafię tego u siebie odpalić, są chyba jakieś poważne niezgodności z nowym javadoc'iem, rzuca wyjątek, że nie może znaleźć klas znajdujących się w tools.jar z jdk\lib. Nic dziwnego, bo tych klas tam rzeczywiście nie ma ...