如何以 PDF 和 XML 文件导出 Swagger 文档文档、文件、PDF、XML

2023-09-07 14:19:31 作者:夜深忽夢少年事

我使用以下链接为 web api 生成了招摇文档:http://wmpratt.com/swagger-and-asp-net-web-api-part-1/

I have generated swagger document for web api using below link: http://wmpratt.com/swagger-and-asp-net-web-api-part-1/

需要将文档导出为PDF或XML文件以方便发送.

Need to export document in PDF or XML file to send across handy.

它的 .NET WEB API.

Its .NET WEB API.

如何导出swagger文档?

How to export swagger documentation ?

谢谢

推荐答案

你可以使用Swagger2Markup 和 AsciiDoc 泊坞窗图片:

You can use Swagger2Markup and AsciiDoc docker images:

docker run --rm -v $(pwd):/opt swagger2markup/swagger2markup convert -i "https://api.example.org/api/doc/swagger.json" -f /opt/swagger-doc

在当前文件夹中创建名为swagger-doc.adoc"的 asciidoc 文件.

Creates asciidoc file named 'swagger-doc.adoc' in current folder.

docker run -it -v $(pwd):/documents/ asciidoctor/docker-asciidoctor asciidoctor-pdf swagger-doc.adoc

在当前文件夹中创建一个名为swagger-doc.pdf"的 PDF 文件.

Creates a PDF file named 'swagger-doc.pdf' in current folder.