能否直接加载XML格式的docutils节点？是否有可解析的节点树格式？

Docutils文档基于节点层级结构，官方说明其节点为类XML格式，支持将文档及文档片段导出为XML，还提供了描述节点XML格式的DTD规范。

我希望通过非Python工具生成Docutils节点，将其序列化为机器可读格式后，在Sphinx插件中通过Docutils加载。但我尝试寻找加载符合DTD规范的完整XML文档或XML片段并还原为节点树的方法，却没找到相关方案。

核心问题：

• 是否存在将Docutils XML格式反向解析为节点的方式，也就是Node.asdom()的逆操作？
• 更广泛地说，是否存在任何可被Docutils加载、用于描述节点树的机器可读格式？XML或其他格式均可。

可行解决方案 #

1. XML反向解析：利用Docutils内置XML阅读器

Docutils内置了XML格式解析器，可通过docutils.readers.xml.Reader加载符合DTD规范的XML文档，还原为节点树。示例代码：

from docutils.readers.xml import Reader

# 符合Docutils DTD的XML内容
xml_content = """<document xmlns="http://docutils.sourceforge.net/docs/ref/docutils.dtd">
    <paragraph>测试内容</paragraph>
</document>"""

reader = Reader()
# 解析XML生成节点树
document = reader.read(xml_content, parser=None, settings={})

# document即为还原后的节点树，可直接在Sphinx插件中使用

若处理XML片段，只需将片段包裹在合法根节点（如<document>或<fragment>）内再解析即可。

2. 其他可加载的机器可读格式

除XML外，Docutils还支持两种实用格式：

• Pseudo-XML格式：这是一种简洁的类XML格式，既适合人类阅读，也容易被非Python工具生成。Docutils提供docutils.readers.pseudoxml.Reader用于反向解析，示例代码：

from docutils.readers.pseudoxml import Reader

pseudoxml_content = """\
<document>
  <paragraph>
    测试文本
  </paragraph>
</document>"""

reader = Reader()
document = reader.read(pseudoxml_content, parser=None, settings={})

这种格式不需要严格的XML语法（比如可省略闭合标签的斜线），灵活性更高。

• Docutils Native格式：基于Python的pickle序列化，可直接读写节点树，但仅支持Python环境，非Python工具生成难度大。

注意事项 #

• 使用XML解析时，需确保XML严格符合Docutils的DTD规范，否则会触发解析错误。
• Pseudo-XML格式更适合非Python工具生成，语法门槛更低。

内容的提问来源于stack exchange，提问作者ddulaney