ShowDoc v2.8.14 发布， IT 团队的在线 API 文档、技术文档工具
star7th · 2021-04-12 09:45:46 +08:00 · 2940 次点击这是一个创建于 1320 天前的主题，其中的信息可能已经有所发展或是发生改变。
地址
开源地址： https://github.com/star7th/showdoc
官网： https://www.showdoc.com.cn/
本版本更新内容：
1, 支持跨项目复制和移动目录以及目录下的文档
2, mock 功能前缀固定，后缀可以自定义 url 路径
3, 页面的历史版本可以编辑备注信息，方便自己备注版本差异
4, 关闭浏览器时候将自动解除锁定页面编辑的状态
5, 修复长项目标题引起的 bug
更新步骤请参考 请参考手册的升级安装部分 ： https://www.showdoc.com.cn/help?page_id=13732
showdoc 介绍
ShowDoc 是一个非常适合 IT 团队的在线 API 文档、技术文档工具，既有开箱即用的在线托管服务版，也有免费的开源版 ( github8700+ 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
 |
1
yushiro 2021-04-12 10:27:29 +08:00 via iPhone
支持一下。曾经用过，挺方便的，但后来重心转移到 postwoman 去了。
|
 |
2
star7th OP @yushiro postwoman 是挺棒的。不过也可以考虑用 runapi 跟 showdoc 无缝集成接口调试 https://www.showdoc.com.cn/runapi?page_id=30291
|
 |
3
LeslieLeung 2021-04-12 11:37:35 +08:00 via iPhone
看到是 php 的项目有点激动，但是看到是 tp3 就有点那啥了..我对 tp5tp6 比较熟悉，tp3 属实太旧了
|
|
4
star7th OP @LeslieLeung 用这个框架完全是出于兼容的考虑。可以兼容到 php5.3 。而如果要用现代框架重写，肯定是用 laravel 。但那个对版本要求太高了，不利于代码分发。现在主流的系统之一 centos7 的默认 php 环境还是 5.4 。 为了这个兼容性，我还是不会升级。再过几年再重写吧。
|
|
5
star7th OP @LeslieLeung 另外说一下就是这个框架目前我自维护了，安全以及其他特性都是我加入。它目前兼容从 php5.3 到 php8，兼容性是最好的，利于做代码分发。这一点比用现代框架强。过几年就再用 laravel 重写。
|
|
6
LeslieLeung 2021-04-12 13:19:12 +08:00 via iPhone
@star7th #5 我目前在用 yapi，那个目前不能用最新版的 postman 导入接口了，考虑换用 showdoc 。另外我本身写 php 比较多，难得见到 php 的项目，希望有机会贡献一点代码。
|
 |
7
endershadow 2021-04-12 13:25:54 +08:00
挺棒的,内网已经部署 showdoc
但是 runapi 不支持内网部署 |
|
8
star7th OP @LeslieLeung yapi 的作者自从离开原公司后，yapi 这个项目就基本停止维护了。如果后面有爆出什么安全漏洞的话估计也没人修复。建议还是尽早换到持续维护的项目上来吧。目前我写了 runapi 准备补充 showdoc 本身在接口调试方面的缺乏 https://www.showdoc.com.cn/runapi?page_id=30291 某种程度上是可以替换 postman 和 yapi 的
|
|
9
star7th OP @endershadow runapi 本质是用 web 技术写的 win 客户端。需要网络支持，目前尚未支持离线版。
|
|
10
LeslieLeung 2021-04-12 13:41:57 +08:00 via iPhone
@star7th #8 如果能支持一下 postman 导入就更好了？
|
|
11
star7th OP @LeslieLeung showdoc 和 runapi 都是支持的。showdoc 上是新建项目-从文件导入。runapi 直接选择导入
|
 |
12
agdhole 2021-04-12 15:35:37 +08:00 via iPhone
php7.3 马上都要停止维护了
|
|
13
star7th OP @agdhole 这就是我很讨厌的社区割裂感。现在的情况是主流系统之一的 centos7 都还在使用默认的 php5.4 。我不能放弃这块群体的。对于 php 开发者而言，什么版本都不是问题。但 showdoc 的大部分用户都是非 php 开发者，都是产品使用者。他们安装的时候就需要便利。这种时候我不能随便上高版本的 php 。只是说，我改写了程序，让其支持到了 php8.但不能强制要求那么高版本的。
|
 |
14
Leonard 2021-04-12 15:52:01 +08:00
用过，支持一下
|
|
15
star7th OP @agdhole 如果是做 sdk 之类的，面向 php 领域的开发者，那么版本高也可以。如果是作为产品暴露出去给用户，那么我坚持产品的易用性和易安装性大于一切。需要向后兼容。
|
 |
16
40EaE5uJO3Xt1VVa 2021-04-12 15:55:54 +08:00
正是由于各种环境版本导致社区割裂感，docker 的作用才那么及时珍贵
|
|
17
star7th OP @yanzhiling2001 是的，docker 的存在太有必要的。所以 showdoc 也提供 docker 版本的安装 https://www.showdoc.com.cn/help?page_id=65610 ,docker 确实为很多跨语言开发者提供了便利。
|
|
18
LeslieLeung 2021-04-12 16:16:42 +08:00 via iPhone
@star7th #11 只能在新建项目的时候导入吗？每次导入都要新建一个项目吗？
|
|
19
star7th OP @LeslieLeung 现在是的。但后面有计划做一个项目内导入的功能。
|
 |
20
xiaobanlong 2021-04-12 16:19:39 +08:00
之前有了解过, 好像不支持 swagger 注解? 最后选择了 knife4j
|
|
21
star7th OP @xiaobanlong 如果是说用注释来生产文档的话，showdoc 有一套自己的语法可以自动从注释生成文档 https://www.showdoc.com.cn/page/741656402509783
|
 |
22
mangosong 2021-04-12 18:37:00 +08:00
在用 支持一下
|
 |
23
rekulas 2021-04-12 22:05:41 +08:00
发现一个 clue，首页针对用户和爬虫访问做了区分展示
|
 |
25
zibber 2021-04-13 12:01:51 +08:00
docker 升级都要迁移数据库,可以改的平滑一点
|
|
26
star7th OP @zibber showdoc 的所有升级方式都是“先安装新版程序再迁移数据库”，这样能避免很多包袱问题，比如说要考虑到旧文件是不是修改过等兼容问题。如果采用我说的这种方式，完全不用考虑这种历史问题。对于想平滑操作的用户，我有提供一键操作脚本的。不使用一键脚本的用户可能就需要多执行一点命令了。
|
Select Language