1.安装node http://nodejs.cn/download/ 下载二进制包,解压,配置环境 export NODE_HOME=/usr/local/nodeexport PATH=$NODE_HOME/bin:$PATH node -v 检查 2.修改node默认镜像 npm config ls -l 查看配置项 npm config set registry "http://registry.npm.taobao.org" 3.全局安装apidoc npm install…

apiDoc基于rest的web API文档生成器,可以根据代码注释生成web api文档,自动生成静态的html网页文档,不仅支持项目版本号,还支持API版本号. 使用apiDoc不需要自己麻烦的调word的格式,就可以生成一份漂亮的API文档.既美观又可以装逼...先看效果 1.安装: php运行环境:php(5.5.12) +  apiDoc .apiDoc的安装我们可以通过 npm 命令来安装.apiDoc基于NodeJS实现,所以你需先有NodeJS及NPM环境 windows安装no…

1.安装node.js 2.打开node.js 命令窗(shell)键入npm install apidoc -g 自动安装(几分钟) 3. C:\Users\user\AppData\Roaming\npm\node_modules\apidoc\example 目录下的example.js是文档的模板,用来生成我们需要的文档 在C:\Users\user\AppData\Roaming\npm\node_modules\apidoc下新建一个文件夹doc(自定义即可),作为文档输出目录 Ps…

http://apidocjs.com/ 例子:myapp目录下的MyCode.java /** * * @api {get} /company/list 获取公司信息 * @apiName 获取公司列表 * @apiGroup All * @apiVersion 0.1.0 * @apiDescription 接口详细描述 * * @apiParam {int} pageNum分页大小 * * @apiSuccess {String} code 结果码 * @apiSuccess {Strin…

来源:http://blog.csdn.net/xumin198908/article/details/41964159 在开发后台接口的过程中,我们肯定要提供一份api接口文档给终端app. 目前大多数的app的接口请求应该都是http+json的方式. 但是一直苦于做不出份漂亮的api文档,用word写,也太丑了..怎么才能做出一份像腾讯.新浪微博等各种开放api平台那样漂亮的api文档呢?找了好久发现了今天的主角-apidoc. 官网地址:http://apidocjs.com 开放API…

1.安装nodejs.下载网址:http://www.nodejs.org: 2.安装apidoc.运行cmd,切换到nodejs的安装目录,在命令行输入: 1 npm install apidoc -g ,完成apidoc的安装. 3.在nodejs的安装目录新建一个myapp的文件夹(用于放接口源码文件,文件为js格式,源码如下). 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27…

