ShowDoc v2.10.0 发布, IT 团队的在线 API 文档、技术文档工具

2022-01-10 09:37:29 +08:00
 star7th

地址

开源地址: https://github.com/star7th/showdoc

官网: https://www.showdoc.com.cn/

更新内容:

1 ,安全更新

2 ,增加页面修改提醒功能,可通知指定的项目成员

3 ,增加项目变更记录功能(查看入口在项目主页的右侧工具栏的更多展开按钮中)

4 ,可以导入文件(postman/swagger/markdown 压缩包)到已存在的项目内,也可以重复导入以覆盖更新

5 ,优化注释生成文档功能

6 ,支持通过 s3 协议上传附件

更之前的一些版本更新汇总

1 ,修复导入 swagger 文件的问题

2 ,修复点击文件库错误的问题

3 ,支持 runapi 客户端的错误返回示例

4 ,支持 runapi 客户端的搜索功能

5 ,支持 runapi 客户端的 query 和路径变量功能

6 ,可一键设置团队的成员项目权限为只读

7 ,选择目录时候可输入关键字搜索目录

8 ,在编辑页面时候可跳转去新建目录

9 ,完善页面排序功能

10 ,修复 xss 安全漏洞

11 ,解决 TOC 目录遮挡图标的问题

12 ,支持 runapi 客户端的接口状态功能

13 ,支持 runapi 客户端的全局 cookies 功能

14 ,支持 runapi 客户端的全局脚本功能

如何操作

更新步骤请参考请参考手册的升级安装部分: https://www.showdoc.com.cn/help?page_id=13732 showdoc 介绍

介绍

ShowDoc 是一个非常适合 IT 团队的在线 API 文档、技术文档工具,既有开箱即用的在线托管服务版,也有免费的开源版( github 1 万+ star )。通过 showdoc ,你可以方便地使用 markdown 语法来书写出美观的 API 文档、数据字典文档、技术文档、在线 excel 文档等等。如果不想编辑 markdown 文档,你还可以利用 showdoc 的自动化能力,从程序注释中自动生成 API 文档,或者从搭配的 RunApi 客户端(类似 postman 的 api 调试工具)中一边调试接口、一边自动生成文档。无需手动编写文档,释放生产力。通过分配项目成员和团队成员,你可以很方便地进行项目文档的权限管理和团队协作,也可以分享文档出去给朋友查看。ShowDoc 还支持多平台客户端,有 win 客户端、mac 客户端、ios 、android 等,更方便跨平台使用。目前超过 100000+的互联网团队正在使用 showdoc ,包括知名公司内部的一些团队,比如腾讯、华为、百度、京东、字节跳动等等。

关于 Showdoc 的详细介绍,请看: https://www.showdoc.com.cn/help

3535 次点击
所在节点    分享创造
17 条回复
lupkcd
2022-01-10 10:22:09 +08:00
使用过支持一下
nekoneko
2022-01-10 10:47:33 +08:00
一直在用支持一下
ScotGu
2022-01-10 11:18:00 +08:00
一直在用, 必须支持。
但是有个问题想反馈下,
在电子表格项目中,选中部分表格后复制后无法粘贴在记事本或者 excel 中。
PickMio
2022-01-10 11:55:26 +08:00
一直在用, 很不错, 就是希望提供 mysql 的存储方式. sqlite 打开的时候和添加新内容时写入比较慢... 也经常卡死需要刷新
star7th
2022-01-10 12:12:16 +08:00
@ScotGu 这个后面看下
star7th
2022-01-10 12:14:47 +08:00
@PickMio showdoc sqlite 用了那么多年第一次听说会卡死需要刷新的。你可以把你的情况说下,比如说大概写多少数据的时候有问题,安装在什么服务器上
PickMio
2022-01-10 13:32:20 +08:00
@star7th #6 按照你说的, 我又去测试了一下, 发现打不开的情况是挂了代理的时候有请求失败 , 关闭代理再访问就正常了, 而且写入也很快
mekingname
2022-01-10 13:58:10 +08:00
我来找个茬。为什么历史版本的 icon 是手提包?![]( https://kingname-1257411235.cos.ap-chengdu.myqcloud.com/20220110135805.png)
star7th
2022-01-10 14:10:30 +08:00
@mekingname 用的是这个框架的内置图标 https://element.eleme.cn/#/zh-CN/component/icon 我发现没什么好的图标可以用作为历史版本的标识了
q474818917
2022-01-10 19:54:27 +08:00
ui 还不够美观
googlehub
2022-01-10 21:45:28 +08:00
昨天还吐槽了,写的文档能搜索出来的。
star7th
2022-01-10 23:00:23 +08:00
@googlehub 你是说搜索引擎收录?公开文档是会被收录的,就像你在 v2 的一篇公开帖子。私有项目则不会被收录。并且默认新建文档的时候选择的是私有文档。一般要设置公开的都是用户自己操作的
geniusmyn
2022-01-11 10:05:42 +08:00
一直在用支持一下
liaohongxing
2022-01-13 16:49:04 +08:00
后端居然是大 PHP
liaohongxing
2022-01-13 16:51:23 +08:00
免费版限制比 apipost 的多 。薅羊毛可能处于劣势
star7th
2022-01-13 19:46:13 +08:00
@liaohongxing 这个免费版的限制只是官网的使用配额限制。开源版不会有这些限制。如果是抱着薅羊毛的想法,为何不用完全免费的开源版。官网是给有需要的企业用的
liaohongxing
2022-01-14 08:50:27 +08:00
@star7th 抱歉 ,没仔细看 。以为没有开源版。像您开源的行为致敬

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/827226

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX