logo标签列表

使用Swagger生成静态文档

swagger
86
有没有一种方法可以创建Swagger 2.0的静态文档？类似于editor.swagger.io上的“preview”。 我需要得到静态HTML文件，以便将其包含在某些静态文档中。 到目前为止，我还没有找到一种方法来实现这一点。我看到了swagger-codegen的static-docs，但这仅适用于Swagger<=1.2。
13个回答
-1
"

静态（Static）”文档可以有很多意思。

如果您正在寻找一个交互式显示（比如编辑器的预览），那么您可以使用Swagger-UI（https://github.com/swagger-api/swagger-ui）。

codegen中用于生成更静态（例如没有“立即试用”按钮等）文档的代码目前尚未在2.0版本中实现，但应该会在接下来的几周内提供。

"
1
好的，谢谢。我需要的是2.0静态文档，所以我想我会等几周。 - romeovs
1
好的，我不太确定，因为 swagger-editor 的预览模式也具有执行操作的能力，这也是您在最初的问题中提到的内容。 - Ron
-2

点击预览文档，使用Chrome插件“Save Page WE”（右键单击页面 ->“保存页面we”），结果是单个HTML文件（它不可点击，因此您必须单击要查看的所有内容）。

-4

在你的pom文件中添加Swagger的依赖。

<dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.4.0</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.4.0</version>
        </dependency>

尝试点击 -> https://editor.swagger.io/

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文，
原文链接