GIT+云盘作 做 文档管理工具 在工作中, 会遇到公司的文档 和 自己家里的 文档进行同步的问题, 通常我们使用U盘作为传输节制, 但是不是非常好,文档的改动都不能发现, 导致回家同步的时候, 出各种问题. 这时候我们 就可以 考虑使用GIT了,  外加一个百度云盘 则就顺利的完成了 文档同步和历史文档管理 1.  下载必要的工具msysgit+git tortoise + 百度同步盘. 2.  安装三个工具, 并且在初次使用git tortoise 的时候需要指向msysgit的bin目录…

为什么不使用github的wiki而是使用mkdocs做文档管理? 目前 KSFramework 是使用mkdocs来做在线文档 而非使用github的wiki,这是为什么呢? 在windows下搭建wiki本地预览不成熟 gollum:https://github.com/gollum/gollum A simple, Git-powered wiki with a sweet API and local frontend. (一个简单的支持git wiki,提供本地预览) 在gollum的说…

上周看到有人在我的Github开源项目中提了个issue,说是否考虑接入swagger.那今天我就用swagger与其他接口文档工具做对比,同时说说Api接口文档工具的那点事.如今,在前后端分离开发的这个年代,Api接口文档管理工具越来越显得重要.完整的Api接口文档能大大提升前后端开发协作的效率. image 目前市场有哪些比较优秀的接口文档管理工具呢?Swagger Api接口文档工具到底如何,我大致汇总一下吧! 一.Swagger 说到Swagger,他确实是为开发者发明的一款神器,他可以…

api(接口)文档管理工具 欢迎光临:博之阅API管理平台  ,做为一个app开发者,还没有用到api管理工具,你就OUT了 点击进入:程序员精华博客大全  …

git地址:  https://github.com/thx/RAP wiki : https://github.com/thx/RAP/wiki/home_cn 视频教程: http://thx.github.io/RAP/study.html 官方Demo地址: http://rap.taobao.org/org/index.do 什么是rap 1.工具帮助我们更高效的管理接口文档GUI工具 2.可以自动生成Mock数据.校验真实接口的正确性 3.结构化的API数据,避免更多重复劳动 用户场…

系列目录 基于WPF重复造轮子,写一款数据库文档管理工具(一) 本篇重点 上次发表了基于WPF重复造轮子,写一款数据库文档管理工具(一) 得到不少人支持,文章一度上到了博客园推荐表首页,看来大家对这个工具还是很喜欢.今天就继续来分享一下我在开发这款工具的过程中积累的一些技术点. 本篇主要讲的是基于HandyControl控件的DataGrid进行数据绑定以及如何实现自定义一个自定义控件.在写这些之前我们先来看下我们工具的整个界面: 今天我们要实现的就是右边主界面展示的列表区域,其实这个区域是由多…

