Un Quarto de DDL, Sambayón y Menta Granizada, please.

saxa.xyz/charla-quarto

Sasha K.

Un problema

from numpy.random import randint
import matplotlib.pyplot as plt

n_pasos = 100
n_caminatas = 3
pasos = 2*randint(0,2, (n_pasos, n_caminatas)) - 1
caminatas = pasos.cumsum(axis=0)
plt.plot(caminatas)

Trayectorias de tres caminantes en busca de sus helados

Intro

Setup de Quarto y VSCode

> quarto help

Instalamos la extensión de Quarto para VSCode

> vscodium --install-extension quarto.quarto

Configuramos el ambiente virtual de python1, es necesario instalar jupyter

> python -m venv .venv 
> .\.venv\Scripts\Activate.ps1 
> python -m pip install jupyter matplotlib numpy 
> vscodium . 

El notebook de Quarto

Los archivos tienen extensión .qmd

# Un documento

Que es un `markdown` con esteroides 

$E=mc^{2}$

El Front Matter contiene la metadata del documento

---
title: "Caminatas Aleatorias"
format: default
---

Celdas ejecutables

```python
#| code-line-numbers="false"
caminata = numpy.random.rand(100,1)
```

Renderizar un documento

Tenemos distintos tipos de documentos de salida

> quarto render documento.qmd --to pdf

Note

Quarto utiliza Pandoc para transformar los documentos. ver lista con los formatos disponibles

No more \(\LaTeX\), por favor.

Un nuevo lenguaje para typesetting: Typst

Un nuevo tipo de documento

El Manuscrito (Manuscript)

Creamos un nuevo proyecto

> quarto create project manuscript
 ? Directory » manuscrito
Creating project at 
manuscrito:
  - Created _quarto.yml
  - Created .gitignore
  - Created index.qmd
  - Created references.bib

Tip

Hay varios tipos de projectos: website, blog, manuscript, book, confluence, ver ejemplos

Publicar nuestros documentos

Publicar a GitHub Pages

> quarto publish gh-pages

Manuscrito saxa.xyz/man-quarto

Configurar GitHub Actions

Guía

quarto-actions

Gracias! 🍧

Un par de toppings

formatos de revistas para publicar

quarto-live

Materiales de esta charla

akielbowicz/pyday-la-plata-2024

Materiales en YT

Videos del canal de Posit

Charlas y videos de Mine Çetinkaya-Rundel