小蛙之前寫 Java 居多,Java 裡面有一個 Javadoc 可以把開發者依照固定好的格式填寫的程式註解整理成一份完整的 HTML 文件,讓其他開發者可以很方便的查詢 API。例如:舊版 Javadoc新版 Javadoc這裡有編寫 Javadoc 的一些規則跟說明。前陣子要把寫好的 PHP 整理成類似 Javadoc 這種文件,雖然網路上找到像 phpDocumentor、PHPDoc … 等工具,但覺得不是那麼樣好看(小蛙個人喜好問題,看習慣 Javadoc 了),這篇文章很簡單地介紹 Doxygen 這套功能強大、設定也挺複雜的文件產生工具。

繼續閱讀 »

© 2012 蛙齋 Suffusion theme by Sayontan Sinha