求推荐一个开源的 API 文档管理系统

2014-03-31 16:15:48 +08:00
 f0101
目前想为项目写一个API文档,在线阅读的。想找一个好用点的API文档管理系统。能实现像微博API、淘宝开放平台这种效果的:

http://open.weibo.com/wiki/2/statuses/querymid
http://wiki.open.t.qq.com/index.php/%E5%B9%B3%E5%8F%B0%E4%BB%8B%E7%BB%8D
http://open.taobao.com/doc/detail.htm?id=101710

试用了几个感觉都不理想。求推荐。
52899 次点击
所在节点    程序员
34 条回复
XadillaX
2014-03-31 16:18:09 +08:00
马克一下。同求!~
weiceng
2014-03-31 16:30:15 +08:00
jedyu
2014-03-31 16:33:30 +08:00
stcatz
2014-03-31 16:50:54 +08:00
http://apiblueprint.org

不过还没深入研究,求试用报告。
lang1pal
2014-03-31 16:54:19 +08:00
淘宝的看不出来
sina和腾讯的是http://www.mediawiki.org/wiki/MediaWiki
FuryBean
2014-03-31 16:57:41 +08:00
docular: http://grunt-docular.com
daux.iohttp://daux.io

如果还是不满意,可以在metalsmith的基础上自己打造:
https://github.com/segmentio/metalsmith
jyhmijack
2014-03-31 16:58:15 +08:00
不长的文档可以用这个https://github.com/tripit/slate
coderliss
2014-03-31 17:07:16 +08:00
mark...
楼主最后选用了哪个?求PK结果。
cxh116
2014-03-31 17:28:21 +08:00
用sphinx doc应该最省事, 默认模板不好看,自己再写一个

目前用redmine的wiki在写,因为自带了toc(table of content)标签,用着也还不错


也看到有人用middleman写文档, http://docs.cloudfoundry.org/ https://github.com/cloudfoundry/cf-docs
hupohuke
2014-04-01 08:23:06 +08:00
sphinx
missdeer
2014-04-01 09:09:30 +08:00
不是用doxygen比较多么
lygmqkl
2014-04-01 17:01:46 +08:00
http://apihelp.yiiblog.info/

我自己开发了一份,暂时还没开源,因为项目忙 搁置了,如果有需要可以共享一份给你。
f0101
2014-04-02 15:44:13 +08:00
@lygmqkl 很不错,方便的话发我一份: x@51.is
f0101
2014-04-16 13:20:43 +08:00
@lygmqkl 老兄看来还是不愿意分享啊
pheyer
2015-02-16 16:38:08 +08:00
Rico
2015-06-24 16:20:04 +08:00
bsbgong
2015-11-04 17:39:06 +08:00
RAP 很不错,没用过的可以试试
star7th
2015-12-01 16:51:05 +08:00
ShowDoc 是什么

每当接手一个他人开发好的模块或者项目,看着那些没有写注释的代码,我们都无比抓狂。文档呢?!文档呢?! Show me the doc !!
程序员都很希望别人能写技术文档,而自己却很不希望要写文档。因为写文档需要花大量的时间去处理格式排版,想着新建的 word 文档放在哪个目录等各种非技术细节。
word 文档零零散散地放在团队不同人那里,需要文档的人基本靠吼,吼一声然后上 qq 或者邮箱接收对方丢过来的文档。这种沟通方式当然可以,只是效率不高。
ShowDoc 就是一个非常适合 IT 团队的在线文档分享工具,它可以加快团队之间沟通的效率。
它可以用来做什么

API 文档( 查看 Demo )

随着移动互联网的发展, BaaS (后端即服务)越来越流行。服务端提供 API , APP 端或者网页前端便可方便调用数据。用 ShowDoc 可以非常方便快速地编写出美观的 API 文档。
数据字典( 查看 Demo )

一份好的数据字典可以很方便地向别人说明你的数据库结构,如各个字段的释义等。
说明文档

你完全可以使用 showdoc 来编写一些工具的说明书,也可以编写一些技术规范说明文档以供团队查阅
它都有些什么功能

分享与导出

响应式网页设计,可将项目文档分享到电脑或移动设备查看。同时也可以将项目导出成 word 文件,以便离线浏览。
权限管理

公开项目与私密项目
ShowDoc 上的项目有公开项目和私密项目两种。公开项目可供任何登录与非登录的用户访问,而私密项目则需要输入密码验证访问。密码由项目创建者设置。
项目转让
项目创建者可以自由地把项目转让给网站的其他用户。
项目成员
你可以很方便地为 ShowDoc 的项目添加、删除项目成员。项目成员可以对项目进行编辑,但不可转让或删除项目(只有项目创建者才有权限)
编辑功能

markdown 编辑
ShowDoc 采用 markdown 编辑器,无论是编辑还是阅读体验都极佳很棒。如果你不了解 Markdown ,请在搜索引擎搜索"认识与入门 Markdown"
模板插入
在 ShowDoc 的编辑页面,点击编辑器上方的按钮可方便地插入 API 接口模板和数据字典模板。插入模板后,剩下的就是改动数据了,省去了很多编辑的力气。
历史版本
ShowDoc 为页面提供历史版本功能,你可以方便地把页面恢复到之前的版本。
部署到自己的服务器

克隆或者下载代码:
https://github.com/star7th/showdoc
导入数据库
下载代码后,将跟目录的 showdoc.sql 文件导入 mysql 数据库
修改配置文件
进入 Application/Common/Conf/目录,编辑 config.php 文件,填写相应的数据库信息
目录权限
请确保 Application/Runtime 有可写权限
使用在线的 ShowDoc

如果你没有自己的服务器,但又想使用 ShowDoc 作为分档分享工具,你可以使用在线的 ShowDoc http://doc.star7th.com
版权

ShowDoc 遵循 Apache2 开源协议发布,并提供免费使用。
版权所有 Copyright © 2015 by star7th http://blog.star7th.com All rights reserved.
wujunze
2016-05-09 19:29:48 +08:00
apiManager http://git.oschina.net/leunpha/apiManager 这个用来管理接口还是不错的
funing
2016-08-21 11:07:21 +08:00
推荐一个国内的跟 postman 很像的工具

http://apizza.cc

体验很棒,发送请求和 postman 体验差不多,比 postman 更多的是可以一键生成文档。

更符合国内的浏览习惯。

更主要是访问速度快。

我们公司一直在用。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/106648

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX