Uso de cuadernos de Jupyter con Academic
Aprende cómo escribir artículos con cuadernos de Jupyter
Detalle de cuaderno de Jupyter. Créditos: venía con el artículo de Wowchemy
Este artículo da por supuesto que sabes lo que es Jupyter, los cuadernos de Jupyter y otros conceptos de Python.
En la imagen se muestra un detalle de un cuaderno de Jupyter con una primera celda con código Python:
from IPython.core.display import Image
Image('https://www.python.org/static/community_logos/python-logo-master-v3-TM-flattened.png')
Luego muestra esta imagen:
Y finaliza con:
print("Welcome to Academic!")
Instalar Python y JupyterLab
Para instalar Python y JupyterLab proponen Anaconda, justo la opción que menos me gusta. Pasemos a la siguiente opción, que es la de tener Python y pip ya instalado y usar este gestor de paquetes Python para instalar JupyterLab con pip3 install jupyterlab.
Crea o sube un cuaderno de Jupyter
Ejecuta el siguiente código en tu emulador de terminal favorito (son tres líneas y tres sentencias):
mkdir -p <MY-WEBSITE-FOLDER>/content/post/<SHORT-POST-TITLE>/
cd <MY-WEBSITE-FOLDER>/content/post/<SHORT-POST-TITLE>/
jupyter lab index.ipynb
Siendo:
<MY-WEBSITE-FOLDER>la ruta del sitio web con el tema Academic de Hugo.<SHORT-POST-TITLE>el titulo/nombre del artículo, con las palabras en minúsculas separadas por guiones medios.
Es decir, tienes que crear un directorio en la carpeta content/post, que es la forma de crear el contenido en Hugo, luego ir a ese directorio y desde ahí crear el cuaderno de Jupyter o bien copiarlo de otro sitio donde lo tengas.
Edita los metadatos del artículo
La primera celda del cuaderno ha de contener los metadatos tal como está especificado en front matter. Esta celda estará en Markdown pero tendrá sintaxis YAML:
---
title: El título de mi artículo
date: 2023-08-08
# Más metadatos son posibles...
---
Puedes añadir más metadatos tal como aparece en la documentación](https://sourcethemes.com/academic/docs/managing-content).
Para tener una imagen destacada hay que situar una imagen en el directorio que incluya en su nombre la palabra featured.
Convierte el cuaderno en Markdown
Con jupyter se puede convertir el cuaderno en markdown:
jupyter nbconvert index.ipynb --to markdown --NbConvertApp.output_files_dir=.
Ejemplo
El siguiente artículo fue escrito de esta manera.
