微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

在 RST 中嵌入 html 文档

如何解决在 RST 中嵌入 html 文档

我有一个基于 Sphinx 的网站,并且有特定的页面,我想在这页面显示存储在指定目录(如 _static)中的预定义 html 文件。在 Django 中,可以使用 {{%include}} 标签简单地从模板中引用文件,ReStructuredText 是否存在类似的东西?

我想做类似的事情

.. title:: Example Page

=============
Example Page
=============

Introduction to page

<insert html reference to _static folder here>

Description

建立网站后,将 RST 生成的 html 和指定的 html 文件结合起来。

解决方法

来自 docutils docs for the raw directive

原始数据也可以从外部文件中读取,在指令选项中指定。在这种情况下,内容块必须为空。例如:

.. raw:: html
    :file: inclusion.html

“raw”指令的内联等效项可以通过从 custom interpreted text roles 派生的 "raw" role 定义。

识别以下选项:

file : 字符串(删除换行符) 要包含的原始数据文件的本地文件系统路径。

如果您只嵌入片段,而不是完整的有效 HTML 页面,那么这就是您想要使用的。对于后者,您仍然可以使用 raw,但使用 <iframe>:

.. raw:: html

    <iframe src="inclusion.html"></iframe>

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。