Sphinx HTML构建器渲染功能

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

我在raw文件中包含了rst指令:

.. raw:: html

   < html here >

在HTML中,有一个动态放置的字符串,其中包含reStructuredText。由于它被放置在raw指令中,因此它不会呈现为HTML,而是保留reStructuredText。

因此,我如何访问sphinx的渲染函数,以便我可以手动生成HTML,因为它将自动生成在raw指令之外?

我读了几个sphinx文件,但我可能缺少一些基本信息。

我的理解是:

  • jinjia用于模板渲染但不用于文件转换
  • sphinx有各种构建器,一个是html构建器(例如make html

我尝试使用pandoc接口,但是pandoc产生的不同于sphinx的HTML。所以我需要访问sphinx转换函数。

似乎docutils用于转换,但独立运行它也会产生不同的html。所以我假设sphinx使用了一个我不知道的模板。

谢谢!

python python-sphinx
1个回答
1
投票

使用带有HTML的开头raw指令,然后是你的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>
© www.soinside.com 2019 - 2024. All rights reserved.