Introducción

Esta guía proporciona una visión general de cómo integrar Python con Quarto. Adecuado tanto para principiantes como para usuarios experimentados, este recurso proporciona instrucciones sencillas sobre cómo configurar Python y Jupyter para trabajar con Quarto, permitiéndote ejecutar bloques de código Python dentro de tus documentos. Esto es lo que aprenderás:

  • Instalación y configuración: Instrucciones para instalar Python y Jupyter, y verificar tu configuración con Quarto.
  • Ejecución de código Python: Detalles sobre cómo insertar y ejecutar bloques de código Python, y cómo manejar código en línea para actualizaciones en tiempo real en tus documentos.
  • Ejemplos prácticos y consejos: Incluye ejemplos que muestran cómo utilizar Python en los documentos de Quarto, junto con consejos sobre la representación y la integración de código de manera efectiva.
  • Funciones avanzadas: Sumérgete en funcionalidades avanzadas como el uso de expresiones en línea y la adición de markdown dentro de las salidas de código a través de IPython.


Requisitos previos

Instala Python 3 y el paquete jupyter.

Instalar usando uno de los siguientes métodos:

  1. Uso de Pip:
    • Mac/Linux: python3 -m pip install jupyter
    • Windows: py -m pip install jupyter
  2. Uso de Conda: conda install jupyter

Verifica que Quarto está configurado correctamente para Jupyter con:

Terminal
quarto check jupyter

Bloque de código

Bloques ejecutables de código Python ```{python}. Ejemplo:

---
title: "Código Python"
jupyter: python3
---

Ejemplo de código: 

```{python}
print("Hellow World")
```

Código en línea

  • Incrustar código en vivo en markdown con una sola marca () en lugar de triple (```).
  • Ejemplo: Establecer radius en un bloque de código y referenciarlo en el texto con código inline.
```{python}
radius <- 5
```

El radio del círculo es `{python} radius`
Importante
  • Las expresiones en línea en archivos .qmd se autoevalúan cuando se renderizan o previsualizan.
  • Para las expresiones en línea del cuaderno, debes ejecutar: quarto render notebook.ipynb --execute. Alternativamente, puedes habilitar la ejecución dentro de la parte YAML del cuaderno (ver más abajo).
---
title: "Mis Notebooks"
execute:
  enabled: true
---

Usar IPython.display.Markdown para incluir sintaxis markdown en expresiones inline:

```{python}
radius = 10
from IPython.display import Markdown
```

El radio del círculo es `{python} Markdown(f"_radius_ = **{radius}**.")`

Renderización

Leer renderizar documentos Quarto que contengan bloques de código Python o R.

Referencias

Volver arriba