Python sphinx Sphinx:将输出html拆分为比输入文件更小的页面

Python sphinx Sphinx:将输出html拆分为比输入文件更小的页面,python-sphinx,Python Sphinx,假设我有一个斯芬克斯索引文件 .. toctree:: foo bar 而foo文档只有一个标题 *** Foo *** All about foo. 酒吧里有两个 *** Bar *** All about Bars. ****** Parrot ****** All about ex-parrots. 如果我把它编译成HTML,它将创建三个页面索引,foo和bar。但是假设我想让Parrot拥有自己的HTML页面。有没有一种方法可以在不拆分源文件的情况下实现这一点

假设我有一个斯芬克斯索引文件

.. toctree::

   foo
   bar
而foo文档只有一个标题

***
Foo
***

All about foo.
酒吧里有两个

***
Bar
***

All about Bars.

******
Parrot
******

All about ex-parrots.

如果我把它编译成HTML,它将创建三个页面<代码>索引,
foo
bar
。但是假设我想让Parrot拥有自己的HTML页面。有没有一种方法可以在不拆分源文件的情况下实现这一点?

不幸的是,根据irc上ReadTheDocs开发者提出的另一个问题的答案,他们目前只构建了一个.html文件

资料来源:

如果您正在寻找一个可以提供多个HTML文件的工具(不幸的是,它会失去PDF构建支持),请查看MkDocs,它也可以托管在readthedocs.org上


这不完全是您想要的,但可能
。include::
指令适合您?我有一个巨大的源文件(来自一本旧式手册),并使用注释书签将其中的部分包含在较小的文件中,这些较小的文件分别呈现为html。例如:

在myBigFile.rst中:

***
Bar
***

All about Bars.

.. marker_start_here:

******
Parrot
******

All about ex-parrots.

.. marker_end_here:

Other stuff you don't want in your smaller file ...

然后在单独的文件中,您有:

.. include:: myBigFile.rst
   :start-after: marker_start_here
   :end-before: marker_end_here

如果您不想将myBigFile的扩展名包含在目录树等中,则可能需要更改其扩展名,这样,如果包含的位自动链接了节标题,则可以避免重复节标题错误。

与另一个问题非常相似,答案似乎是“否”。