Skip to content Skip to sidebar Skip to footer

Include Standalone Html Page In Sphinx Document

For most of my project's documentation I prefer a standard sphinx layout. However for the landing page I would prefer to use custom HTML/CSS/JS without any of the layout, TOC, or

Solution 1:

I just ran into this problem myself, and the way I solved it was to simply include the html file in my source/_static folder, then refer to it with a relative link.

So if source/_static/my_standalone.htm is the path where I have my non-generated HTML file, and the .rst file where I want to type my link is at source/otherfolder/index.rst, I write it like this in my rst:

Link to my non-Sphinx HTML file
===============================

To get to my standalone, non-generated HTML file, 
just `click here <../_static/my_standalone.html>`_ now!

Post a Comment for "Include Standalone Html Page In Sphinx Document"