apidoc 生成 RESTful API 的一个小工具

[xnotepad]

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

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

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

文档：http://apidoc.tools

仓库在：Github 或是 oschina

[123123]

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

[xnotepad]

@123123 没关系，重名了。

[murmur]

和 swagger 全家桶系列比呢？

[xnotepad]

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

[fwrq41251]

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

[xnotepad]

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

[puras]

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

[xnotepad]

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

[lijinma]

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

[penjianfeng]

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

[xnotepad]

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

[xuqingkuang]

已经 Star

[baoguok]

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

[liteneo]

👍

[liteneo]

Test

[fhefh]

nice mark