Sphinx乳胶目录-避免包含的第一个文件的toctree嵌套

Question

我有一个具有以下结构的sphinx文档：

My chapter title
=====================

Chapter intro part 1
--------------------------
Brief introduction that I would like to have in the start of this chapter...

Chapter intro part 2
--------------------------
Another short section ...


.. toctree::
   :hidden:
   :maxdepth: 2

   folder/subchapter1
   folder/subchapter2

当我基于此呈现html时，事情将按预期工作-我有本章的起始页，并且我的子章可从侧面菜单获得。

但是，当我构建乳胶/ PDF输出时，层次结构在目录和编号中的结构如下：

0.2 My chapter title
- 0.2.1 Chapter intro part 1
- 0.2.2 Chapter intro part 2
  - 0.2.2.1 subchapter1
  - 0.2.2.2 subchapter2

我想拥有的东西在下面：

0.2 My chapter title
- 0.2.1 Chapter intro part 1
- 0.2.2 Chapter intro part 2
- 0.2.3 subchapter1 title
- 0.2.3 subchapter2 title

或替代：

0.2 My chapter title
0.2.1 subchapter1 title
0.2.2 subchapter2 title 

我意识到这可能是尝试“破解” toctree概念，但是我试图同时用相同的代码满足html和Latex的层次结构要求。

我正在使用Sphinx 1.8.5和默认的乳胶构建设置。

Answer 1

在conf.py中我添加了：

if tags.has("output_html"):
    exclude_patterns.append("*/intro.rst")

并且在我的构建过程中，我添加了标签output_html，因为在html中无法访问标准conf.py标签。这样我就得到了我想要的。