Dokumentacja
Narzędzia
Przegląd | Przegląd |
|
|
|
Dokumentacja Joomla! obejmuje dwa różne obszary. Dokumentacja w kodzieW kodzie fukcję dokumentacyjną spełniają bloki komentarzy, wykorzystujące styl javadoc. Znaczniki javadoc są rozpoznawane i parsowane przez phpDokumentatora. Aby dowiedziec się więcej, odwiedź stronę projektu javadoc - http://java.sun.com. Celem komentarzy umieszczanych w kodzie jest objaśnienie zmiennych i funkcji zarówno dla kogoś, kto przegląda kod po raz pierwszy, jak i dla programującego, by po jakimś czasie, gdy ponownie wróci do pracy nad skryptami, nie łamał sobie głowy nad ich zrozumieniem. Podręczniki, instrukcjePodręczniki i instrukcje są pisane w formacie (www.docbook.org). DocBook to prosty, acz bogaty, standard XML przeznaczony głównie dla twórców dokumentacji technicznej. Zastosowanie formatu DocBooka usprawnia znacznie pracę, a to dzięki niezwykle łatwej konwersji dokumentów do innych formatów: .pdf, rtf, .ps czy HTML. Wymagane oprogramowanieSkrypt phpDocumentora możesz pobrać pod adresem www.phpdoc.org. Do pracy nad dokumentacją możesz używać dowolnego zwykłego edytora tekstu, np. Notatnika. Możesz również korzystać ze specjalnego edytora. Istnieje sporo zarówno komercyjnych, jak i darmowych narzędzi tego typu. My korzystamy z edytora XMLMind. To bezpłatny, stworzony w javie edytor XML, który możesz pobrać z witryny: www.xmlmind.com. XMLMind jest dostępny dla różnych platform. |
|
| Zmieniony ( 18.11.2005. ) |
| « poprzedni artykuł | następny artykuł » |
|---|






