Как встроить HTML или XML в reStructuredText (sphinx), чтобы браузер мог их визуализировать? - PullRequest
0 голосов
/ 28 мая 2018

Мне просто нужно встроить небольшой фрагмент html или xml в reStructuredText (sphinx), чтобы браузер мог отобразить их в сгенерированных файлах 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""блок (поэтому браузер отображает код, а не отображает его), или код просто исчезает из вывода.

Как правильно встраивать html или xml вreStructuredText (sphinx), чтобы браузер мог отобразить их ?Я просто хочу, чтобы html или xml были помещены туда без изменений.

1 Ответ

0 голосов
/ 28 мая 2018

Вам необходимо добавить пустую строку между директивой raw и вашим кодом.

.. raw:: html

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

Я бы предложил сделать отступ в 4 пробела для соответствия форматированию Python, но 2в порядке.

...