sphinxcontrib-swaggerui показывает Не удалось загрузить определение API - PullRequest
Новая
       9

sphinxcontrib-swaggerui показывает Не удалось загрузить определение API

0 голосов
/ 15 января 2020

У меня есть проект, который использует sphinx для генерации документации. Проект был создан с python 3.7, Flask 1.0.2 и Sphinx 2.3.1. Я использовал этот пакет Sphinx для реализации: Sphinx . Я хотел бы добавить пользовательский интерфейс Swagger к этой уже созданной документации, используя sphinxcontrib-swaggerui

Это директива, которую я использовал: 

.. swaggerui:: ../_static/swaggerui/people/holidays.yml
  :url: https://unpkg.com/swagger-ui-dist@3/swagger-ui-bundle.js
  :css: ../_static/swaggerui/swagger-ui.css
  :script: https://unpkg.com/swagger-ui-dist@3/swagger-ui-standalone-preset.js

Что я получаю, так это : enter image description here

Я пытался использовать sphincontrib-httpdomain следующим образом: 

.. http:get:: /people/holidays
  :synopsis: Returns posts by the specified tag for the user

, но я получаю тот же результат Не удалось загрузить определение API

My holidays.yml имеет следующее содержимое: 

Shows a list of all the days marked as holidays
---
tags:
   - people
produces:
   - application/json
responses:
   200:
     description: OK

Есть идеи?

...