如何在 reStructuredText (sphinx) 中嵌入 HTML 或 XML 以便浏览器可以渲染它们?

问题描述 投票:0回答:1

我只需要在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”块的inner text(因此浏览器显示代码而不是渲染它),或者代码只是从输出中消失

在 reStructuredText (sphinx) 中嵌入 html 或 xml 以便浏览器可以渲染它们的正确方法是什么?我只想将 html 或 xml 完好无损地放在那里。

python-sphinx restructuredtext
1个回答
12
投票

您需要在

raw
指令和代码之间添加一个空行。

.. raw:: html

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

我建议缩进 4 个空格以与 Python 格式保持一致,但 2 个空格也可以。

© www.soinside.com 2019 - 2024. All rights reserved.