写点什么

告别手写,使用 Doc View 快速生成接口文档

作者:程序员小航
  • 2022 年 6 月 20 日
  • 本文字数:707 字

    阅读完需:约 2 分钟

Doc View 是一款快捷生成接口文档 IDEA 插件,使用 Doc View 可以将开发人员从繁琐的文档编写中释放出来,极大的节省开发时间。


Doc View 支持以下功能:


  • [x] Controller/Dubbo 接口生成 Markdown 文档

  • [x] 查看 Markdown 源码,预览 Markdown, 编辑接口字段等

  • [x] 支持自定义配置 Markdown 模版

  • [x] 导出 Markdown 文件到本地

  • [x] 上传到 YApi、ShowDoc、语雀

  • [x] 文档目录查看、操作、导出

  • [x] 导航栏 Icon 快捷操作

  • [x] 生成 Http Client


看着这么多功能,是不是很想下载试一试,可以在 IDEA plugin 搜索 Doc View 进行安装。


下面简单介绍下几个常用的功能。

生成文档


可以通过在右键菜单或者点击左侧导航栏的M 进入展示界面。


界面可以:导出全部、上传全部、预览、查看 MD 源文件、编辑、单文件上传等。



其中上传支持 YApi、ShowDoc、语雀

文档目录


在右侧窗口支持查看当前项目的所有接口文档列表,按照 Module、Class 树状排列。


Open:生成 Markdown 源文件


Http Client:生成 Http Client 文件




其中 Markdown 文件可以利用 IDEA 导出 Docs、PDF、HTML,Http Client 文件稍微调整则可以直接运行发起 Http 请求。

配置模版


在设置窗口,可以设置模版,只要保留占位字段,其他内容可以任意调整,比如将 **接口名称:** 替换为 ### 接口名称:



除此之外,也支持其他配置,更多的则需要小伙伴自己摸索啦。

最后

插件是开源在 GitHub,有兴趣小伙伴可以看一下,也欢迎提交 PR。


GitHub:https://github.com/liuzhihang/doc-view


插件文档是放在语雀,方便留言、划词留言等,也欢迎共同维护。


说明文档:https://www.yuque.com/liuzhihangs/doc-view


在说明文档中有更详细的使用哦!



感谢:lvgo、知一、大斌、liaozan、ayang0422 等等小伙伴的参与。

发布于: 刚刚阅读数: 3
用户头像

个人公众号:『 程序员小航 』 2020.07.30 加入

某不知名互联网公司 Java 程序员一枚。记录工作学习中的技术、开发及源码笔记;分享生活中的见闻感悟。

评论

发布
暂无评论
告别手写,使用 Doc View 快速生成接口文档_IDEA_程序员小航_InfoQ写作社区