jsdoc

2014-06-25 18 views
7

'dan Jsdoc yerel olarak yüklendi (npm install jsdoc). DEBUG: JSDoc 3.3.0-dev (Güneş, 15 Haziran 2014 18:39:52 GMT) DEBUG: Çevre bilgisi: { "env": .\node_modules.bin\jsdoc --debug ./lib/JavaScriptSource.js Çıktı yürütmeye çalışırken aşağıdaki hatayı alıyorum { "conf": {"tags": {"allowUnknownTags": true}, "templ ates": {"monospaceLinks": false, "cleverLinks": false, "default": {"outputSourceFiles" : true}}, "source": {"includePattern": ". + \. js (doc)? $", "excludePattern": "(^ | \/| \\ ) _"}, "eklentileri": []}, " ": {" _ ": [" ./ lib/JavaScriptSource.js "]," debug "seçeneğini seçer: true," destina tion ":" ./ out/"," kodlama ":" utf8 "}}} İşlenecek giriş dosyası yok.jsdoc

JSDoc 3.3.0-dev (Sun, 15 Jun 2014 18:39:52 GMT) 

Options: 
-t, --template <value>  The path to the template to use. Default: 
          path/to/jsdoc/templates/default 
-c, --configure <value>  The path to the configuration file. 
          Default: path/to/jsdoc/conf.json 
..... 
</code> 
+1

'/ lib/JavaScriptSource.js' var mı? – Pointy

+0

Evet, var. Jsdoc source jsdoc/cli.js dosyasında, cli.scanFiles() yöntemine yapılan çağrıdan sonra env.sourceFiles boş gelir. Bu yerdeki kodu detaylı olarak görmedim. – TDreama

+0

jsdoc/cli.js için 263 satırında, bir 'code' var fileData = fs.readFileSync (env.opts ._ [0], 'utf8') çalıştırabildim; \t console.log (fileData.toString()); İçeriği görüntüleyen 'code'. Env nesnesi, orijinal gönderide gösterilir. – TDreama

cevap

13

Döngü, "_" ile başlayan dosya yolunu işlemediği jsdoc dosyasında açık bir hatadır. github.com/jsdoc3/jsdoc/issues/308. Çözümü de sağlar.

Varsayılan olarak hariç tutmaPattern (^ |/| \) _, alt çizgi ile başlayan yolları yok sayar.

https://github.com/jsdoc3/jsdoc/issues/308

"alıntı çözüm varsayılan davranışını değiştirmek için:. Yeni bir dosyaya

Kopya conf.json.EXAMPLE, conf.json Sen JSDoc dizine koyabilirsiniz Başka bir dizinine koyarsanız, JSDoc'a adresini bulmasını söylemek için -c seçeneğini kullanmanız gerekir: jsdoc -c yol/to/conf.json Bir metin düzenleyicisinde conf.json dosyasını açın. source.excludePattern özelliğini bulun ve boş birolarak değiştirindize. "

+2

Bu, amaçlanan davranıştır, bir hata değildir, bu nedenle bu sorun bir buçuk yıldır kapalıdır. –

+2

tamam. "Varsayılan olarak, JSDoc bir alt çizgi ile başlayan dosyaları ve ** dizinleri yok sayar." Bu yüzden dosya yolumda bozuk ad içeren bir klasör varsa, o da göz ardı edilir. – Artin

İlgili konular