Embed external html file using iframe in Sphinx

python-sphinx restructuredtext read-the-docs
shreyasgm picture shreyasgm · Apr 22, 2016 · Viewed 9.3k times · Source

I'm trying to embed an interactive graph, which is saved as an html file, in a reStructuredText document using iframe:

.. raw:: html

    <iframe src="filename.html" height="345px" width="100%"></iframe>

The html file is in the same directory as my .rst file, but the graph does not display, and I'm getting a file could not be found error.

However, if I paste the external html file in the _build/html directory, the graph displays fine. How do I properly embed this html file, so that the graph is embedded automatically when I make html?

Working example of the thing that I want.

Answer

ostrokach picture ostrokach · Jul 11, 2017

You can also include a file directly:

.. raw:: html
   :file: filename.html

May not be what you wanted, but may help others coming here from google...

Related questions

How can I link/reference another reST file in the documentation?

I have simply no idea on how can I link to another document in the reST file. I want to link a file named install.rst to my quickstart guide in a paragraph. I don't know how can I achieve …

Read More
Adding a cross-reference to a subheading or anchor in another page

How to insert a cross-reference in a reST/Sphinx page to either a sub-header or anchor in another page in the same documentation set?

Read More
WARNING: document isn't included in any toctree for included file

I'm getting the warning: WARNING: document isn't included in any toctree for files that exist in the document because they've been explicitly included. So I have the index file: .. toctree:: :maxdepth: 2 pages/0010-foo pages/0020-bar In the file 0020-bar.rst, …

Read More