使用ShowDoc在线管理API接口文档

ShowDoc是什么

每当接手一个他人开发好的模块或者项目,看着那些没有写注释的代码,咱们都无比抓狂。文档呢?!文档呢?!Show me the doc !!php

ShowDoc就是一个很是适合IT团队的在线文档分享工具,它能够加快团队之间沟通的效率。html

它能够用来作什么

它能够用来很是方便快速地编写出美观的API文档。nginx

它能够用来记录数据表结构,一份好的数据字典能够很方便地向别人说明你的数据库结构,如各个字段的释义等。web

它还能够用来编写一些工具的说明书,也能够编写一些技术规范说明文档以供团队查阅。数据库

另外它还支持文档的分享与导出,默认使用markdown编辑以及模板插入,极大的提升工做效率。apache

安装

先cd进入运行web的目录,如/var/www/html/。执行如下命令:浏览器

composer create-project  showdoc/showdoc

随后web目录下会出现一个showdoc文件夹。服务器

经过浏览器访问http://xxx.com/showdoc/install (请将网址更改成你服务器域名或ip) 即可执行ShowDoc的初始化。markdown

(请确保install 目录、server/Application/Runtime、Application/Common/Conf/config.php、Application/Home/Conf/config.php、/Application/Runtime 、 /Public/Uploads 、 /Sqlite 、 /Sqlite/showdoc.db.php 有可写权限)composer

若是你想安装到域名的根目录,请自行移动文件夹,或者设置apache/nginx绑定域名到showdoc目录。

安装成功以后就能够在线管理API文档了

API实例:

数据库结构实例:

更多查看文档请查看ShowDoc官网

相关文章
相关标签/搜索