如何让 jsdoc 与 django 模板标签一起工作？

Question

我有带有 {% %} 模板标签的 js 文件，这导致 jsdoc 失败

ERROR: Unable to parse <path>: Unexpected token

有没有办法让 django 模板标签与 jsdoc 或任何其他 javascript 文档生成器一起工作？

Answer 1

混合使用 javascript 和 django 的模板语言本质上是不好的，尽量避免。对于 jsdoc，我认为您需要研究它的插值，这将是一项相当复杂的任务。

我能想到的另一个解决方案是将 dafault django 模板语言切换为 jinja2。然后你可以在那里设置类似这样的东西：https://gist.github.com/lost-theory/3925738 但你可能会再次遇到错误。

我会做的是，将常量放在变量的位置，然后生成文档，然后简单地放回 django 的变量。