Docutils：遍历部分？

Question

如何在Sphinx中遍历文档的每个节名称？

（docutils 的文档在哪里？除了 Sphinx 应用程序 API 之外，很难找到任何有用的东西；即使查看 docutils/nodes.py 的源代码也没有多大帮助。）

Answer 1

经过反复试验终于弄清楚了：/

import docutils

def doctree_resolved(app, doctree, docname):
    for section in doctree.traverse(docutils.nodes.section):
        title = section.next_node(docutils.nodes.Titular)
        if title:
            print title.astext()

def setup(app):
    app.connect('doctree-resolved', doctree_resolved)

Answer 2

docutils 的文档在哪里？

https://docutils.sourceforge.io/docs/