Agregar título de toctree a PDF de LaTeX con Sphinx

Publicado: 2021-03-26

Si 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.

¿Tienes algún comentario?

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *