Sphinx HTML Builder - функция отображения - PullRequest
Новая
       1

Sphinx HTML Builder - функция отображения

0 голосов
/ 12 сентября 2018

Я включил директиву raw в мой файл rst: 

.. raw:: html

   < html here >

В HTML есть динамически размещаемая строка, содержащая reStructuredText. Поскольку он помещен в директиву raw, он не отображается как HTML, а остается reStructuredText.

Таким образом, как я могу получить доступ к функции рендеринга sphinx, чтобы я мог вручную генерировать HTML, как если бы он автоматически создавался вне директивы raw?

Я прочитал пару файлов sphinx, но мне может не хватить некоторой базовой информации.

Насколько я понимаю, это:

  • jinjia используется для рендеринга шаблонов, но не для преобразования файлов
  • У sphinx есть различные сборщики, один из них - сборщик html (например, make html)

Я пытался использовать интерфейс pandoc, но pandoc выдает другой HTML, чем sphinx. Поэтому мне нужно получить доступ к функции преобразования сфинксов.

Похоже, что для преобразования используется documenttils, но его автономный запуск также приводит к разным html. Поэтому я предполагаю, что sphinx использует шаблон, о котором я не знаю.

Спасибо!

1 Ответ

0 голосов
/ 13 сентября 2018

Используйте открывающую директиву raw с HTML, затем ваш reST, затем закрывающую директиву raw. 

.. raw:: html

   <html open>

Some reST stuff, oooh, a `link to the raw directive
<http://docutils.sourceforge.net/docs/ref/rst/directives.html#raw-data-pass-through>`_

.. raw:: html

   <html close>
...