このサイトについて

「JsDoc Toolkitを使う！」は、JavaScriptドキュメンテーションツールであるJsDoc Toolkitの使い方を紹介するサイトです。JsDoc Toolkitは非常に優れたツールですが、まとまった日本語の情報が少ないようなので何となく作ってみました。
  • このサイトの内容はあくまで管理人個人の理解に基づくものです。ご利用は自己責任でお願いします。
  • 記載されている情報はバージョン 2.4.0 時点のものです。

JsDoc Toolkitとは

JsDoc Toolkit は、JavaScriptソースコードに記述されたコメントを元に、HTML形式のドキュメントを生成するオープンソースのフリーソフトウェアです。作者はMichael Mathews、ライセンスはMITライセンスです。
  • JavaScriptのドキュメント作成ツールとしては JSDoc が良く知られていますが、JsDoc ToolkitとJSDocは全く別のものです。（ちなみにMichael MathewsはJSDocの主要な開発者の一人だったようです）なおJSDocは既に開発を停止しており、JsDoc Toolkitはその後継プロジェクトとされています。

JsDoc Tooikitはそれ自身がJavaScriptで記述されており、JavaによるJavaScriptの実装である Rhino 上で動作します。従ってJsDoc Tooikitを使用するにはJavaの実行環境(JRE)が必要です。
  • JsDoc Toolkitのインストールについては、こちらを参照してください。

ドキュメント生成のためのコメント（ドックコメントと呼びます）記法はJavaDocをベースにしており、比較的容易に習得することができます。ドックコメント付きのソースコードと、そこからJsDoc Toolkitによって生成されたドキュメントのスクリーンショットを下に示します。
+  << クリックするとソースコードを展開します...
- 
  • ドックコメントの書き方については、こちらを参照してください。
  • ドキュメントの作成手順については、こちらを参照してください。

JsDoc Tooikitの特徴のひとつは、独自のテンプレートシステムによるドキュメント表示形式の柔軟性です。テンプレートはスキンのようなもので、JsDoc Tooikitのコア機能である構文解析機能から完全に独立しています。このためユーザはテンプレートを切り替えることで、JsDoc Tooikitのソースコードに手を入れることなく独自のドキュメントスタイルを利用できるようになっています。
例えば上に挙げたソースコードを管理人が作成したテンプレートaias-frameを使って出力すると、次のようになります。
- 
  • テンプレートなどによるJsDoc Toolkitのカスタマイズについては、こちらを参照してください。
  • 管理人が作成したテンプレートなどをこちらからダウンロードできます。


リンク