Agregar título de toctree a PDF de LaTeX con Sphinx
Publicado: 2021-03-26Si tienes tu documento de Sphinx separado por secciones, con varios toctree
, cada uno con su título respectivo, resulta algo decepcionante saber que únicamente el título del primer toctree
hace su aparición en el PDF.
Para hacer que las demás divisiones aparezcan en el índice, hay que agregar instrucciones en LaTeX. Como de manera predeterminada tenemos capítulos por cada entrada en reStructuredText, podemos crear partes para insertar contenido.
Por ejemplo, si tenemos los siguientes toctree
:
.. toctree:: :maxdepth: 1 :caption: Título del toctree archivo_1 archivo_2 .. toctree:: :maxdepth: 1 :caption: Este título ya no aparece en LaTeX archivo_3 archivo_4
Para hacer que el título del segundo toctree
aparezca en LaTeX, más no duplicado en HTML, podemos agregar una directiva raw
:
.. toctree:: :maxdepth: 1 :caption: Título del toctree archivo_1 archivo_2 .. raw:: latex \part{Este título ya no aparece en LaTeX} .. toctree:: :maxdepth: 1 :caption: Este título ya no aparece en LaTeX archivo_3 archivo_4
De esta manera, el título del segundo toctree
ya aparecerá en LaTeX tanto como en HTML, sin afectar el sitio web.