当前位置： 移动技术网 > IT编程>开发语言>JavaScript > 如何查看jsplumb.js的API文档(YUIdoc的基本使用)

如何查看jsplumb.js的API文档(YUIdoc的基本使用)

2019年07月11日  | 移动技术网IT编程  | 我要评论

目录

示例代码托管在：

博客园地址：

华为云社区地址：

一.问题描述

最近向一些同事推荐了网页中实现流程图绘制的工具库jsplumb.js，community版本是开源的，在github的官方仓库的wiki中能够找到社区版的官方指南，非常非常详细。但是在后来很多人反馈说找不到api文档，github官方仓库中的api文档链接失效了，jsplumb.js官网也找不到。

二. 处理方法

其实api文档就放在官方代码仓中，只是需要一些小小的加工，具体步骤如下：

1.先从官方代码仓 将master分支的工程拉取到本地

2.使用npm install yuidocjs -g 或yarn global add yuidocjs全局安装文档工具yuidoc

3.进入刚才下载的工程目录中的/doc/api文件夹

4.打开cmd小黑窗，输入yuidoc .（yuidoc后面是1个空格1个点号）

yuidoc就会在当前目录新建一个out文件夹，并将文档输出为本地静态网站，完成后只需要打开out目录中的就可以本地查看api离线文档了，下图即是yuidoc默认样式生成的离线文档：

怎么样，这个技能你get到了吗？

三. yuidoc工具介绍

官方仓库：

yuidoc是一个基于模板引擎handlebars.js 的自动化文档工具，可以将javascript中jsdoc风格的注释语句转换成静态网站式的离线文档，所以你可以通过定制模板来为最终生成的文档增加不同的主题样式。jsdoc风格通常都会有ide插件直接生成（vscode和sublime里肯定是有的，因为我自己天天用），最常见的是函数声明注释，yuidoc中可以识别的所有语法可以查看官方提供的：

//jsdoc风格的注释

/**
* my method description.  like other pieces of your comment blocks, 
* this can span multiple lines.
*
* @method methodname
* @param {string} foo argument 1
* @param {object} config a config object
* @param {string} config.name the name on the config object
* @param {function} config.callback a callback function on the config object
* @param {boolean} [extra=false] do extra, optional work
* @return {boolean} returns true on success
*/

你可以通过-e参数来指定注释文件的格式，例如你的工程是基于typescript开发的，就可以使用yuidoc . -e .ts将项目中的*.d.ts声明文件转换成离线文档，以便团队内部查阅。如果你开发的是一个工具库，需要生成完备的api文档，为了不影响源码阅读和开发，可以像jsplumb.js那样将注释语句单独写在一个文件中，因为是一个自动化工具，也没什么太多可讲的，有需要的朋友直接浏览一下官网就可以很容易地使用了。

您可能感兴趣的文章:

如对本文有疑问， 点击进行留言回复！！

相关文章:

验证码：
最近更新的文章
大家感兴趣的文章
移动技术网