对于我项目的大多数文档,我更喜欢标准的sphinx布局。但是对于登陆页面,我更喜欢使用自定义HTML / CSS / JS,而不使用普通sphinx站点的任何布局,TOC或侧边栏。有没有办法在sphinx生成的网站中包含原始HTML独立页面,完全忽略网站其他部分的正常布局?
作为一个反例,我知道我可以使用以下内容将原始HTML位包含到页面中(另请参阅this question)
.. raw:: html
:file: myfile-html
然而,这只是在正常布局中嵌入一个文件。我想有一个完全独立的HTML页面。
答案 0 :(得分:0)
我自己刚刚遇到了这个问题,我解决它的方法是简单地将 html 文件包含在我的 source/_static
文件夹中,然后使用相对链接引用它。
因此,如果 source/_static/my_standalone.htm
是我的非生成 HTML 文件所在的路径,而我要在其中键入链接的 .rst 文件位于 source/otherfolder/index.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!