ShowDoc的使用

  • 1、什么是ShowDoc
  • 2、使用ShowDoc做什么
  • 3、ShowDoc的使用

1、什么是ShowDoc

在线官网地址:https://www.showdoc.com.cn/。

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

小结:ShowDoc是一个API文档工具,我们可以使用它来写接口文档。

2、使用ShowDoc做什么


我们后端主要用ShowDoc来写接口文档,避免了繁琐的排版任务。如果是前后端分离的项目,前端和后端唯一交汇的地方就是接口。因此,提供给前端开发人员一个美观并且详细的接口文档非常重要,而ShowDoc则可以帮助我们非常轻松的完成这个任务。

3、ShowDoc的使用

如果不想自己搭建ShowDoc的服务器的话,可以使用官方提供的在线ShowDoc服务,前提是注册一个ShowDoc账号。


没有账号的可以注册一个:

然后使用账号登录就可以使用了。

新建一个项目:

填写好之后提交就行了。

可以点击进去:

先按照模块建立几个目录:





然后可以开始根据接口写文档了:


填写标题,选择模块,然后点击API接口模板生成一个模板文件,直接修改就行了。

修改完成后点击保存。

那么这个API接口说明文档就完成了,也能使用ShowDoc进行API接口测试:



这个在线API接口测试只支持get和post方式,其他的请求方式不支持,看情况使用postman或Swagger-ui测就行了。

ShowDoc的使用相关推荐

  1. showdoc windows 搭建_Windows 搭建在线文档工具showdoc工具

    ShowDoc是什么 每当接手一个他人开发好的模块或者项目,看着那些没有写注释的代码,我们都无比抓狂.文档呢?!文档呢?!Show me the doc !! 程序员都很希望别人能写技术文档,而自己却 ...

  2. unity3d api 中文文档_接口文档系统-showdoc安装部署

    ShowDoc简介 ShowDoc是一个开源.免费的工具 ShowDoc是一个非常适合IT团队的在线API文档,技术文档工具,它可实现实时同步,用户无需花费过多的精力维护文档. 借助ShowDoc可以 ...

  3. api服务器开发语言,【API编写】介绍一个国内强大的API接口文档写作网站showdoc - 最好的编程语言 - 博客园...

    这几天要写一个接口API文档,经理给我发过来一个,说要弄一个这样的接口文档,我一看,这可麻烦呀,有大纲有详细,我以为要用div+css去一个页面一个页面做呢,这工作量可不小,网站一搜索,竟然有可以直接 ...

  4. 在自己的linux服务器上面部署ShowDoc

    ShowDoc就是一个非常适合IT团队的在线文档分享工具,使用的是一款非常轻量级的关系数据库系统SQLite,支持多数SQL92标准.它可以加快团队之间沟通的效率. 但是把所有的接口文档写在第三方的服 ...

  5. ShowDoc 软件开发团队接口文档管理利器

    ShowDoc是一个非常适合IT团队的在线API文档.技术文档工具.你可以使用Showdoc来编写在线API文档.技术文档.数据字典.在线手册. 这里介绍 Showdoc 这款开源(免费)文档管理系统 ...

  6. showdoc windows 搭建_ShowDoc的搭建

    其实,官方文档也说的很清楚了. 主要贴一下我遇见的问题. 环境: LNMP (LAMP没试过,有兴趣的同学可以试试,然后发出来) PHP5.3以上版本.php-mbstring模块.php-pdo模块 ...

  7. Showdoc 搭建项目 API 文档系统

    showdoc 是 PHP 开发的一款 api 文档系统,因此所需环境和普通 PHP 项目一致 准备环境: php nginx composer //注意更换国内镜像,否则速度会很慢,甚至失败 创建项 ...

  8. ShowDoc的搭建

    其实,官方文档也说的很清楚了. 主要贴一下我遇见的问题. 环境: LNMP (LAMP没试过,有兴趣的同学可以试试,然后发出来) PHP5.3以上版本.php-mbstring模块.php-pdo模块 ...

  9. CentOS 7 利用Docker搭建Showdoc文档管理系统

    1,系统环境 a,操作系统   CentOS Linux release 7.6.1810 (Core)  64位 b,确保Docker环境已经安装,具体教程请看 CentOS 安装docker Do ...

  10. showdoc如何创建文件夹_showDoc生成文档

    1. 创建项目 2. 获取api_key和api_token 1. 打开设置 2. 获取api_key和token 3. 生成文档 1. 先cd进入你的项目目录,命令行模式下输入: wget http ...

最新文章

  1. Linux中如何配置IP
  2. matlab矢量相乘并打印显示
  3. 数据库本地服务器为空,本地搭建的服务器访问不到数据库数据
  4. 企业管理软件能带来什么
  5. python 3的33个保留字列表_python 33个保留字是什么意思
  6. linux安装mq报5724,linux下MQ简单配置手册.doc
  7. python file read和write的速度_python file.truncate() 然后 file.write() file.read() 出现乱码...
  8. CEdit CRichEdit 使用技巧(转)
  9. layui 树状图默认全部展开_SolidWorks 钣金展开基础设定
  10. git 删除分之以及删除文件夹
  11. request与在php安全,request导致的安全性问题分析
  12. erp5 企业开源大数据和机器学习管理平台
  13. 不知道rar压缩包密码可以解密么,rar压缩包有密码怎么解开?
  14. 微型打印机方案(包含原理图、PCB和BOM表)
  15. Resource is out of sync with the file system的解决办法
  16. 投影仿真1.0-二维图像矩阵投影
  17. 如何用matlab绘制心形线,心形线的matlab程序
  18. 块矩阵(Block Matrix)、舒尔补(Schur complement)
  19. 计算机键盘优点,机械键盘有哪些优点
  20. 【实习之路】投了109份简历,幸运的大二菜鸡终于拿到欢聚时代的offer了!!

热门文章

  1. 总结UG编程使用的小技巧
  2. HR面试问题-你的期望薪资是多少?
  3. oSIP协议栈(及eXoSIP、Ortp等)使用入门
  4. 从零开始的技术美术之路(六)色彩空间
  5. iOS 使用自定义字体
  6. Web视频播放与数据安全
  7. c语言include的用法 相对目录 绝对目录,c语言中include的用法
  8. Java通过docx模板生成docx
  9. Kubernetes集群部署方式以及pod的管理方式
  10. 检查Chrome收藏夹链接是否有效