Как создать PDF или разметку из OpenAPI 3.0?

Question

У меня есть спецификация OpenAPI 3.0, и я хочу создать из нее PDF-файл, чтобы его можно было передать конечным пользователям.

В настоящее время такие инструменты, как swagger-spec-to-pdf или swagger2markup поддерживают только Swagger 2.0, но не OpenAPI 3.0.Можно ли сгенерировать PDF из спецификации OpenAPI 3.0, не конвертируя его в Swagger 2.0?

Answer 1

Я только что нашел RapiPDF , который может генерировать PDF из определения OpenAPI 3.0.

Но это все еще не идеальный инструмент, который я ищу.До сих пор я нашел эти ограничения:

• Нет CLI, работает только в браузере.Поэтому я не могу использовать его в автоматическом конвейере.
• Обратный вызов не поддерживается
• Нет примеров в сгенерированном документе

Answer 2

Возможное решение - преобразовать определение OpenAPI 3.0 в документ HTML, а затем использовать функцию браузера «Сохранить в PDF» для преобразования HTML в PDF.

Выполните следующие действия:

1. Перейти к https://editor.swagger.io.
2. Вставьте определение OpenAPI 3.0 YAML / JSON.
3. Выберите Создать клиента> HTML .
4. Загрузите и распакуйте файл.
5. Откройте страницу index.html в браузере, например, Chrome.
6. Выберите Файл> Печать , измените Адресат на Сохранить как PDF и сохраните страницу.