记录Django REST框架API以供脱机使用

Question

Django REST Framework有很多很好的文档工具，特别是Django REST Swagger：http://www.django-rest-framework.org/topics/documenting-your-api/

它们都是供在线使用的。有没有工具可以生成离线文档: PDF或HTML/CSS文件的集合？像http://sphinx-doc.org/那样的东西？

Answer 1

假设您有Swagger规范文件(JSON/YAML)，您可以使用Swagger-Codegen为REST API生成静态文档。

更新:2018年5月，Swagger Codegen的大约50名顶级贡献者和模板创建者决定派生Swagger Codegen，以维护一个名为OpenAPI Generator的社区驱动版本。有关详细信息，请参阅Q&A。