如何将 Sphinx 自定义指令内容解析为 docutil 节点答案

【问题标题】：How to parse Sphinx custom directive content to docutil nodes如何将 Sphinx 自定义指令内容解析为 docutil 节点
【发布时间】：2021-11-10 15:31:51
【问题描述】：

我正在尝试创建一个名为 LicenceDirective 的自定义指令，它看起来像这样：

.. licence: Some Software 3.0
   :url: https://SomeSoftware.com/downloads
   :path: /licence_file

   CONTENT

此类指令的 HTML 输出将是：

<h1 id="some-software-3-0">Some Software 3.0</h1>
<p><a href="https://SomeSoftware.com/downloads">Download page</a></p>
RST_PARSED(CONTENT)
<pre>{{content of licence_file}}</pre>

CONTENT 可以是任何有效的 RST 内容，包括格式、列表、标题等。所以我需要按原样解析它并返回结果节点以将它们与我自己的节点一起从LicenceDirective::run() 返回。有没有办法做到这一点？

【问题讨论】：

从这里开始：sphinx-doc.org/en/master/extdev/… 用您尝试过的方法更新您的答案。

标签： python python-sphinx restructuredtext docutils

【解决方案1】：

我使用nested_parse找到了解决方案，并在这里提到：

https://www.sphinx-doc.org/en/master/extdev/markupapi.html#parsing-directive-content-as-rest

【讨论】：