Swagger-UI 本地安装

Swagger UI是一个API在线文档生成和测试的框架。
页面简单直接，方便调试，是Swagger的一个常用工具
配合Swagger-Editor或在线编辑swagger.yml / swagger.json

1 Download github代码

> git clone https://github.com/swagger-api/swagger-ui.git

2 安装 express

> npm install express --save

3 创建一个空文件夹node_app

> mkdir node_app

4 初始化 node ，根据提示创建package.json文件

> cd node_ap
> npm init
name: (node_app) node_app 
version: (1.0.0) 
description: 
entry point: (index.js)

5 安装 express

> npm install express --save

6 创建public文件夹，放static资源

> mkdir public
> cd public

7 创建index.js，启动文件

var express = require('express'); var app = express();
app.use('/static', express.static('public')); 
app.get('/', function (req, res) { res.send('Hello World!'); }); 
app.listen(3000, function () { 
    console.log('Example app listening on port 3000!'); 
});

8 把Swagger UI项目中dist 目录下的文件全部复制到 public 文件夹下
如果要自定义UI界面，可以在public下修改css

> cp ../../dist/* .

9 启动node

> node index.js

访问 http://localhost:3000/static/index.html

---

现在页面显示的是官网的例子，替换为自己的swagger

编辑好swagger文件并切导出 swagger.json 文档，把 swagger.json 放到 node_app/public 目录下
在浏览器上方URL中改为/static/test.json，点击Explore刷新

或修改public/index.html

// url = "http://petstore.swagger.io/v2/swagger.json" ,
url = "/static/swagger.json",

重启 node 服务即可