drf-yasg 自定義 SwaggerUIRenderer

Question

我想自定義 drf_yasg 生成文檔的樣式（字體、colors、徽標等）。

我看到我可以使用extra_head 、 extra_styles 、 extra_body 、 extra_scripts塊擴展drf_yasg/swagger-ui.html ，如果需要，甚至可以覆蓋其他塊。

我不清楚的是我如何指向擴展swagger-ui.html模板。

我從

class MyCustomSwaggerUIRenderer(SwaggerUIRenderer):
    template = 'api/custom-swagger-ui.html'

我想在SwaggerUIRenderer中用MyCustomSwaggerUIRenderer替換get_schema_view但不明白如何/在哪里做它而不明確地嘗試在rest_framework.views.APIView的某個子類中枚舉所有其他需要的渲染器，這似乎很復雜。

對文檔或示例的指針表示贊賞。 我已經閱讀了 https://drf-yasg.readthedocs.io/沒有成功。

Answer 1

您不必為此創建自定義 class。 您只需要在新的或現有的應用程序下創建一個名為drf-yasg的目錄，然后使用您的自定義模板在其下方放置一個名為swagger-ui.html的文件。 例如，如果您已經有一個名為api的應用程序，則可以將其放在api/templates/drf-yasg/swagger-ui.html 。 確保在 INSTALLED_APPS 中drf-yasg之前指定了應用程序api 。

參考： https://github.com/axnsan12/drf-yasg/issues/294#issuecomment-464461773