jsdoc.conf.json 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. {
  2. "opts": { //命令行参数,在配置文件中配置了就不要敲命令了
  3. "encoding": "utf8", //文件编码utf8
  4. "destination": "./o2web/jsdoc/", //输出目标文件夹
  5. "recurse": true, //是否递归抽取sorce/include配置的文件夹
  6. "template" : "./node_modules/tidy-jsdoc-o2", //模板路径
  7. "prism-theme": "prism-custom" //模板中的代码块样式主题
  8. //"tutorials": "./o2web/tutorials" //如果有教程,对应教程目录
  9. },
  10. "tags": {
  11. "allowUnknownTags": true, //允许jsdoc中未命名的标签
  12. "dictionaries": [ //标签库
  13. "jsdoc",
  14. "closure"
  15. ]
  16. },
  17. "source": {
  18. "include": [ //需要抽取文档的源文件夹
  19. "./o2web/source/x_component_process_Xform",
  20. "./o2web/source/o2_core/o2/xScript"
  21. ],
  22. "includePattern": ".+\\.js(doc|x)?$", //抽取的源文件名称正则表达式
  23. "excludePattern": "(^|\\/|\\\\)_" //排除的源文件正则表达式
  24. },
  25. "plugins": [ //启用插件
  26. "plugins/markdown", //把markdown转成html
  27. "plugins/summarize" //为每个doclet生成摘要
  28. ],
  29. "templates": { //模板参数
  30. "cleverLinks": false, //@link标签是否呈现为纯文本
  31. "monospaceLinks": false,
  32. "default": {
  33. "staticFiles": { //静态文件目录
  34. "include": [
  35. "./o2web/jsdoc_static"
  36. ]
  37. }
  38. }
  39. },
  40. "metadata": {
  41. "title": "O2OA前台API" //最终生成的文档中标题
  42. }
  43. }
  44. //执行命令: jsdoc -c ./o2web/jsdoc.conf.json