在sphinx文档

时间:2018-02-20 15:57:00

标签: html python-sphinx

对于我项目的大多数文档,我更喜欢标准的sphinx布局。但是对于登陆页面,我更喜欢使用自定义HTML / CSS / JS,而不使用普通sphinx站点的任何布局,TOC或侧边栏。有没有办法在sphinx生成的网站中包含原始HTML独立页面,完全忽略网站其他部分的正常布局?

作为一个反例,我知道我可以使用以下内容将原始HTML位包含到页面中(另请参阅this question

.. raw:: html
   :file: myfile-html

然而,这只是在正常布局中嵌入一个文件。我想有一个完全独立的HTML页面。

1 个答案:

答案 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!