1

プロジェクトに jsdoc3 を使用していますが、すべてがうまくコンパイルされます。

しかし、これは私が過去2日間いじっていて、あきらめました:(

MacOsX ターミナルからの最も基本的な呼び出しを使用して jsdoc を実行すると、生成されたドキュメント内のソース ファイルのフル パスが常に取得されます。

例：

./jsdoc ../projectname/js/jsfile.js

生成されたインデックス ファイルでは、"index" を含む h1 と、その下に js ファイルへのフル パスを含む h2 が表示されます。

/Users/username/projects/path/projectname/js/jsfile.js

完全なローカルパスが表示されるのが好きではありません...
読んだ後、jsdocを実行した場所に関連すると思いました。
しかし、これはすべてまったく同じ結果になります。

cd /Users/username/projects/path/projectname
../jsdoc-master/jsdoc js/jsfile.js

としても

cd /Users/username/projects/path/projectname/js
../../jsdoc-master/jsdoc jsfile.js

問題は、このパスが行番号参照およびソースコード ページでも使用されることです。そして、私の内部パスが表示されるのは本当にいいことではありません...

私が望む出力はprojectname/js/jsfile.js、または少なくとも単にjsfile.jsですが、私の人生ではこれを機能させることはできません。

誰かが私が間違っていることを教えてくれることを願っています。

よろしく、
ヤン

4

1 に答える 1

0

@Louis は、それがアルファ版の問題であることを理解するのを助けてくれました。
3.2.2 は、ドキュメントへのフル パスをエクスポートしませんでした。

残念ながら、順序付けられていないリストがサポートされていないなど、他の問題がありました。
そこで、私は 3.3.0 に固執し、後で jsdoc の間違った出力を修正するシェル スクリプトを作成することにしました。
シェルファイルの内容:

./jsdoc-master/jsdoc ./projectname/js/jsfile.js
ABSPATH=$(cd "$(dirname "$0")"; pwd)
perl -pi -e "s?$ABSPATH/projectname/js/??g" ./out/*.html

したがって、これは基本的に生成されたhtmlファイルからフルパスを削除します。
少し汚れていますが、動作します...

よろしく、
ヤン

于 2014-02-28T12:14:45.260 に答える