jsdoc-toolkit進階使用

jsdoc-toolkit基本使用網上一大摞，就不盜取別人的了，分享幾個我沒搜到的幾個進階使用：

 

1.  如何指定產生文檔的指令檔列表，例如一個指令碼庫裡有很多檔案，只想給一部分產生doc，命令列沒有相關的參數，可以使用設定檔，參數"_"是源檔案清單。

{<br />// source files to use ,'src-new/util/util.js'<br />_: ['src/base/base.js',<br /> 'src/ui/Mask.js',<br /> 'src/ui/Editor.js'<br /> ],</p><p>// document all functions, even uncommented ones<br />a: true,</p><p>// including those marked @private<br />//p: true,</p><p>// some extra variables I want to include<br />D: {generatedBy: "jianjun.wang", copyright: "2008"},</p><p>// use this directory as the output directory<br />d: "doc",</p><p>// use this template<br />t: "lib/jsdoc-toolkit/templates/jsdoc"<br />}

 

 

2.  如何為協助插入外部連結

 

@link <a target="_blank" href="../../src/ui/aaa/example.html">例子</a>

 

jsdoc-toolkit地址： http://code.google.com/p/jsdoc-toolkit/