Swagger Editor离线安装

Swagger Editor offline installation

我们公司正在使用 swagger 来记录他们的 API,目前一些开发人员正在他们的 PC 上使用在线 swagger 编辑器。

我想将这部分设计过程转移到我们的标准开发环境中,这是一个没有互联网访问的围墙花园。

如何在离线环境中安装 npm 和 swagger 编辑器?

可以选择使用 RHEL 或 Windows 机器,尽管 Windows 更可取,因为开发人员拥有本地管理员权限

简而言之就是https://swagger.io/docs/swagger-tools/#swagger-editor

git clone https://github.com/swagger-api/swagger-editor.git
cd swagger-editor
npm install
npm run build
npm start

而且它会在您的 Intranet 中正常工作。

npm不是必须的,可以从Swagger Editor repository:

下载编译好的文件
  • index.html
  • dist\*

并在本地(从文件系统)打开 index.html 或将文件放到网络中的网络服务器上。

  1. 从 swagger-editor 的 github 页面下载源版本之一(单击页面上的版本 link)
  2. 解压缩下载的源版本 zip/tar 文件。
  3. cd 到解压出来的源码目录,输入 'npm install' (或者如果你安装了一些 npm 镜像模块,比如 cnpm,使用 'cnpm install' 代替)
  4. 使用浏览器打开源目录中的 index.html 文件。或者,按照 official guide 'Setup with http-server module from GitHub' 部分从本地静态 Web 服务器提供服务。

PS。你不需要构建源代码,除非你想像官方文档的 'Contribute' 部分中写的那样做出贡献。

使用 npm/npx 的一条命令:

npx swagger-editor-binary