告别手写,使用 Doc View 快速生成接口文档
共 963字,需浏览 2分钟
·
2022-06-19 12:58
Doc View 是一款快捷生成接口文档 IDEA 插件,使用 Doc View 可以将开发人员从繁琐的文档编写中释放出来,极大的节省开发时间。
Doc View 支持以下功能:
Controller/Dubbo 接口生成 Markdown 文档 查看 Markdown 源码,预览 Markdown, 编辑接口字段等 支持自定义配置 Markdown 模版 导出 Markdown 文件到本地 上传到 YApi、ShowDoc、语雀 文档目录查看、操作、导出 导航栏 Icon 快捷操作 生成 Http Client
看着这么多功能,是不是很想下载试一试,可以在 IDEA plugin 搜索 Doc View
进行安装。
下面简单介绍下几个常用的功能。
1生成文档
可以通过在右键菜单或者点击左侧导航栏的M
进入展示界面。
界面可以:导出全部、上传全部、预览、查看 MD 源文件、编辑、单文件上传等。
其中上传支持 YApi、ShowDoc、语雀
2文档目录
在右侧窗口支持查看当前项目的所有接口文档列表,按照 Module、Class 树状排列。
Open:生成 Markdown 源文件
Http Client:生成 Http Client 文件
其中 Markdown 文件可以利用 IDEA 导出 Docs、PDF、HTML,Http Client 文件稍微调整则可以直接运行发起 Http 请求。
3配置模版
在设置窗口,可以设置模版,只要保留占位字段,其他内容可以任意调整,比如将 **接口名称:**
替换为 ### 接口名称:
。
除此之外,也支持其他配置,更多的则需要小伙伴自己摸索啦。
4最后
插件是开源在 GitHub,有兴趣小伙伴可以看一下,也欢迎提交 PR。
GitHub:https://github.com/liuzhihang/doc-view
插件文档是放在语雀,方便留言、划词留言等,也欢迎共同维护。
说明文档:https://www.yuque.com/liuzhihangs/doc-view
在说明文档中有更详细的使用哦!
感谢:lvgo、知一、大斌、liaozan、ayang0422 等等小伙伴的参与。
- <End /> -