showdoc如何创建文件夹_showDoc生成文档
1. 创建项目
2. 获取api_key和api_token
1. 打开设置
2. 获取api_key和token
3. 生成文档
1. 先cd进入你的项目目录,命令行模式下输入:
wget https://www.showdoc.cc/script/showdoc_api.sh
下载完毕,编辑
vi showdoc_api.sh
脚本内容的前面有两个变量,api_key 和 api_token ,这个需要用户自行填写。关于这两个变量的取值,请登录showdoc,进入某个项目的设置,点击开放API,便可以看到说明。showdoc_api.sh生成的文档会放进你填写的这个项目里。除了api_key 和 api_token ,还有一个url变量。如果是使用www.showdoc.cc ,则不需要修改。如果是使用开源版showdoc,则需要将地址改为http://xx.com/server/index.php?s=/api/open/fromComments ,其中,别忘记了url里含server目录。
保存文件后。执行以下命令,脚本会自动递归扫描本目录和子目录的所有文本代码文件,并生成API文档。
chmod +x showdoc_api.sh
./showdoc_api.sh
3. 文档注释规范
想要生成文档,需要按照规范进行注释:
示例:
/**
* showdoc
* @catalog 测试文档/用户相关
* @title 用户登录
* @description 用户登录的接口
* @method get
* @url https://www.showdoc.cc/home/user/login
* @header token 可选 string 设备token
* @param username 必选 string 用户名
* @param password 必选 string 密码
* @param name 可选 string 用户昵称
* @return {"error_code":0,"data":{"uid":"1","username":"12154545","name":"吴系挂","groupid":2,"reg_time":"1436864169","last_login_time":"0"}}
* @return_param groupid int 用户组id
* @return_param name string 用户昵称
* @remark 这里是备注信息
* @number 99
*/
以上示例显示效果如下:
关键字
关键字
说明
@catalog
生成文档要放到哪个目录。如果只是二级目录,则直接写目录名字。如果是三级目录,而需要写二级目录/三级目录,即用/隔开。如”一层/二层/三层”
@title
表示生成的文档标题
@description
是文档内容中对接口的描述信息
@method
接口请求方式。一般是get或者post
@url
接口URL。不要在URL中使用&符号来传递参数。传递参数请写在参数表格中
@header
可选。header说明。一行注释对应着表格的一行。用空格或者tab符号来隔开每一列信息。
@param
参数表格说明。一行注释对应着表格的一行。用空格或者tab符号来隔开每一列信息。
@json_param
可选。当请求参数是json的时候,可增加此标签。请把json内容压缩在同一行内。
@return
返回内容。请把返回内容压缩在同一行内。如果是json,程序会自动进行格式化展示。 如果是非json内容,则原样展示。
@return_param
返回参数的表格说明。一行注释对应着表格的一行。用空格或者tab符号来隔开每一列信息。
@remark
备注信息
@number
可选。文档的序号。
showdoc如何创建文件夹_showDoc生成文档相关推荐
- bin文件怎么转换成文本文档_Python脚本4:根据txt文本,批量创建文件夹
背景:深度学习图像分类的时候,有许多的标签类.1000个标签就需要创建1000个文件夹,文件夹里面放入对应的图像.不可能一个一个右击创建文件夹,所以有了今天的脚本.根据txt文本每一行的类别,创建文件 ...
- showdoc安装与脚本生成文档
前言 showdoc官方提供了一种自动化生成接口和文档的方案.在代码里编写特定格式的程序注释,然后程序就可以通过读取这些注释来自动生成文档.由于这种方式不跟特定的语言耦合,因此它的使用范围相当广泛,可 ...
- geany怎么创建文件夹_SAP事务码太多,记不住怎么办?
不同于国产财务软件,SAP提供了直接输入命令的便捷功能,例如在命令框中输入F-02可以直接进入到财务记账界面,使用起来非常方便. 但是对于很多SAP初学者来说,SAP有太多的事务代码了,真的好难记住呀 ...
- Linux 文件夹详情,linux使用命令创建文件夹以及里面的文件,详情介绍
工作学习的过程中需要用到linux系统,今天需要使用命令创建目录并在目录中创建文件,然后添加自己的内容到文件中,我们一起看看这整个过程应该怎么做. 工具/材料 ubuntu16.04操作系统. 操作方 ...
- eclipse 向HDFS中创建文件夹报错 permission denied
环境:win7 eclipse hadoop 1.1.2 当执行创建文件的的时候, 即: String Path = "hdfs://host2:9000"; FileSy ...
- asp.net创建文件夹出错的解决方案[转]
C#中.net中得IO类虽然功能很强大,但是正是因为功能强大,所以在很多虚拟服务商的服务器上并不实用 .因为IO.Directory和IO.DirectoryInfo在应用文件夹操作中,会遍历网站所在 ...
- linux 代码获取当前路径,【linux】shell代码,获取当前路径,创建文件夹
Linux学习笔记:mkdir创建文件夹 文件夹,即目录,在linux中使用mkdir创建. 语法:mkdir dir_name 通过 mkdir 命令可以实现在指定位置创建以 dir_name(指定 ...
- asp.net 创建文件夹时出错:未找到路径“D:\”的一部分。(asp.net 使用 FSO)
这些天在整一个博客程序,其中的相册功能自然就用到IO.Directory和IO.DirectoryInfo对象,这两个对象会遍历网站所在的硬盘的磁盘根目录,不巧的是,博客传到购买的虚拟主机空间后,相册 ...
- 使用批处理创建文件夹,但前提是它尚不存在
任何人都可以告诉我如何在Windows批处理脚本中执行以下操作? ( *.bat ): 仅当文件夹尚不存在时才创建它 更详细地说,我想在C:\\驱动器上创建一个名为VTS的文件夹,但前提是该文件夹尚不 ...
最新文章
- 信息系统项目管理师-计算题专题(三)上午计算小题
- MybatisPlus实现自动填充
- solr源码导入eclipse
- SAP Spartacus由于导入module路径在服务器上不正确而导致的Travis build错误
- 图论--一般带花树匹配
- 机器学习算法之生成树
- 16 BP报错-尚未在外部定义科目组 的编码范围
- 20200922:leetcode35周双周赛题解记录(下)
- Objective-C 相关Category
- 操作系统 汤子瀛版 读书总结
- centos7.3 安装ansible
- C# 中的委托和事件(详解)
- flash 和 eeprom 区别和关系、nor flash和nand flash区别
- 解决editplus编译出现中文乱码
- 【云原生】Docker容器详细讲解
- termux获取sd卡读写权限_索尼发布“世界最快”USB-C Hub及TOUGH SF-M系列SD卡
- oracle在本地创建数据库和导入DMP数据泵
- 响应式编程之三:RxJava应用:与Retrofit 结合的最佳实践
- 【VFP] MS Virual FoxPro 9.0 | 常用命令 | VFP
- 归因分析笔记6:SHAP包使用及源码阅读
热门文章
- android Fragments详解一:概述
- java静态工厂方法模式_设计模式:简单工厂模式(静态工厂方法模式)
- Node.js 异步编程之 Callback介绍
- 查看进程占用,并kill掉
- 网上订餐python_来自美国网上订餐网站的创新
- python用一行代码编写一个回声程序_使用Python的多回声测验
- 印象笔记编辑pdf_笔记软件使用体验(至2020.03)
- android 自定义菜单栏,GitHub - earthWo/AndroidBottomNavigation: android 底部菜单栏,自定义样式,自定义菜单数量,添加滚动动画和水波纹动画...
- [转载] Java泛型详解:<T>和Class<T>的使用。泛型类,泛型方法的详细使用实例
- [转载] 【零基础学爬虫】python中的yield详解