Sphinx：将输出 html 分割成比输入文件更小的页面

假设我有一个 Sphinx 索引文件

.. toctree::

   foo
   bar

并且文档 foo 只有一个标题

***
Foo
***

All about foo.

而酒吧有两个

***
Bar
***

All about Bars.

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

All about ex-parrots.

如果我将其编译为 HTML，它将创建三个页面；index, foo and bar。但假设我想要Parrot拥有自己的 HTML 页面。有没有一种方法可以在不分裂的情况下实现这一目标bar源文件？

不幸的是，根据 ReadTheDocs 开发人员在 irc 上的另一个问题的答案，他们此时只构建了一个 .html 文件。

Source: https://stackoverflow.com/a/32788289/3750804 https://stackoverflow.com/a/32788289/3750804

如果您正在寻找一个可以为您提供多个 HTML 文件的工具（不幸的是，同时失去了 PDF 构建支持），请查看 MkDocs，它也可以托管在 readthedocs.org 上。

http://mkdocs.org http://mkdocs.org