¿Cómo crear libros interactivos con Jupyter Book?#
Con las herramientas de Jupyter, podemos crear libros interactivos que combinan texto, HTML y código de programación que puede ser ejecutado y modificado a voluntad.
A continuación vamos a ver un ejemplo de un libro de programación interactivo construido con Jupyter Book.
Jupyter Book#
Jupyter Book es una herramienta open-source para crear libros y documentos PDF de calidad, con contenidos interactivos de código fuente de programación informática. Ver la documentación en inglés
Jupyter Book permite a los usuarios
escribir contenidos en ficheros markdown (.md) y Jupyter Notebooks (.ipynb),
incluir elementos de programación (ej. código de programación) en ambos tipos, markdown y notebooks,
incluir referencias bibliográficas y ecuaciones matemáticas, y
usar un comando para ejecutar código embebido, cache el resultado y, finalmente,
convertir el contenido de los ficheros markdown y notebooks en:
un libro interactivo para verlo en un browser (web-based interactive book) y
una publicación PDF de calidad.
Algunas de las funcionalidades principales de Jupyter Book son las siguientes:
- Escribir contenidos en Markdown
El contenido puede estar en Jupyter markdown, o bien en una versión de markdown extendido con funciones de publicación avanzada. Por ejemplo, pueden incluirse fácilmente contenidos en formato editorial como referencias bibliográficas, ecuaciones matemáticas y gráficos.
- Añadir código fuente directamente como ficheros Jupyter Notebooks
Esto permite incluir tanto el código como el resultado (output) de la ejecución directamente en el libro. Del mismo modo, también pueden escribirse notebooks enteramente en markdown para ejecutar cuando se genera el libro con el comando ‘build’ como veremos más adelante.
- Ejecutar y guardar en memoria cache el contenido del libro
Para ficheros Notebooks
.ipynb, permite ejecutar código e insertar los últimos outputs. Esto permite además, guardar en cache y re-utilizar los outputs posteriormente.- Insertar los outputs en el libro
Se pueden insertar outputs a medida que se genera la documentación y añadirlos in-line con el resto de la página.
- Añadir interactividad al libro
Por ejemplo, se puede alternar la visibilidad de una celda, incluir outputs interactivos desde Jupyter y ejecutar el código conectando con servicios online como Binder, Google Colab y Deepnote.
- Generar libros en HTML, PDF y otros formatos
Esto incluye single- y multi-page websites, así como PDF.
- Un libro se genera con un simple comando
Por ejemplo,
jupyter-book build mybook/
Colabora#
¡Colabora con Jupyter Book!
Jupyter Book es una open community que agradece el feedback, input y las muestras de interés.
- Abir una cuestión (issue)
para proporcionar feedback y nuevas ideas o comunicar problemas.
- Votar por nuevas funcionalidades
añadiendo 👍 a las cuestiones (issues) que deseas ver resueltas.
- Contribuir a Jupyter Book
siguiendo nuestra guía de participación e identificando una cuestión (issue) para trabajar en su resolución. Ver la tabla de votación de funcionalidades como ejemplo.
- En español puedes contactar con Publiconsulting Media
para comentarios e ideas en español.