如何以 PDF 和 XML 文件导出 Swagger 文档 [英] How to Export Swagger documentation in PDF and XML files

问题描述

我使用以下链接为 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.

这篇关于如何以 PDF 和 XML 文件导出 Swagger 文档的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！