之前一直使用apidoc生成接口文档,今天因为在另一台电脑上也需要使用,就按照网上的教程安装了nodejs和apidoc。但是安装成功之后,执行apidoc命令生成接口文档的页面布局居然是混乱的,或者说跟以前不太一样。具体是这样的:
再看生成的具体代码如下:
可见好像是少了一些什么东西。然后从网上各种查资料,将nodejs和apidoc卸载重装了多次仍然无果。
后来突然想到,是不是apidoc官方更新了?难道官方的布局就更新成这样了吗?
抱着这个想法,找到了apidoc的官方网址,如下:
apiDoc - Inline Documentation for RESTful web APIs (apidocjs.com)
然后惊喜的发现,官方果然更新了apidoc的布局形式!如图中所示,最新的apidoc生成的布局就是这样子的!
我仍然习惯使用以前这样的布局,
于是我们知道了问题的症结,接下来就是解决了。
很明显,apidoc有不同的版本,最新的版本布局已经更新,因为我们使用不带版本号的命令安装的都是最新的版本,所以我们需要安装以前的版本。
首先我们卸载我们现在的apidoc
C:\Users\Administrator>npm uninstall -g apidoc
removed 302 packages, and audited 1 package in 1s
found 0 vulnerabilities
接着下载指定版本的apidoc
C:\Users\Administrator>npm install apidoc@0.29.0 -g
added 171 packages in 6s
我下载的是0.29.0版本的,我一直用的版本。
至此,这个所谓的“页面布局混乱”的问题已解决。
当然如果有人喜欢新布局,也可以继续使用。