JavaScript 文档生成

发布于 2025-01-05 10:10:29 字数 1536 浏览 1 评论 0原文

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(2

分分钟 2025-01-12 10:10:29

您可以使用著名的 JSDoc-Toolkit 来实现此目的。

JsDoc Toolkit 是一个用 JavaScript 编写的应用程序,用于
自动生成模板格式的多页 HTML(或 XML,
来自注释 JavaScript 的 JSON 或任何其他基于文本的文档
源代码。

是的,它还有命令行选项

You can use famous JSDoc-Toolkit for that.

JsDoc Toolkit is an application, written in JavaScript, for
automatically generating template-formatted, multi-page HTML (or XML,
JSON, or any other text-based) documentation from commented JavaScript
source code.

And yes it also has command line options.

眼角的笑意。 2025-01-12 10:10:29

JSDoc 是一种从带注释的 JavaScript 生成文档的方法。有很多变体:

  • 它最初是用 Perl 实现的。
  • JSDoc-Toolkit 将其移植到 JavaScript,但需要 Java,因为它使用 Rhino JavaScript用Java编写的引擎。
  • 有几个人将其移植到直接在 node.js JavaScript 引擎/平台上运行,例如 node-jsdoc-toolkit
  • dox 也运行在 Node.js 上,它结合了类似 JSDoc 的标签和 Markdown 标记,但需要单独的模板引擎(如 Stack Overflow 和 github 上使用的)。

全部从命令行运行。根据您的工具偏好进行选择。我喜欢 Node.js,因为它的速度和全时 JavaScript 的感觉。 DailyJS“让我们制作一个框架”关于编写文档的帖子描述了这些工具和其他工具;不幸的是,自编写以来,dox 被彻底修改为仅输出 JSON 结构。

https://stackoverflow.com/q/1221413/1162195 提到了其他 JavaScript 文档生成器。

JSDoc is an approach to generating documentation from commented JavaScript. There are many variations:

  • It was originally implemented in Perl.
  • JSDoc-Toolkit ported it to JavaScript, but requires Java as it uses the Rhino JavaScript engine written in Java.
  • Several people have ported it to run directly on the node.js JavaScript engine/platform, e.g. node-jsdoc-toolkit.
  • dox also runs on node.js, it combines JSDoc-like tags and markdown markup but requires a separate templating engine(as used on Stack Overflow and github).

All run from the command line. Choose according to your tooling preferences. I like node.js for its speed and all-JavaScript-all-the-time feel. The DailyJS "Let's Make a Framework" post on writing documentation describes these and other tools; unfortunately dox was radically overhauled to just output JSON structures since that was written.

https://stackoverflow.com/q/1221413/1162195 mentions other JavaScript documentation generators.

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文