如何为基于类的视图生成文档？

Question

在 Django 文档 中有一个简短的信息，介绍如何记录模型、视图和其他文件，以便在 Django 管理中轻松使用它们。但它缺乏有关如何对基于类的视图执行此操作的信息。假设我有简单的

DetailView

:

class MyDetailView(DetailView):
    model = MyModel

我写的是这样的：

class MyDetailView(DetailView):
   """
       Displays single :model:`myApp.MyModel` with all details.

       :template: `myApp/mymodel_detail.html`
    """
    model = MyModel

但这不会显示为包含模型/模板引用的文档文本。我该怎么办？

Answer 1

结果没有显示

:template:

，因为冒号后面有多余的多余空间。