「[javascript] javascriptのjavadocみたいのをつくる」の編集履歴(バックアップ)一覧に戻る

[javascript] javascriptのjavadocみたいのをつくる - (2007/04/13 (金) 15:48:58) のソース

(Windows環境で。)

以下をインストール

-JSDoc
http://jsdoc.sourceforge.net/
javascriptのjavadocみたいの作成ツール。
解凍して、適当な場所に置く。

-ActivePerl
http://jsdoc.sourceforge.net/
JSDocを動かすときにperlが必要。
PPMも一緒にインストールしてくれる。

Windowsを再起動して、WindowsのPATHに
perlが通っていることを確認。

コマンドプロンプトを起動。

JSDocを配置したフォルダに移動し、以下のコマンドを実行。
 perl jsdoc.pl test.js

もし
 Can't locate HTML/Template.pm in @INC ......
というメッセージが出てエラーになったら、コマンドプロンプトで
ppmを実行する。
 C:\>ppm

PPMのコンソールが起動する。

ツールバーの一番左の「View All Packages」をクリック。

パッケージ一覧の中から「HTML-Template」を選択。

ツールバーの中から「Mark for install」をクリック。

ツールバーの中から「Run marked actions」をクリック。

#ref(ppm.gif)

HTML-Templateがインストールされる。

コンソールを閉じる。

再度実行。
 C:\home\hoge\JSDoc-1.10.2>perl jsdoc.pl test.js
 
(ログ)
 Loading sources from test.js
 Completed generating documentation

完了のログが表示されたら、同じフォルダにjs_docs_outが作成される。
その中のindex.htmlを実行するとjavadocのような画面が表示される。