记录 Django REST Framework 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。