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


    ShowDoc是什么

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

    ShowDoc就是一个非常适合IT团队的在线文档分享工具,它可以加快团队之间沟通的效率。

    它可以用来做什么

    它可以用来非常方便快速地编写出美观的API文档。

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

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

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

    安装

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

    composer create-project  showdoc/showdoc

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

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

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

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

    安装成功之后就可以在线管理API文档了

    API实例:

    数据库结构实例:

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

  • 相关阅读:
    iscsi序列一、搭建iscsi存储系统
    LVS系列三、LVS集群-IP-TUN模式
    LVS系列二、LVS集群-DR模式
    LVS系列一、LVS集群-NAT模式
    LINUX 的网站压力测试工具 webbench
    关于 /proc/sys/net/ipv4/下 文件的详细解释
    CentOS7+rsync+sersync实现数据实时同步
    Linux Shell 自动备份脚本
    Vim的强大配置文件
    nginx出现403 Forbidden解决方法
  • 原文地址:https://www.cnblogs.com/hzcya1995/p/13317377.html
Copyright © 2020-2023  润新知