API文档管理工具-数据库表结构思考. PS: 管理工具只是为了方便自己记录API的一些基本信息,方便不同的开发人员 (App Developer, Restful API Developer)之间的工作协调,同时也是由于本人不擅长word文档编写,程序及设计简单,大牛勿喷! API基础信息表 CREATE TABLE API_Infor ( ApiID uniqueidentifier PRIMARY KEY ,ApiCategory int ,ApiSupport nvarchar() ,A…

showdoc 是一个很不错的api 以及技术文档管理工具 环境准备 doker-copose 文件 version: "3" services: doc: image: registry.docker-cn.com/star7th/showdoc volumes: - "./showdoc_data/html:/var/www/html/" ports: - "8080:80" 启动&&配置 启动 docker-compose…

问题: 不同软件/程序在网络中互相传递信息不统一. 交互不便. REST API 作用: RESTful API就是一套协议,用来规范多种形式的前端和同一个后台的交互方式. 原理: 组成/流程/规范: 遵守OpenAPI规范 软件的REST API文档 问题: 在API的迭代开发过程中,文档更新工作容易遗漏. swagger框架 功能: 生成遵守OpenAPI规范的.JSON或YAML格式的RESTful API文档. 实现: 读取嵌入到源代码中的api文档,生成api文档. swagger规范…

接口文档管理工具-Postman.Swagger.RAP 转自:http://www.51testing.com/html/10/n-3715910.html 在项目开发测试中,接口文档是贯穿始终的.前后端开发需要在开发前期进行接口定义并形成文档,QA在功能测试和接口测试的环节也需要依赖于这些接口文档进行测试.接口文档往往以最简单的静态文档的形态存在.然而在紧张的敏捷开发模式下,随着版本迭代,很多接口发生了变化或者被废弃,而开发几乎不会在后期去更新这种静态文档.QA人员阅读“过期”的接口文档是一…

api接口测试工具和接口文档管理工具 1.postman(https://www.getpostman.com) Postman 是一个很强大的 API调试.Http请求的工具.她可是允许用户发送任何类型的 HTTP 请求,例如 GET,POST,HEAD,PUT.DELETE等,并且可以允许任意的参数和 Headers.她支持不同的认证机制,包括 Basic Auth,Digest Auth,OAuth 1.0,OAuth 2.0等.她还可以响应数据是自动按照语法格式高亮的,包括 HTML,J…

项目背景 公司业务历史悠久且复杂,数据库的表更是多而繁杂,每次基于老业务做功能开发都需要去翻以前的表和业务代码.需要理解旧的表的用途以及包含的字段的含义,表少还好说,但是表一多这就很浪费时间,而且留下来的文档都是残缺不全,每次查一些表的含义都要捯饬很久.在网上搜索关于数据库文档管理工具搜到最多的就是Screw和DBCHM,一个是基于Java的工具.另一个则是bug很多,表一多就一直转圈圈进不去.所以自己就动手开发了这款SmartSQL的工具. 它是一款基于.Net 4.6.1.WPF开发的一款数…

铛铛铛,今天我要给大家推荐一款个人知识笔记管理神器,不出你们所料,它就是mybase. 那mybase究竟能干啥呢?借用mybase中文官网的一句话来说,mybase软件可以将电脑上的文档.知识.笔记.日记.图片和网页进行分类存储和管理,最终创建出一个专属于自己的个人知识库. 有些小伙伴忍不住要说了,你说这么多干啥,它长啥样子我都不知道,大家是不是也有这种想法呢?好!我这就满足大家的好奇心,请大家带上VR眼镜,一起来围观mybase究竟长什么样! 有没有被惊艳到?哈哈,不过如此嘛,还以为是什么软…

系统庞大之后,前后端分离开发,前端调用后端提供的接口,请求协议一般是 HTTP,数据格式一般是 JSON.后台只负责数据的提供和计算,而完全不处理展现逻辑和样式:前端则负责拿到数据,组织数据并展现的工作.这样结构清晰,关注点分离,前后端会变得相对独立并松耦合.好处多多. 但是这样带来很多问题,前端可能需要拿到后端的数据之后,才能开始开发工作,等前端开发完成之后,然后再与后端一起联调.耗时不说,如果业务的需求更改,后端接口变更,怎么快速便捷告知前端的开发人员?还有其他如文档维护和及时更新的问题.这…

RAP通过GUI工具帮助WEB工程师更高效的管理接口文档,同时通过分析接口结构自动生成Mock数据.校验真实接口的正确性,使接口文档成为开发流程中的强依赖.有了结构化的API数据,RAP可以做的更多,而我们可以避免更多重复劳动. 构建项目 (war包部署不需要) 获取源代码 导入到IDE 配置环境 安装基本工具 初始化数据库 配置文件 配置context-root (war包部署不需要) 启动项目 常见问题 如何管理团队 如何增加管理员 如何获取更新? Admin初始密码是什么? 写在最前 部署…

Simple doc是一个简易的文档发布管理工具,为什么要写Simple doc呢?主要原因还是github的wiki并不好用:没有目录结构,文章没有Hx标签索引,最悲剧的是文章编辑的时候不能直接图片粘贴和文件上传;为了满足自己的需求也顺带帮Beetlex写个完整的web示例所以花了些时间写了Simple doc.虽然Simple doc功能简单但在文档展现上还是要比github的wiki好上不少,所以在完成后也把github的wiki迁到这上面来了(毕竟都是基于markdown所以迁过来也简单…

1:下载showdoc代码文件 https://github.com/star7th/showdoc https://www.showdoc.cc/help?page_id=14 官方帮助文档 2:安装wampserver,wampserver是集成apache,php,mysql的一个服务器环境.下载后一路next. 3:安装完成后启动wampserver. 4:如果wampserver颜色变成黄色,一般来说是端口占用了,wampserver默认是80端口.只要把端口修改掉就可以. 右键->T…

使用docz我们可以用来方便的编写以及发布文档,同时提供漂亮友好的交互,可以快速的制作一个产品级的 站点,使用了了mdx 文件(还是markdown),同时可以方便的集成到自己的web 项目中 安装试用 安装   npx create-docz-app my-docz-app 项目结构 ├── README.md ├── doczrc.js ├── package-lock.json ├── package.json └── src ├── components │ ├── Alert.jsx…

前言介绍 Yapi 由 YMFE 开源,旨在为开发.产品.测试人员提供更优雅的接口管理服务,可以帮助开发者轻松创建.发布.维护 API. 权限管理 YApi 成熟的团队管理扁平化项目权限配置满足各类企业的需求 可视化接口管理 基于 websocket 的多人协作接口编辑功能和类 postman 测试工具,让多人协作成倍提升开发效率 Mock Server 易用的 Mock Server,再也不用担心 mock 数据的生成了 自动化测试 完善的接口自动化测试,保证数据的正确性 数据导入 支持导入…

1.配置PHP开发环境(Apache.PHP.MySQL) 2.安装Joomla网站: 1. 下载安装包     http://www.joomla.org/download.html 2. 登陆Joomla安装包中的index.php的页面开始安装 2. 安装步骤按照网站浏览器安装步骤    http://help.joomla.org/content/view/1947/302/1/8/ 3. 安装finish后,删除Joomla安装包中的installation文件夹: 4.点击websi…

今天各种MVC框架满天飞,大大降低了编码的难度,写实体类就没有办法回避的一件事了,花大把的时间去做一些重复而且繁琐的工作,实在不是一个优秀程序员的作风,所以多次查找和尝试后,找到一个工具类网站——Api管家 这也太直白了,卡通的背景,好像不怎么样...先试用看看 好吧,先创建个试试 果然出现了一个项目,进去看看 5个接口的示例,看起来还挺清爽,+1分,随便点点... 好多按扭啊...点点看,代码生成在哪里啊... 这个是什么鬼!有毛用... 再试试... 进编辑了... 慢点再研究,继续找...…

原文地址:https://www.jianshu.com/p/a97d2efb23c5…

目录 一 RAP2 二 RAP2 安装需要的环境 2. 1 Node.js 安装: 2. 2 Mysql 5.7+ 安装 2 .3 Redis 安装见文章 2. 4 后端 rap2-delos 安装 2. 5 前端 rap2-dolores 安装 三 注意事项: 错误一 错误二 错误三 一 RAP2 RAP2是在RAP1基础上重做的新项目,它包含两个组件(对应两个Github Repository). rap2-delos: 后端数据API服务器,基于Koa + MySQLlink rap2-d…

前言,这是自己第一次写一个系列的文档,本来想使用SharePoint 2013版本,但是碍于SharePoint 2013对于硬件要求过高,自己的笔记本无法承受,所以退而求其次选择了在SharePoint 2010版本上做文档管理的Demo.当然,由于个人认知.水平有限,博客所涉及的深度有所欠缺,但是也希望能够给一些做这方面工作的人带来帮助,也分享自己在工作之余的一些心得,一共做了如下几篇博客. 1.SharePoint 2010 文档管理系列之准备篇 介绍:创建网站集.文档库.列表库,简单的库…

前言:很早自己就想写一个系列的文章,但是不知道写什么,最近在QQ群里,好多人说在做文档管理,其实文档管理也是SharePoint的一个很不错的功能点,自己想了想,也想多学习点东西,所以写这个主题吧,今天从最简单开始. 一. 网站集准备: 1. 新建应用程序,创建网站集(模板 企业 - 文档中心): 2. 创建好的网站集显示如下: 我们可以看到,新建的网站集快速启动包括一个库和一个列表. 二. 网站定制 1. 修改网站名称.说明.徽标(修改徽标时,可以测试图片可用): 2. 然后我们发现,网站徽标…

目录 API文档格式 文档管理方式 基于注解实现,代码和文档在一起 Swagger Api2Doc 基于API测试工具生成 Postman rest-client 独立编写文档 RAP DOClever APIDOC CrapApi 写在最后 规范的接口文档管理方式有助于提高组件协同(如:前后端分离)的开发效率,对于项目的接口说明有全局的管理视角,甚至可以方便地实现对外发布. 完善的文档管理应该包含文档格式和文档管理方式这两部分,如下一一解释. API文档格式 规范的API文档格式有助于理解,可…

随着“大数据”时代的到来,越来越多的人们对数据库管理信息抱有认可态度,这是近年来信息化发展的必然结果.企业作为推进社会经济发展的主力军,也必然要紧跟大数据时代潮流,利用计算机技术全面普及企业的信息化管理及发展,才能不至落伍. 文档作为企业的智慧信息的载体,在企业发展中扮演着重要角色,文档的数字化管理是企业紧跟信息化发展潮流的重要途径.运用计算机技术进行企业电子文档管理和应用,标志着文档管理的现代化,然而企业要想实现文档的规范化管理,光靠人力是远远不够的,必然要借助文档管理工具. 在大数据时代的推…

谁说生成api文档就必须要定义注解? 谁说生成接口请求和返回示例必须要在线? 用代码去探路,不断尝试更多文档交付的可能性. 如果代码有生命,为什么不换种方式和它对话! 一.背景 没有背景.就自己做自己的背景 在当今各种盛行的前后端分离.restful service开发过程中,接口文档是必不可少的.对于前后端分离的开发中,后端开发需要将接口写好后需要告诉前端工程师接口的请求参数.响应示例等重要信息,而对于对外暴露的restful接口服务,我们提供接口也是需要具备相同的接口文档的. 但是对于后端工…

类型: 定制服务 软件包: integrated industry solution collateral 联系服务商 产品详情 解决方案 概要 为企业提供基于云平台企业应用级文档管理产品,尽可能最大化利用企业现有的 IT 系统和投资,通过轻应用,为企业内的文档协作.沟通.管理提供系统支撑,让企业能够更快.更专注地把精力放在文档本身的管理上. 业务背景 目前企业大多需要额外的软硬件投入及后期维护,企业需要自行承担数据可靠性.可访问性上的风险:可支持定制,但实施周期较长:市场上不乏功能丰富的软件,…

坚果云Markdown - 文档管理编辑器 Markdown是什么? Markdown是一种上手简单.应用十分广泛的轻量级标记语法.您可以使用Markdown轻松记录您的灵感.想法.创意.整个记录过程,不需要多分心排版设计,大大提高您的效率. [界面简洁,无内置广告] 坚果云Markdown编辑器界面简洁,无内置广告,为您创建一个不受打扰的写作环境. [多平台同步使用] 坚果云Markdown编辑器支持iOS.Android.Web等多个平台.您可以随时随地创建或编辑纯文本,插入图片.链接.表格…