Sphinx：将输出html拆分成比输入文件更小的页面 [英] Sphinx: split output html into smaller pages than input files

问题描述

假设我有一个Sphinx索引文件

.. toctree::

   foo
   bar

并且文档Foo只有一个标题

***
Foo
***

All about foo.

而酒吧有两个

***
Bar
***

All about Bars.

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

All about ex-parrots.

如果我将其编译为HTML，它将创建三个页面；index、foo和bar。但假设我希望Parrot有自己的HTML页面。有什么方法可以在不拆分bar源文件的情况下实现这一点吗？

推荐答案

遗憾的是，根据IRC上的ReadTheDocs开发人员的另一个问题的回答，他们目前只构建了一个.html文件。

来源：https://stackoverflow.com/a/32788289/3750804

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

http://mkdocs.org

这篇关于Sphinx：将输出html拆分成比输入文件更小的页面的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！