Evite la anidación de subsecciones en Python Sphinx cuando se usa toctree
Me encuentro con un problema al estructurar mi guía de usuario de Sphinx. Me gustaría formar un capítulo teniendo una página de inicio principal (index.rst) que contenga el título 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 encuentro con un problema de anidamiento donde mi toctree está siendo absorbido por mi sección de resumen. (nota: no estoy usando el..include::
directiva porque quiero que las subsecciones se muestren en diferentes páginas web vinculadas secuencialmente. También quiero que esté estructurado correctamente para que se distribuya bien en la versión renderizada en PDF de 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 sea:
Chapter 3
- overview
- part 1
- part 2
Pero lo que obtengo 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 recibí 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.