如何向JSDoc添加标记
How to add tags to JSDoc?
我使用的是Meteor,与普通JavaScript相比,它有一些奇怪的警告。我想添加一些标签,以便使文档更明确。
Meteor.methods({
/**
* Upgrade a user's role
*
* @where Anywhere
* @rolerequired 'admin'
*
* @module Meteor.methods
* @method Roles.upgrade
* @param {String|Object} user the userId or the user document to update
* @param {String} role the role to add the user to
* @throws Meteor.Error 401 if the user trying to upgrade was not authorized to do so
*
* @example
* Meteor.call('Roles.upgrade', Meteor.users.findOne(), function (err) {
if (!err) {
console.log('User successfully added to role');
} else {
Router.error(401);
}
})
*/
'Roles.upgrade': function (user, role) {
if (Roles.userIsInRole(this.userId, 'admin')) {
return Roles.addUserToRoles(user, role);
} else {
throw new Meteor.Error(401, "Not authorized to upgrade roles")
}
}
});
@where
和@rolerequired
更特定于这个基于Meteor的应用程序。@where
可以在devdocs.io中看到。
如何添加标签到JSDoc?
是的,可以向JSDoc添加自定义标记。你需要创建一个javascript文件来定义你想要添加的标签:
custom_tags.js
:
exports.defineTags = function(dictionary) {
dictionary.defineTag('where', {
mustHaveValue: true,
onTagged : function(doclet, tag) {
doclet.where = doclet.where || [];
doclet.where.push(tag.value);
}
});
};
然后你需要将位置添加到该javascript文件的conf.json中,该conf.json将你的插件列为路径
的一部分 conf.json
:
{
"plugins": [
"plugins/test"
],
}
最后,您需要更新默认模板的.tmpl文件,以便在生成的文档中呈现您的信息。或者您可以创建自己的模板并定义自己的解析,以便将标记添加到生成的文档中。
相关文章:
- 如何使用javascript选择字符串的部分,添加html标记或删除部分
- 动态添加的标记不会'无法正确使用日期选择器
- 添加@javascript标记时,Cucumber中的HTTP身份验证失败
- 在 Javascript 生成的列表中,如何将自定义属性添加到 标记
- 如何在添加新标记和图层之前清除所有标记和图层的传单地图
- 如何在Phonegap中进行AJAX调用时添加加载屏幕
- 如何将多段线添加到标记阵列中
- 在添加新标记之前删除以前的标记
- 如何隐藏或删除Ngmap中动态添加的标记
- 在AngularJS模型中添加/删除标记
- 根据谷歌 Api v3 书/也用一个按钮添加一个标记
- 如何在加载前添加加载动画
- 通过添加自动标记库来了解 meteorjs 范围
- 在谷歌地图中添加新标记之前,先删除以前的标记
- 如何在网页加载之前添加加载页面
- 将数据属性添加到标记并使用 JQuery 检索它
- 将声音添加到标记数组 - 谷歌地图JavaScript
- 将侦听器添加到标记在循环中不起作用
- 在加载后添加预标记;t生效
- Google Maps API不会加载正确的中心位置,而是在最后添加的标记区域加载