Apéndice C — Hoja de referencia
Quarto, publicación reproducible, agentes de programación, Markdown, Python, EPUB, análisis de datos, k-means
Una referencia de una página para los patrones que usa este libro, con el capítulo que explica cada uno.
Encabezado YAML
Una sola fuente, varios formatos (Capítulo 7):
---
title: "Project Report"
author: "Author Name"
date: today
format:
html:
toc: true
format-links:
- docx
- {format: typst, text: PDF}
docx: default
typst:
papersize: a4
pptx: default
revealjs:
output-file: report-slides.html
epub:
toc: true
lang: en
---Celdas de código y código en línea
Las opciones van al principio de una celda, como comentarios #| (Sección 7.4):
#| label: fig-namenumera la figura y permite que el texto la mencione como@fig-name.#| echo: falseoculta el código y muestra la salida.#| eval: falsemuestra el código sin ejecutarlo.#| fig-cap: "…"es el pie debajo de una figura.#| fig-alt: "…"es el texto alternativo que anuncian los lectores de pantalla.#| tbl-cap: "…"es el pie de una tabla.#| output: asistrata el texto impreso como Markdown.
El código en línea pone un valor calculado en una oración (Sección 7.3):
The dataset contains `{python} len(df)` rows across `{python} df['year'].nunique()` years.Dashboards
Un título de nivel 1 empieza una página, uno de nivel 2 una fila, y la salida de cada celda se convierte en una tarjeta (Sección 8.1):
---
title: "Operations dashboard"
format: dashboard
---
# Overview
## Row {height=30%}
::: {.valuebox icon="trophy" color="primary"}
Most visited
`{{python}} top_name`
:::
## Row
```{python}
#| title: Visits by attraction
fig = px.bar(attractions, x="visits_2025", y="attraction")
fig
```Asigna las figuras de Plotly y termina la celda con fig; nunca llames a fig.show() en un dashboard.
Sitios web
_quarto.yml convierte una carpeta en un sitio web (Sección 9.3, Sección 23.4):
project:
type: website
execute-dir: project
pre-render: scripts/analysis.py
render:
- index.qmd
- report.qmd
website:
title: "My project"
navbar:
left:
- {text: Report, href: report.qmd}
- text: Downloads
menu:
- {text: "Report (PDF)", href: report.pdf}
execute:
freeze: falseComandos
| Comando | Hace |
|---|---|
uv init --bare |
inicia un proyecto de uv en esta carpeta |
uv add pandas matplotlib |
agrega paquetes a pyproject.toml y a uv.lock, y los instala |
uv run quarto preview file.qmd |
renderiza y sirve una página, y la vuelve a renderizar cada vez que se guarda |
uv run quarto render file.qmd |
renderiza un archivo en todos sus formatos; --to docx para un solo formato |
uv run quarto render |
renderiza todo el proyecto |
uv run quarto publish gh-pages |
la primera publicación en GitHub Pages, interactiva |
uv run quarto publish gh-pages --no-prompt |
las actualizaciones siguientes, una vez que existe la rama gh-pages |
uv run quarto check jupyter |
muestra qué Python y qué Jupyter va a usar Quarto |
Revisar y deshacer con Git
Ejecútalos en la carpeta del proyecto, antes y después de cada cambio, tuyo o del agente (Sección 5.4, Sección 5.5, Sección 9.1):
| Comando | Hace |
|---|---|
git init -b main |
inicia un historial en esta carpeta, en una rama llamada main (una vez por proyecto) |
git status |
enumera los archivos cambiados, agregados o sin seguimiento desde el último commit |
git diff |
muestra los cambios todavía no agregados, línea por línea: - la línea vieja, + la nueva |
git add . |
agrega todos los cambios al próximo commit; git add report.qmd agrega un solo archivo |
git commit -m "What changed" |
registra los cambios agregados como un commit, con un mensaje que dice qué cambió |
git log --oneline |
enumera los commits, del más reciente al más viejo, uno por línea |
git restore data/visits.csv |
descarta los cambios sin commit de un archivo y lo devuelve a su último commit |
Prompts
Un prompt confiable (Sección 2.6):
- Nombra las entradas y las salidas: nombres de archivo y de columna, entre comillas invertidas.
- Hace una sola tarea.
- Termina con una comprobación: “renderízalo y dime qué archivo escribió”, “comprueba que el PDF tenga una página”.
- Respeta los datos: “calcula cada número a partir de los archivos citados; nunca inventes uno”.