Javascript 的 Sphinx API 文档

Question

我广泛使用 Sphinx 来编写文档，并且对它感觉很舒服。

然而，我发现自己更多地使用 Javascript（前端）而不是 Python。

是否有任何插件或方法可以使用 Sphinx 从 JavaScript 代码注释中执行类似的 API 文档，就像使用 Python 文档字符串一样？

Answer 1

我遇到了同样的问题，所以我编写了sphinx-js来解决它。它基本上是 JavaScript 的自动文档，还有一些其他的细节。Mozilla Hacks 博客上有一篇更深入的文章。与类似包相比，优点是更好的修饰、没有 Java 依赖性、源代码中的标准 JSDoc 语法以及 autodoc 式的而不是基于包含的工作流程。