[心得] phpDocumentor筆記 0 立即體驗

看板PHP作者pkwbim (多采多姿)時間18年前 (2008/01/23 01:40)推噓2(2推 0噓 0→)

留言2則, 2人參與討論串1/1

你喜歡寫文件嗎？我不喜歡。尤其是在趕工的時候，哪來的美國時間寫文件；就算有時間也是希望趕快把事情做完閃人，怎樣都輪不到寫文件的時候。文件需要嗎？雖然不喜歡寫文件，但文件真的是必要的。對自己而言，正當在趕案子兵荒馬亂的時候，突然要某個以前寫過的函式結果不知道放哪去了，這時心情會很糟很糟的去把以前的碼挖出來一份一份看，才能找出所要的函式，這樣更浪費時間。對於他人而言，要是每個人寫出來的東西都可以再讓其它人了解，並且進一步使用其它人早已寫好的元件，可以讓我們再省下時間來多喝幾杯咖啡。那要怎麼樣讓編寫文件輕鬆又自在？ phpDocumentor 就是一個現成好用的工具，只要在寫程式時順手寫上一點點的註解，困難一點的可以再加上一點點的範例。寫完後交給 phpDocumentor 編譯，一下子圖文並茂的程式文件自動就產生了。而且它還不只可以產生 HTML 檔，還可以產生出 PDF, CHM 等文件。就算產生 HTML 檔，還有許多的風格可以選擇。這樣好用的工具放著不用，實在太可惜了。我把 phpDocumentor 的心得整理了一下放在下列網址裡 http://pkwbim-programming-note.blogspot.com/2008/01/phpdocumentor-0.html http://pkwbim-programming-note.blogspot.com/2008/01/phpdocumentor-1.html 希望對大家有幫助 -- 政治是高明的騙術化妝是高明的易容術有了Photoshop就不用SK II -- ※ 發信站: 批踢踢實業坊(ptt.cc) ◆ From: 61.217.105.126