[skrypt] Lekkie narzędzie do tworzenia dokumentacji API, Czyli wynik moich zabaw z ReflectionAPI :) Opcje

[Fipaj]

phpDocumentor jest strasznie duży i ciężko nad nim zapanować, chociaż przyznaję: nic lepszego dla PHP nie ma. Mogę tylko pozazdrościć Javie oraz Ruby (RDoc jest cudowny)...

Ale od czasu do czasu muszę sobie wydrukować takie diagramy klas i pooglądać je, trzymając w ręku - to chociażby jeden powód, żeby zasiąść do tworzenia Stone'a. A tak poza tym to wreszcie chciałem wypróbować "to wspaniałe ReflectionAPI"... ;-)

Nie mówię, że projekt końcowy jest specjalnie dobry. Otóż nie jest dobry wcale - robiłem to dość szybko, tak więc możliwości są jeszcze dość małe (nie parsuje komentarzy DocBlock, a łatwo to dorobić, bo jest w ReflectionAPI specjalna do tego funkcja...), output brzydki (tzn. nie tyle brzydki, co niepoukładany) a kod okropny (kompletne przemieszanie XHTML z PHP, od dawna czegoś takiego nie napisałem, przepraszam ).

Mimo wszystko (ale się poznęcałem ;]) zachęcam do wypróbowania.

Wygenerowana dokumentacja dla bazowej klasy Zend Frameworka: http://surfingdaily.pl/tests/stone/zend.html

Klasa PHP: http://surfingdaily.pl/tests/stone/Stone.phps
Kod CSS: http://surfingdaily.pl/tests/stone/style.css
Kod JS: http://surfingdaily.pl/tests/stone/jquery.js

A nuż widelec komuś się przyda.

Ten post edytował Fipaj 15.03.2007, 17:38:33