Herramientas. Python-pptx

Índice.

Una vez que sabemos acceder a los objetos que componen una diapositiva, lo que nos ha servido para poner título a la presentación y añadir una breve explicación sobre el contenido, vamos a seguir aprendiendo a manejar otros componentes que normalmente forman parte de una presentación del tipo de las que nos interesa automatizar.

Para ello, siguiendo el listado de contenidos que expuse en la entrada precedente, vamos a tratar en ésta sobre el índice de la presentación. Este componente lo encontramos en el modelo 1 de diapositiva, el cual contiene un objeto título y un objeto de propósito general que nosotros, posteriormente utilizaremos para incluir nuestro índice. Para crear este modelo de diapositiva, primero la creamos del mismo modo que hicimos con la primera (diapo2 = mi_presenta.slide_layouts[1]), aunque especificando que será de tipo 1, y después a añadimos a la lista de objetos diapositivas del objeto presentación (diapo2 = mi_presenta.slides.add_slide(diapo2)). Como ves, se trata del mismo procedimiento que nos sirvió para crea la primera diapositiva y que nos servirá para crear las siguientes.

Una vez creada la diapositiva procedemos a poner el título, que será el mismo que pusimos en la primera diapositiva, aunque podría ser uno específico ("ÍNDICE", por ejemplo). En este caso el procedimiento que empleamos para poner el título en la diapositiva anterior lo vamos a desarrollar en dos fases, pero el resultado es el mismo, por lo que se trata simplemente de un procedimiento alternativo (bien podría ser como sigue: titulo2 = diapo2.shapes.title):

• Primero accedemos a la clase formas de la clase diapositiva (formas = diapo2.shapes)
• Y después a la forma title (título) presente en nuestra diapositiva en función del modelo (de diapositiva) que solicitamos crear en el paso anterior (titulo2 = formas.title)
• Finalmente añadimos el texto (titulo2.text = "Presentación con python.")

Ahora estamos en disposición de entrar en materia, esto es, de escribir el índice que deseamos en la segunda forma, para lo que deberemos acceder a ella (esquema = formas.placeholders[1]) y después la conformamos como nos interesa (tesquema = esquema.text_frame), esto es, como un text_frame, ya que inicialmente se trata de un contenedor de tipo general (placeholders). Observa que hemos utilizado la variable formas que dotamos de contenido antes, dando ahora sentido al procedimiento explicado.

Aunque en nuestra presentación hemos optado por incluir contenido del nivel superior (tesquema.text = "Índice de contenidos."), podemos prescindir de ello, según el modo en que pensemos redactar el índice. Por ejemplo podemos hacer que el título principal de la diapositiva sea "ÍNDICE" y el índice propiamente dicho no tenga título, ocupando los epígrafes principales ese nivel. Te animo a que investigues esta opción.

Dejando pendiente esta cuestión, vamos a ver cómo incluimos los contenidos del esquema y cómo identificamos el nivel al que pertenece. Para ello tomaré como ejemplo el primer componente, ya que el resto se resuelve por repetición del procedimiento.

1. Añadimos el parágrafo a la lista del conjunto de objetos parafraph (p1 = tesquema.add_paragraph())
2. Dotamos de contenido textual a ese elemento (p1.text = "Título y subtítulo")
3. Y finalmente indicamos el nivel al que pertenece (p1.level = 1), que en este caso es el primer nivel, pero que en otros, como el asignado a la variable p4a es el segundo (p4a.level = 2)

La repetición de este procedimiento nos permite crear, de forma sencilla, el índice de la presentación. Dado que se trata de una mera repetición de las mismas instrucciones, no es difícil simplificar el procedimiento mediante el uso de listas y bucles, pero de momento es incluso preferible que lo hagamos de forma repetitiva para asegurarnos el dominio de dicho procedimiento.

Documento. En este enlace puedes acceder al script que incluye el código explicado en esta entrada. Incluyo una modificación de la estructura del script para mejorar la diferenciación de sus partes.