Django管理文档生成器不格式化文件的型号

Question

我目前正在使用Django管理文档生成器记录我所有的django视图和模型。尽管我在所有文档视图中都没有遇到任何问题，但是，在我的模型的文档字符串中编写的任何内容都在文档中以明文形式呈现。

换句话说，如果我想引用一个观点：

:view:`appname.view_name` 

将呈现为一个链接（我想）如果插入到视图中的文档字符串，但将显示为“：当插入到任何模型的文档字符串中时，以明文形式显示“appname.view_name`”。但是，插入到模型的方法中时，格式将按预期工作。

起初我以为这是文档生成器的一个怪癖，也许它不会读取模型文档字符串的标记，但在阅读文档（在此处找到：https://docs.djangoproject.com/en/1.5/ref/contrib/admin/admindocs/#model-reference）之后，似乎您应该可以链接到文档的其他部分。

我还没有看到任何其他人有这个问题，我不知道从哪里开始寻找解决方案。预先感谢您的任何专业知识和解释。

编辑：

好像格式化主要模式的文档字符串完全忽略 - 也就是说，它会忽略修改案文。

例如

类为MyModel（models.Model）：

“” “

标题

”“”

将简单地显示为标题django admin docs中的明文中的。

Answer 1

当前Django管理文档生成器（在写作时为1.7）不支持模型文档中的重构文本。

这是卡#5405中解决，但仍然没有在主合并，因为它创建了一些合并冲突。最后更改：

我在pull请求上留下了评论，但它仍然需要一些改进，包括整齐地合并的rebase。提到发行说明中的​​更改也很好。