如何在 reStructuredText (sphinx) 中嵌入 HTML 或 XML，以便浏览器 cna 呈现它们？

Question

我只需要在 reStructuredText (sphinx) 中嵌入一小段 html 或 xml，以便浏览器可以在生成的 HTML 文件中呈现它们，如下面的小块

.. raw:: html
  <a href="testurl">testurl</a>

或者

.. raw:: html
  <math><apply><plus/><ci>a</ci><apply><minus/><ci>b</ci><ci>c</ci></apply></apply></math>

无论我尝试过像“literal”、“raw”、“container”、“code”这样的指令，html代码都显示为某些“p”块的内部文本（因此浏览器显示代码而不是渲染它） ，或者代码从输出中消失。

在 reStructuredText (sphinx) 中嵌入 html 或 xml 以便浏览器可以呈现它们的正确方法是什么？我只想将 html 或 xml 原封不动地放在那里。

Answer 1

您需要在raw指令和代码之间添加一个空行。

.. raw:: html

    <a href="testurl">testurl</a>

我建议缩进 4 个空格以与 Python 格式保持一致，但 2 个空格很好。