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

Question

在Django documentation中有一个简短的信息，介绍如何记录模型、视图和其他文件，以便在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:，因为冒号后面有多余的不必要的空间