JSDOC：是否可以链接到模块属性？

Question

我想知道是否可以从一个模块链接到另一个模块的属性/方法。

到目前为止，我已经尝试过但没有成功的方法：

/**
 * {@link module:modules/modulName#id}
 */

我的模块遵循以下模式：

/**
 * @module modules/modulName
 */
define(function() {

    'use strict';

    /**
     * @alias module:modules/modulName
     */
    var module = {
        /** Initialisation */
        init: function() {}
    };

    return module;

});

有没有办法实现我想要的？

Answer 1

好吧，从我自己设法做的事情来看

/**
 * @module namespace/moduleName
 */

/**
 * @name module:namespace/moduleName#propName
 * @type {Object}
 */
const propName= {}

然后在另一个文件中您可以引用：

/*
 * @see module:namespace/moduleName#propName
 */

您可以使用@link或，即使@type您有@typedef该名称。

使用 PHPStorm 对此进行了测试，它可以正常工作。不知道如何使用 JSDOC 自动生成 API。