apidoc 生成 RESTful API 的一个小工具

爱意满满的作品展示区。

This topic created in 3600 days ago, the information mentioned may be changed or developed.

一个提取注释生成文档的工。之前撸项目时的一个副产品，目前算是比较完善了。

跨平台， linux 、 windows 、 macOS 等都支持；
支持语言广泛，即使是不支持，也很方便扩展；
支持多个不同语言的多个项目生成一份文档；
输出模板可自定义；

目前已经支持： C#、 C/C++、 Go 、 Java 、 Javascript 、 Perl 、 PHP 、 Python 、 Ruby 、 Rust 和 Swift 。

文档：http://apidoc.tools

仓库在：Github 或是 oschina

文档

生成

支持

apidoc

16 replies • 2016-07-12 20:41:21 +08:00

123123

Jul 11, 2016

跟 http://apidocjs.com/ 是什么关系？

xnotepad

Jul 11, 2016

@123123 没关系，重名了。

murmur

Jul 11, 2016

和 swagger 全家桶系列比呢？

xnotepad

Jul 11, 2016

@murmur 没那么复杂，就提供了一个命令行工具，可以从源代码里提取特定的注释，然后生成 HTML 或是 json 文档。

fwrq41251

Jul 11, 2016

没有 demo 吗，生成的 html 长什么样？

xnotepad

Jul 11, 2016

@fwrq41251 http://apidoc.tools/example/doc/index.html 默认模板长这样，非设计出身，弄得有点丑。想好看的话，可以自己设计模板，在配置文件中指定 template 参数就可以了。

puras

Jul 11, 2016

能像 Swagger 一样，直接测试么？

xnotepad

Jul 11, 2016

@puras 不能，目前定位就是一个文档工具。

lijinma

Jul 11, 2016

@xnotepad 如果用还需要加个测试，用不了多少代码，你可以的。

penjianfeng

Jul 11, 2016

感觉很赞，已经收藏，感谢分享：-）

xnotepad

Jul 11, 2016

@lijinma 之前有过这方面的相法，不过在这方面，肯定不如 postman 之类的工具方便好用，所以就暂时放弃了。**或许**在下个版本会加上去吧。

xuqingkuang

Jul 12, 2016

已经 Star

baoguok

Jul 12, 2016

感谢,很好用.
一直在用这个生成兼职项目的文档

liteneo

Jul 12, 2016 via iPhone

👍

liteneo

Jul 12, 2016 via iPhone

Test

fhefh

Jul 12, 2016

nice mark