【问题标题】:JSDoc Templates - "publish" not foundJSDoc 模板 - 未找到“发布”
【发布时间】:2013-09-10 17:17:49
【问题描述】:

我已经能够让 JSDoc3 使用默认模板,但是,当我尝试运行另一个模板(即使是它附带的模板,haruki)时,我收到以下错误:

js: "/path/to/jsdoc/jsdoc.js", line 308: exception from uncaught JavaScript throw: Error: Unable to load template: Module "haruki/publish" not found.

我尝试了其他几个模板并得到了相同的结果。考虑到我在 JSDoc 上的新生身份,我假设这是一些配置或调用问题让我感到困惑。

【问题讨论】:

  • 我使用几个模板生成了一个输出,这样我们就可以根据自己的需要比较哪个最合适:cancerberosgx.github.io/jsdoc-templates-demo/demo我会随着时间的推移投入更多,但我认为这对做出决定很有帮助。它还记录了它们中的每一个是如何生成的。希望对您有所帮助!

标签: jsdoc


【解决方案1】:

尝试使用 publish.js 文件(不仅仅是模板名称)设置模板文件夹的完整路径

例如命令行参数

-t templates/docstrap-master/template

或在 config.json 文件中

{ ... “选择”:{ ... “模板”:“模板/docstrap-master/模板” } }

它适用于这个https://github.com/terryweiss/docstrap

对于 Haruki,它似乎也可以工作 ./jsdoc -c conf.json -t templates/haruki 但我还有另一个错误:

此模板仅支持输出到控制台。使用选项“-d 运行 JSDoc 时的控制台”。

-d console 将结果打印到控制台

【讨论】:

  • conf.json 文件中配置模板时也会发生同样的情况。即使是examples in the docu 也不像他们写的那样工作。这个looks like a bug。使用“模板/默认”在这两种情况下都有帮助。谢谢
猜你喜欢
  • 1970-01-01
  • 1970-01-01
  • 2015-06-07
  • 1970-01-01
  • 2010-12-20
  • 1970-01-01
  • 1970-01-01
  • 2019-05-01
  • 1970-01-01
相关资源
最近更新 更多