前几天在写完API后,写注释文档,然后很习惯的去用apidoc取生成注释文档,但是奇怪的事发生了,没有注释的内容,也没有报错:注释代码如下: /* * @api {get} /applet/:id 根据编号,获取场地id * @apiGroup applet * @apiVersion 2.2.0 * @apiParam {integer} id 二维码编号 * @apiSuccessExample {json} Success-Response: * { "code": 1, &qu…

在老大的指引下,需要将系统的json文件格式转换成apidoc的json格式,也就是json格式的重组,但是这个apidoc的生成格式是不固定的,因为apidoc有自己一套的生成规则,我需要研究一下是怎么生成的. 一.官方基础栗子 二.理解apidoc生成静态文档的结构解读 三.深入理解一下apidoc生成原理以及规则 一.apidoc基础栗子 全局安装apidoc npm install apidoc -g 1.首先建立文件目录 2.需要你在input文件夹里面写上你的js部分 这个是栗子的j…

作为后台根据需求文档开发完成接口后,交付给前台(angular vue等)做开发,不可能让前台每个接口调用都去查看你的后台代码一点点查找.前台开发若不懂你的代码呢?让他一个接口一个接口去问你怎么调用,需要传递那些参数?调用方法?这样的话,微信公众号之类的二次开发去找谁要接口调用,这显然是不切合实际的.所以有一个后台接口调用的展示文档,对前后端分离的开发来说,非常实用.之前在.net 开发中使用过swagger作为后台接口API文档的生成方式.感觉很简单,一步到位.下面介绍一下在nodejs 中采…

//@desn:apidoc linux环境  windows环境使用 //@desn:码字不宜,转载请注明出处 //@author:张慧源  <turing_zhy@163.com> //@date:2018/5/6 正文: windows版安装: 1.安装nodejs   (nodejs环境) 32 位安装包下载地址 : https://nodejs.org/dist/v4.4.3/node-v4.4.3-x86.msi 64 位安装包下载地址 : https://nodejs.org/d…

[1]npm install apidoc -g 全局安装apidoc [2]apidoc -v 查看是否安装成功 [3]apidoc.json apidoc的项目级配置文件,它必须位于整个工程目录顶层 [4]demo.java 用于演示的demo源文件,它可以位于整个工程目录的顶层目录及其子目录下,apidoc会搜索整个工程目录选择所有可能的源文件 [5]apidoc -i src/ -o apidoc/ 如果Done结果,则表明文档已经生成,位于同级目录的apidoc(与-o apidoc对…

1.找到安装目录 中 api_group.js C:\Users\ZhiJiao361\AppData\Roaming\npm\node_modules\apidoc\node_modules\apidoc-core\lib\workers\api_group.js 2.注释代码 //group = group.replace(/[^\w]/g, '_');…

AspNetCore.ApiDoc 简单徐速一下为什么选用了aspnetcore.apidoc 而没有选用swagger 最初我们也有在试用swagger,但总是有些感觉,感觉有点不满意,就但从api文档角度来说,从前后端文档沟通角度来讲 apidoc的表现形式,要比swagger简单的多,效果也要好很多. 不要和我说什么swagger现在已经是一个标准了,其实swagger的坑很多,就单说枚举类型抓取上,就显示的很无奈,下面我会创建项目,写一个接口,拿这个接口举例,同时用apidoc和swag…

1.安装 npm install apidoc -g 2.新建src文件夹,里面放2个文件,test.js和apidoc.json 3.test.js /** * @api {get} /query_article 获取文章列表 * @apiName query_article * @apiGroup wxApp * @apiDefine success fangtao * @apiParam {Number} pageIndex 文章的页码. * @apiParam {Number} page…

一.apidoc的安装 npm install apidoc -g -g参数表示全局安装,这样在哪儿都能使用. 二.apidoc在python接口代码中的使用 def index(): """ @api {GET} /index/?id= 主页操作 @apiVersion @apiName index @apiGroup User @apiDescription 这里可以描述一下这个函数的具体操作 这一行也是可以描述的 @apiParam {Data} name 姓名 @ap…

工具名称:APIDOCGit地址:https://github.com/apidoc/apidoc 项目地址:http://apidocjs.com/ 样例项目:http://apidocjs.com/example_basic/ APIDOC使用指南:https://www.jianshu.com/p/34eac66b47e3 全局安装 安装NodeJS后自动安装了npm管理工具,使用npm管理工具在cmd下安装apidoc 注意:Windows用户需在cmd下执行安装命令,不要在git ba…

apidoc是一个轻量级的在线REST接口文档生成系统,支持多种主流语言,包括Java.C.C#.PHP和Javascript等.使用者仅需要按照要求书写相关注释,就可以生成可读性好.界面美观的在线接口文档.本文主要包含以下内容: 介绍apidoc的基本概念 安装.使用和简单配置 一些特殊参数的含义及其使用 介绍一些使用经验 前言 apidoc能做什么 apidoc是一个轻量级的在线REST接口文档生成系统,可以根据其特定的规则的代码注释来生成静态网页.首先看下它生成的文档界面和风格. 支持 a…

1.先去官网下载已编译好的安装包 以Centos7.4 64位为例, 下载地址: https://nodejs.org/dist/v8.1.2/node-v8.1.2-linux-x64.tar.xz wget https://nodejs.org/dist/v8.1.2/node-v8.1.2-linux-x64.tar.xz 执行解xz命令: ​xz -d node-v8.1.2-linux-x64.tar.xz 再解压: tar -xvf node-v8.1.2-linux-x64.tar…

使用apidoc工具来给项目做接口文档,不仅有合理的源码注释,还可以生成对应的文档.是给源码写备注的一个极佳实践. 工具名称:apiDoc Git地址:https://github.com/apidoc/apidoc 项目地址:http://apidocjs.com/ 样例项目:http://apidocjs.com/example_basic/ 博客学习:http://blog.csdn.net/soslinken/article/details/50468896 出现的问题: 1. 运行:a…

在服务器项目开发过程中,总会牵扯到接口文档的设计与编写,之前使用的都是office写一个文档,不够直观.下面介绍一种工具生成Apidoc.,该工具是Nodejs的模块,请务必在使用前安装好nodejs环境! 一．安装Apidoc 1.安装nmp环境,Windows环境可直接通过http://nodejs.org/下载安装包安装 2.安装后在cmd终端执行npm install apidoc –g如果执行失败跳到步骤3 3.安装npm首先先安装Homebrew在终端ruby -e "$(curl…

具体使用方法见这里 https://blog.csdn.net/lynnyq/article/details/79254290 挺详细的,我就不抄了. 重点是一个坑: 执行 python manager.py apidoc 无反应 并且没有生成api文档 执行 apidoc -o static/docs 显示Nothing to do 执行 apidoc -o static/docs --debug 显示一堆调试信息,说明确实工作了,但是还是啥文档没有 苦思冥想之后.还是不解 但是奇迹就在我给需…

身为程序员最讨厌看到的代码没有注释,自己的代码却讨厌写注释,觉得麻烦,接口也是这样. 比如公司要做一个H5活动的页面,开发文档已经发到后端开发.设计.与前端的邮箱了,其实这个时候就可以开始开发了.开发人员开始论证H5页面中逻辑是否能够实现,以及该逻辑的合理性,及时的反馈给产品进行修改或者优化.等一切都定下来的时候,各方面就可以开始动工了. 一般来说,设计资源会在后端接口开发完成之前给到.对于一个对开发工作足够得心应手的后端工程师,一般看到设计稿,就知道接口的数据结构和内部的逻辑是怎么样的.因此不…

在自定生成api文档方面以前都是使用swagger.json结合swagger工具来生成文档,偶然发现了apidoc这个生成api的工具,发现使用起来比swagger更加简单,下面整理一下使用过程: 1.安装 首先通过npm全局安装apidoc $ npm install apidoc -g 2.使用 使用的时候最主要是参考官方文档 ,apidoc文档,文档中清晰的记录了怎么使用的过程,最好也要看一下apidoc的github地址,从哪里你可以看到一个简单的example, 下面就是利用gith…

写在前面: 将进行3个步骤配置 1.在sublime3中安装插件docblockr,可以参考http://www.cnblogs.com/jiangxiaobo/p/8327709.html 2.安装之后在首选项中选取插件设置,找到DocBlockr插件,进行User Setting 3.配置DocBlockr,配置代码如下: { // 自定义配置,不建议在默认配置里进行更改,应该在User Settings里进行单独配置 "jsdocs_extra_tags" : [ // apid…

在开发接口的过程中,需要向外发布相应的接口文档.开始的时候使用word来写文档,时间长了发现有几个问题. 1. 编写不方便.每次新增借口的时候都要复制上一个接口,然后再进行修改,一些相同的部分无法复用,接口多了文档会变的很长,还经常需要调整格式. 2. 发布不方便.文档更新时,需要发给需要的小伙伴.即使用git来进行管理,虽然拉取比较方便,但由于文件格式的问题,也不方便比较两次提交的差异. 由于有这些问题,决定寻找一种更优雅有效的方式来编写文档.经过比较,发现了apidoc,可以比较好的解决上面…

首先声明下,apidoc是基于注释来生成文档的,它不基于任何框架,而且支持大多数编程语言,为了springboot系列的完整性,所以标了个题. 一.apidoc简介 apidoc通过在你代码的注释来生成api文档的.它对代码没有侵入性,只需要你写好相关的注释即可,并且它仅通过写简单的配置就可以生成高颜值的api接口页面.它基于Node.js,所以你需要安装node.js环境.node.js安装,点击这里.这里就不介绍. 二.准备工作 安装完node.js安装api.doc,它的项目源码:http…

一.安装node.js环境 感谢阿里云,下载的链接http://npm.taobao.org/mirrors/node/latest-v6.x/ 二.安装apidoc npm install apidoc -g 三.背景准备 1.以Java为例,新建一个java项目,假设名为test. 2.新建一个文本文件,命名apidoc.json,放置在test项目src根目录下.3.新建一个Java文件,假设名为Test.java. 四.编写apidoc.json 这是在自动生成文档时的基础设置信息. {…

直接生成文档的神器 apidoc 1 win+R 输入 cmd 回车 然后进入 nodejs 项目目录 例如 D:\NodeTest\newApp1 2  用npm安装 apidoc 直接输入 npm install apidoc -g  按回车 3 打开项目的 package.json文件 加入 "apidoc": { "title": "apiDoc在浏览器中的标题", "url" : "https://api.…

网站 http://apidocjs.com/#demo Install npm install apidoc -g Run apidoc -i myapp/ -o apidoc/ -t mytemplate/没有模板 apidoc -i myapp/ -o apidoc/ Demo 首先要有个myapp文件夹 里面有一个接口描述( 详细描述见官网 ) /** * @api {post} /company/useList 获取公司员工列表 * @apiName PostCompany * @ap…

转载请标明出处: 原文首发于:https://www.fangzhipeng.com/springboot/2017/07/11/springboot-apidoc/ 本文出自方志朋的博客 首先声明下,apidoc是基于注释来生成文档的,它不基于任何框架,而且支持大多数编程语言,为了springboot系列的完整性,所以标了个题. 一.apidoc简介 apidoc通过在你代码的注释来生成api文档的.它对代码没有侵入性,只需要你写好相关的注释即可,并且它仅通过写简单的配置就可以生成高颜值的ap…