我在raw
文件中包含了rst
指令:
.. raw:: html
< html here >
在HTML中,有一个动态放置的字符串,其中包含reStructuredText。由于它被放置在raw
指令中,因此它不会呈现为HTML,而是保留reStructuredText。
因此,我如何访问sphinx的渲染函数,以便我可以手动生成HTML,因为它将自动生成在raw
指令之外?
我读了几个sphinx文件,但我可能缺少一些基本信息。
我的理解是:
make html
)我尝试使用pandoc接口,但是pandoc产生的不同于sphinx的HTML。所以我需要访问sphinx转换函数。
似乎docutils用于转换,但独立运行它也会产生不同的html。所以我假设sphinx使用了一个我不知道的模板。
谢谢!
使用带有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>