Sphinx-apidocs无法从python代码生成TODO文档

Question

我安装了Sphinx api文档，该文档从我的python代码生成html文档。因此，唯一缺少的是它没有生成＃TODO文档。

我检查了不同的网站和Sphinx api-doc文档，并检查了我的配置，看起来不错。

这是我的配置：

config.py

extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.todo',
'sphinx.ext.viewcode',
]

todo_include_todos = True

并且在设置快速入门时，

todo：编写可在构建时显示或隐藏的“ todo”条目（y / n）[n]：y

以及.py文件中的文档

def post(self):
    """
    Adds a :class:`Persona` resource in Persona resource list.

    :returns: A newly created Persona resource with http 201 response code.
    """
    args = parser.parse_args()
    persona_id = int(max(PERSONAS.keys())) + 1
    persona_id = '%i' % persona_id
    PERSONAS[persona_id] = {'name': args['name']}

    # TODO Validate all post fields

    return PERSONAS[persona_id], 201

以上生成的代码文档，但＃TODO部分不在生成的文档中。

Answer 1

Sphinx对# TODO注释不做任何事情。

Sphinx可以做的是处理用特殊todo指令指定的待办事项。它可以包含在文档字符串中：

todo