JavaScript 4©2ch.net (398ﾚｽ)
上下前次1-新
抽出解除 必死ﾁｪｯｶｰ(本家) (べ) 自ID ﾚｽ栞 あぼーん
ﾘﾛｰﾄﾞ規制です｡10分ほどで解除するので､他のﾌﾞﾗｳｻﾞへ避難してください｡
235(1): デフォルトの名無しさん [sage] 2015/07/02(木)17:04 ID:p+4VzYpK(1/5)
他人が作ったコードをメンテすることになってJSDocアノテーションされてたので
ドキュメント化しようという話になった
開発時にはがJSDoc Toolkit（https://code.google.com/p/jsdoc-toolkit/）を使っていたようなのだが
それはすでにサポート終了してテンプレートも消えていた
それでJSDoc3（https://github.com/jsdoc3/jsdoc）を試しているのだがデフォルトのテンプレートが
どうにも満足のいかないものだったので、テンプレートをいくつか探して試した
なかには not found のエラーを出すものがあり、そろそろ疑問に感じてきた
それで JSDoc を jsdoc -T としてテスト実行してみたところ大量の not found
えっ？ テストしてないでリリースしてるの？ それともこちらの環境の問題？
ちなみに Windows 7 環境で同梱のバッチで実行してるのだけれども
java 上で動くのだからその辺は一緒のはず？
javaランタイムのバージョン？
もし Windows 上で JSDoc3 を使っている方がいたら
安定して動作している環境を教えてほしい
239(1): デフォルトの名無しさん [sage] 2015/07/02(木)17:18 ID:p+4VzYpK(2/5)
同じ手順を Windows 上の Git Bash にて行ってみた
$ git clone https://github.com/jsdoc3/jsdoc
Cloning into 'jsdoc'...
remote: Counting objects: 16429, done.
remote: Total 16429 (delta 0), reused 0 (delta 0), pack-reused 16429
Receiving objects: 100% (16429/16429), 16.16 MiB | 1.17 MiB/s, done.
Resolving deltas: 100% (8177/8177), done.
Checking connectivity... done.
Checking out files: 100% (620/620), done.
$ cd jsdoc/
$ ./jsdoc -T
js: exception from uncaught JavaScript throw: Error: Module "c:/Users/xxxxxx/Documents/GitHub/jsdoc/jsdoc.js" not found.
うわーん
240: デフォルトの名無しさん [sage] 2015/07/02(木)17:20 ID:p+4VzYpK(3/5)
$ java -version
java version "1.8.0_45"
Java(TM) SE Runtime Environment (build 1.8.0_45-b15)
Java HotSpot(TM) Client VM (build 25.45-b02, mixed mode)
です
242: デフォルトの名無しさん [sage] 2015/07/02(木)17:34 ID:p+4VzYpK(4/5)
やっぱ Linux環境を用意しないとダメなんかなあ
ただテストではエラー出るけど実際に使ってみた際にはエラーは出ないんだよなあ
テンプレートはデフォルトと
https://github.com/Nijikokun/minami
https://github.com/davidshimjs/jaguarjs-jsdoc
はエラー無しで通った
https://github.com/bvalosek/jsdoc3-bootstrap
https://github.com/terryweiss/docstrap
https://github.com/DBCDK/jsdoc3Template
はダメだった
244: デフォルトの名無しさん [sage] 2015/07/02(木)18:58 ID:p+4VzYpK(5/5)
あとでちゃんと JDK 入れてみるか
上下前次1-新書関写板覧索設栞歴
ｽﾚ情報 赤ﾚｽ抽出 画像ﾚｽ抽出 歴の未読ｽﾚ AAｻﾑﾈｲﾙ
ぬこの手 ぬこTOP 0.031s