@tutorial

描述: 链接到一个教程。

版本: '>=3.0.0'

Syntax(语法)

  • {@tutorial tutorialID}
  • [link text]{@tutorial tutorialID}
  • {@tutorial tutorialID|link text}
  • {@tutorial tutorialID link text (after the first space)}

Overview(概述)

{@tutorial}行内标签创建一个链接到您指定的教程标识符。当您使用{@tutorial}标签,您也可以提供几种不同的格式的链接文本。如果你不提供任何链接文本,JSDoc使用本教程的标题作为链接文字。

如果您需要链接到一个namepath或URL, {@link} 内联便签 来代替{@tutorial}标签。

Examples(例子)

下面的例子显示了提供给{@tutorial}标签链接文本的所有方式,例如:

/**
 * See {@tutorial gettingstarted} and [Configuring the Dashboard]{@tutorial dashboard}.
 * For more information, see {@tutorial create|Creating a Widget} and
 * {@tutorial destroy Destroying a Widget}.
 */
function myFunction() {}

如果定义了所有这些教程,并且gettingstarted教程的标题是“Getting Started”,上面的例子输出类似以下内容:

See <a href="tutorial-gettingstarted.html">Getting Started</a> and
<a href="tutorial-dashboard.html">Configuring the Dashboard</a>.
For more information, see <a href="tutorial-create.html">Creating a Widget</a> and
<a href="tutorial-destroy.html">Destroying a Widget</a>.