如何在 JSDoc 中将描述单独添加到示例中?

发布于 2024-12-27 09:24:53 字数 345 浏览 1 评论 0原文

我想分别为每个代码示例添加描述。

例如:

/**
 * Test function, normal description
 *
 * THE DESCRIPTION OF THE EXAMPLE HERE
 * @example
 * fooBar("foo", "bar");
 * 
 * THE DESCRIPTION OF ANOTHER EXAMPLE HERE
 * @example
 * fooBar("bar", "foo", false);
 */ 
function fooBar (param1, param2, param3) {
}

在 JSDoc 中如何做到这一点?

I would like to add a description to each code example individually.

For example:

/**
 * Test function, normal description
 *
 * THE DESCRIPTION OF THE EXAMPLE HERE
 * @example
 * fooBar("foo", "bar");
 * 
 * THE DESCRIPTION OF ANOTHER EXAMPLE HERE
 * @example
 * fooBar("bar", "foo", false);
 */ 
function fooBar (param1, param2, param3) {
}

How can this be done in JSDoc?

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

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

发布评论

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

评论(1

神仙妹妹 2025-01-03 09:24:53

根据 http://code.google.com/p 底部的注释/jsdoc-toolkit/wiki/TagExample

您可以使用 HTML 标记构建复杂的示例块,并使用 引用您的实际示例代码。您可以将描述部分放在 HTML 内部,但在 外部。

According to the Note at the bottom of http://code.google.com/p/jsdoc-toolkit/wiki/TagExample.

You can build complex example block using HTML markup, and quote your actual example code using <code>. You can put the Description part inside the HTML, but outside the <code>.

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