爱意满满的作品展示区。
star7th

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

  •  
  •   star7th · Jan 10, 2022 · 4570 views
    This topic created in 1612 days ago, the information mentioned may be changed or developed.

    地址

    开源地址: 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

    17 replies    2022-01-14 08:50:27 +08:00
    lupkcd
        1
    lupkcd  
       Jan 10, 2022
    使用过支持一下
    nekoneko
        2
    nekoneko  
       Jan 10, 2022
    一直在用支持一下
    ScotGu
        3
    ScotGu  
       Jan 10, 2022
    一直在用, 必须支持。
    但是有个问题想反馈下,
    在电子表格项目中,选中部分表格后复制后无法粘贴在记事本或者 excel 中。
    yolan
        4
    yolan  
       Jan 10, 2022
    一直在用, 很不错, 就是希望提供 mysql 的存储方式. sqlite 打开的时候和添加新内容时写入比较慢... 也经常卡死需要刷新
    star7th
        5
    star7th  
    OP
       Jan 10, 2022
    @ScotGu 这个后面看下
    star7th
        6
    star7th  
    OP
       Jan 10, 2022
    @PickMio showdoc sqlite 用了那么多年第一次听说会卡死需要刷新的。你可以把你的情况说下,比如说大概写多少数据的时候有问题,安装在什么服务器上
    yolan
        7
    yolan  
       Jan 10, 2022
    @star7th #6 按照你说的, 我又去测试了一下, 发现打不开的情况是挂了代理的时候有请求失败 , 关闭代理再访问就正常了, 而且写入也很快
    mekingname
        8
    mekingname  
       Jan 10, 2022
    我来找个茬。为什么历史版本的 icon 是手提包?![]( https://kingname-1257411235.cos.ap-chengdu.myqcloud.com/20220110135805.png)
    star7th
        9
    star7th  
    OP
       Jan 10, 2022
    @mekingname 用的是这个框架的内置图标 https://element.eleme.cn/#/zh-CN/component/icon 我发现没什么好的图标可以用作为历史版本的标识了
    q474818917
        10
    q474818917  
       Jan 10, 2022
    ui 还不够美观
    googlehub
        11
    googlehub  
       Jan 10, 2022
    昨天还吐槽了,写的文档能搜索出来的。
    star7th
        12
    star7th  
    OP
       Jan 10, 2022
    @googlehub 你是说搜索引擎收录?公开文档是会被收录的,就像你在 v2 的一篇公开帖子。私有项目则不会被收录。并且默认新建文档的时候选择的是私有文档。一般要设置公开的都是用户自己操作的
    geniusmyn
        13
    geniusmyn  
       Jan 11, 2022
    一直在用支持一下
    liaohongxing
        14
    liaohongxing  
       Jan 13, 2022
    后端居然是大 PHP
    liaohongxing
        15
    liaohongxing  
       Jan 13, 2022
    免费版限制比 apipost 的多 。薅羊毛可能处于劣势
    star7th
        16
    star7th  
    OP
       Jan 13, 2022
    @liaohongxing 这个免费版的限制只是官网的使用配额限制。开源版不会有这些限制。如果是抱着薅羊毛的想法,为何不用完全免费的开源版。官网是给有需要的企业用的
    liaohongxing
        17
    liaohongxing  
       Jan 14, 2022
    @star7th 抱歉 ,没仔细看 。以为没有开源版。像您开源的行为致敬
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   5132 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 77ms · UTC 09:30 · PVG 17:30 · LAX 02:30 · JFK 05:30
    ♥ Do have faith in what you're doing.