Evite el anidamiento de subsecciones en Python Sphinx cuando se usa toctree

Tengo un problema al estructurar mi guía de usuarios de Sphinx. Me gustaría formar un capítulo teniendo una página de inicio principal (index.rst) que contenga el encabezado del capítulo y una descripción general, y luego subsecciones separadas contenidas en diferentes archivos (part1.rst, part2.rst). Estoy tratando de usar “toctree” para insertar las subsecciones separadas, pero me estoy topando con un problema de anidamiento donde mi toctree está siendo absorbido por mi sección de información general. (nota: no estoy usando la directiva ..include:: porque quiero que las subsecciones se muestren en diferentes páginas web vinculadas secuencialmente. También quiero que estén estructuradas correctamente para que se vean bien en la versión procesada en pdf de la UG).

index.rst

 Chapter 3 =============================== Overview -------- Yadda yadda yadda. .. toctree:: :hidden: part1 part2 

part1.rst

 Part 1 ------ This part is all about yadda. 

part2.rst

 Part 2 ------ More yadda. 

Me gustaría que la estructura resultante fuera:

 Chapter 3 - overview - part 1 - part 2 

Pero lo que estoy consiguiendo es

 Chapter 3 - overview - part 1 - part 2 

Parece que el toctree que incluyo al final del archivo se encuentra en la sección “descripción general”, en lugar de ejecutarse en el contexto del capítulo principal. Intenté insertar el toctree en la parte superior del archivo, pero luego obtengo este pedido:

 Chapter 3 - part 1 - part 2 - overview 

Parece que debe haber una manera de hacer esto correctamente, pero no he podido encontrar nada en el sitio de Sphinx o aquí en SO. Cualquier ayuda es apreciada.

Tuve exactamente el mismo problema y no pude encontrar una buena solución. Las únicas opciones parecían ser eliminar el subtítulo (‘Información general’ en el ejemplo anterior) o marcarlo como una rúbrica, por ejemplo

 .. rubric:: Overview 

lo que significa que no se incluye en el TOC. Debería ser posible aplicar un estilo a la rúbrica para que parezca un subtítulo, pero hacerlo de esta manera se siente como un truco.