使用 maven 插件的离线 swagger 文档答案

【问题标题】：Offline swagger documentation using maven plugin使用 maven 插件的离线 swagger 文档
【发布时间】：2015-08-18 20:08:04
【问题描述】：

我正在尝试生成 swagger 文档，为此我需要启动服务器。我想离线生成swagger文档（不启动服务器），我刚得到这个链接swagger-codegen-maven-plugin

但是当我将上面的插件添加到 POM.xml 时（假设在 maven 构建期间生成 HTML 文档，我觉得），它根本没有做任何事情。请帮忙。

【问题讨论】：

【解决方案1】：

看看这个插件： https://github.com/teamcarma/swagger-jaxrs-doclet

由于 JSON 资源列表是从源代码离线生成的，这意味着您无需向项目添加任何运行时依赖项，并避免因不同的 jar 版本和 jaxrs 实现而带来的潜在麻烦。这也避免了增加工件的大小

【讨论】：

【解决方案2】：

要生成 HTML 文档，您需要将配置中语言标记的值设置为 HTML。在您链接的示例中，它设置为java。将其更改为html。如果您需要同时生成 Java 和 HTML，则有两个 execution 块，一个用于 Java，一个用于 HTML。

【讨论】：