3. Añadir contenidos

Jupyter Book admite muchos tipos de archivos para incluir en un libro. En general, estos son los tipos de contenido soportados por Jupyter Book:

• Archivos Markdown: archivos de texto escritos en CommonMark o en MyST Markdown.

• Jupyter Notebooks: también conocidos como archivos .ipynb. Estos archivos pueden contener celdas Markdown con MyST Markdown. Un cuaderno Jupyter puede utilizar cualquier núcleo de programa que implemente el protocolo de mensajería Jupyter para ejecutar código. Hay kernels disponibles para Python, Julia, Ruby, Haskell y muchos otros lenguajes.

• Cuadernos MyST Markdown: se trata de archivos Markdown (terminados en .md) que se convertirán en un cuaderno y se ejecutarán.

• reStructuredText: archivos de texto utilizados por el motor de documentación Sphinx (que es utilizado por Jupyter Book). Se recomienda utilizar MyST Markdown en su lugar.

• Formatos de cuaderno personalizados: cualquier otro tipo de archivo puede ser auto-convertido antes de su ejecución asignándole una función Python personalizada, por ejemplo las proporcionadas por la herramienta de conversión Jupytext.

Para más información, ver la documentación sobre tipos de contenido.

En los siguientes apartados de este capítulo se describen los formatos Markdown (.md) y Jupyter Notebook (.ipynb) y se explica cómo añadir un fichero Jupyter Notebook al libro. De forma similar se pueden añadir ficheros de texto enriquecido en Markdown (formato .md).