apidocWeb API 文档生成
生成一个REST风格的Web API文档。
支持的编程语言:
-
C#, Go, Dart, Java, JavaScript, PHP(all DocStyle capable languages)
-
CoffeeScript
-
Erlang
-
Ruby
插件:
apidoc将自动包含已安装的插件。
- apidoc-plugin-schema从api模式生成并注入apidoc元素。
npm install apidoc-plugin-schema
有关如何实现自己的插件的详细信息和示例,请查看apidoc-plugin-test。
用法:
在源代码中的任意位置添加一些apidoc注释:
/ **
* @api {get} / user /:id请求用户信息
* @apiName GetUser
* @apiGroup用户
*
* @apiParam {Number} id用户的唯一ID。
*
* @apiSuccess {String} firstname用户的名字。
* @apiSuccess {String}姓氏用户的姓氏。
* /
现在生成的文档src/
进doc/
。
$ apidoc -i src / -o doc /
该存储库包含和example
文件夹,您可以从中生成有关示例api端点的非常完整的文档。它还包含最佳实践提示(在footer.md
文件中)。
$ git clone https://github.com/apidoc/apidoc && cd apidoc
$ npm install --prod
$ ./bin/apidoc -i示例-o / tmp / doc
$ $浏览器 / tmp / doc
Docker 镜像
您可以像这样在Docker中使用apidoc:
#在克隆此存储库
docker build -t apidoc / apidoc之后首先构建映像。
#运行它
docker run --rm -v $( pwd ):/ home / node / apidoc apidoc / apidoc -o outputdir -i inputdir
评论
API-docRESTful API 文档生成工具
RESTful API 标准文档生成工具,可生成直观的HTML形式、PDF格式的文档,方便API开发
API-docRESTful API 文档生成工具
0
APIdoc-GoRESTful API 文档生成工具
APIdoc是一个简单的 RESTful API 文档生成工具,它从代码注释中提取特定格式的内容,生
APIdoc-GoRESTful API 文档生成工具
0
API-docRESTful API 文档生成工具
RESTfulAPI标准文档生成工具,可生成直观的HTML形式、PDF格式的文档,方便API开发者查阅。1.遵循OpenAPI规范编写RESTfulAPI的接口定义2.生成直观的HTML和PDF格式的
API-docRESTful API 文档生成工具
0
ZetaAPI动态生成 Api 文档
ZetaAPI是一个使用SQL+XML快速创建Api接口与使用文档的框架,帮助开发者提升开发效率。框架特性配置简单功能丰富使用xml标签属性就可支持缓存,默认缓存实现为caffeine,也可自定义缓存
ZetaAPI动态生成 Api 文档
0
APIdoc-GoRESTful API 文档生成工具
APIdoc是一个简单的RESTfulAPI文档生成工具,它从代码注释中提取特定格式的内容,生成文档。目前支持支持以下语言:C#、C/C++、Go、Java、Javascript、Perl、PHP、P
APIdoc-GoRESTful API 文档生成工具
0
request2doc生成 API 说明文档
request2doc自动根据发送的请求生成API说明文档。文档模板可定制,默认为wikimarkup格式。Requirepip install jinja2wxpython: https://www
request2doc生成 API 说明文档
0