Contenidos

 ¿Qué es RISE?

RISE es una extensión a jupyter notebook que, en lugar de desplegar las celdas en una larga página web, las despliega en una presentación usando la librería de javascript reveal.js.

Sigue siendo una página web (al igual que el notebook), pero las celdas se agrupan en diapositivas.

¿Qué contenido puedo poner?

Puedes mezclar contenido usando las celdas de markdown y código, según necesites:

  • Markdown: texto, latex, imágenes, tablas, etc.
  • Código: código, gráficos simples o interactivos, videos, sonido, iframes, javascript, entre otros.

Como regla general, si se muestra correctamente en el notebook, se verá bien en la diapositiva. ¡Sé creativo!

 ¿Cómo instalar?

La instalación de la extensión RISE es extremadamente fácil. Basta con usar pip o conda:

pip install rise

o

conda install -c conda-forge rise

Eso hará que se agregue el botón de iniciar presentación (destacado en rojo).

También puedes agregar rise a tu archivo requirements.txt para que se instale automáticamente al generar un ambiente.

En caso de tener problemas, revisa los detalles adicionales de instalación.

¿Cómo configurar lo que está en cada diapositivas?

Paciencia, se requiere todavía un paso adicional.

En el menú de jupyter notebook, es necesario seleccionar View/Cell Toolbar/Slideshow para que permita configurar el tipo de celda para diapositiva.

Esto se requiere porque a cada celda del notebook se le agregará metadata para saber en que diapositiva debe ir (o si se debe saltar).

Eso dejará todo configurado para poder seleccionar el tipo de celda respecto a la diapositiva.

 ¿Cómo moverse por las slides?

Al hacer click en el botón "Iniciar presentación", la presentación se iniciará en la celda que esté activa.

  • Se accede a la próxima diapositiva o fragmento con Espacio (o la flecha derecha).
  • Se retrocede a la diapositiva o fragmento anterior con Shift Espacio (o la flecha izquierda).
  • Se avanza a la proxima sub-diapositiva con Page Up.
  • Se retrocede la sub-diapositiva anterior con Page Down.

Una diferencia de una presentación típica de PowerPoint es que existen 2 dimensiones: las diapositivas (slides) que avanzan de izquierda a derecha como es tradicional, pero también sub-diapositivas (subslides) que son slides opcionales y que avanzan de arriba a abajo.

Observación: En general, es dificil recordar el orden de las slides y sub-slides. Yo personalmente nunca uso sub-slides por esta razón y prefiero solo tener orden "horizontal".

¿Cómo se configuran las diapositivas?

Existen varios tipos de celda con distintas funcionalidades:

  • -: valor por defecto. La celda se muestra con la slide anterior.
  • Slide: inicia una nueva diapositiva (dirección horizontal).
  • Sub-slide: iniciar una nueva sub-diapositiva (dirección vertical).
  • Fragment: se concatena a la celda anterior, pero no se muestra inmediatamente.
  • Skip: no se muestra la celda en las diapositivas.
  • Notes: No se muestra en las diapositivas, sólo se muestra en las notas para el presentador.

¿Qué opciones hay?

Existen múltiples funcionalides accesibles con el teclado durante la presentación, pero las principales a recordar son:

  • ?: ver todos los shortcuts.
  • ,: ocultar los botones.
  • \: poner la pantalla en negro. Útil para discutir algo sin distracciones visuales.
  • ``:

Las funcionalidades se controlan con los siguientes botones:

¿Se puede editar durante la presentación?

¡Sí!

Es posible editar y ejecutar las celdas de markdown y de código durante la presentación.

Se usa el mismo sistema de doble click para acceder a modo edición, y Alt Enter para ejecutarla.

¿Cómo controlo el tamaño?

Un problema común es que al conectar el computador a otra pantalla o datashow, no se alcanza a ver en la diapositiva todo el código, texto o imagen.

Lo único que debes hacer es usar usar Ctrl + y Ctrl - para regular el tamaño (Command +y Command - en Mac), de la misma manera que regulas el tamaño de una página web.

 ¿Dónde están las notas del presentador?

Puedes abrir las notas del presentador presionando t.

Para poder usar las notas del presentador necesitas tener al menos 2 pantallas: una pública para compartir y otra para mantener privada.

Comparte tu estructura

Cuando se ejecuta código en una presentación, es una buena práctica mostrar la estructura de carpetas y los archivos con los que se va a trabajar. Eso ayudará a despejar dudas de cómo está funcionando el código. Esto se puede lograr fácilmente con comando mágicos (como %ls) o ejecutando código en bash (como !ls). La diferencia entre ambos radica en lo siguiente:

  • Los comandos mágicos son específicos y definidos por cada kernel. Pueden existir comandos que estén en python pero no en R.
  • Los ! permiten ejecutar instrucciones en el terminal y es más flexible. Uno de los más comunes es ofrecer instalar las librerías, como:
    pip install rise matplotlib
    

Gráficos

Para mostrar gráficos resulta práctico que no se genere una ventana adicional, sino que se agreguen a la celda de resultados. Esta es una práctica común en jupyter notebook/lab, pero es más importante aún al pensar en las diapositivas.

%matplotlib inline
from matplotlib import pyplot as plt
import numpy as np

with plt.xkcd():
    fig = plt.figure(figsize=(14,6))
    x = np.linspace(-5,5,num=100)
    y = np.abs(np.abs(np.sin(2*x)/x))
    plt.plot(x,y)

Apoyos gráficos

Me ha servido mucho insertar gifs en las presentaciones. Un buen gif animado es un buen compromiso entre una imagen y una película, y sirve para tener una animación que ilustre algun proceso. Existen muchos programas para grabar gifs. Una solución que me ha funcionado bien para animar gifs simples es crear un diagrama mediante una animación en PowerPoint, y después grabar un gif considerando apropiadamente los tiempos.