W3cubDocs

/JSDoc

{@tutorial}

Table of Contents

Syntax

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

Overview

The {@tutorial} inline tag creates a link to the tutorial identifier that you specify. When you use the {@tutorial} tag, you can also provide link text, using one of several different formats. If you don't provide any link text, JSDoc uses the tutorial's title as the link text.

If you need to link to a namepath or a URL, use the {@link} inline tag instead of the {@tutorial} tag.

Examples

The following example shows all of the ways to provide link text for the {@tutorial} tag:

Providing link text
/**
 * 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() {}

If all of these tutorials are defined, and the title of the gettingstarted tutorial is "Getting Started," the example above produces output similar to the following:

Output for {@link} tags
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>.

@tutorial

© 2011–2017 the contributors to the JSDoc 3 documentation project
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://usejsdoc.org/tags-inline-tutorial.html