Javascript文檔產生

Javascript文檔產生是比較頭疼的問題，不過現在已經有開源的工具可以使用——JsDoc。
其官方網站地址：http://jsdoc.sourceforge.net/
Release版的是：http://sourceforge.net/projects/jsdoc
JsDoc是根據Javascript代碼中的注釋產生相應的協助文檔，它定義了一套注釋標籤規範。因此在編寫Javascript代碼時，要根據它能識別的注釋標籤進行注釋。
具體使用方法如下：
1、如果作業系統是windows的使用者，需要配置perl環境，推薦安裝ActivePerl ，Linux/Unix使用者則不用配置了。
2、解壓縮JsDoc，在命令提示視窗中進入JsDoc所在目錄，使用如下命令即可產生Javascript代碼的文檔。
                                 perl jsdoc.pl test.js
其中test.js是用於測試的js檔案，如果成功則在該目錄下產生js_docs_out目錄，裡麵包含產生的文檔。
3、如果產生失敗，產生如下錯誤資訊：
                                 Can't locate HTML/Template.pm in @INC ......
需要配置HTML::Template模組，配置方法為：
進入perl的Package Manager，可以使用命令ppm，也可以點擊開始菜單——ActivePerl 5.8.8 Build 817——Perl Package Manager。然後使用install命令安裝HTML::Template模組，代碼如下：
                                 C:\> ppm
                                 PPM> install HTML-Template
                                 PPM> quit

具體的參數及用法可以查看JsDoc的官方網站。