Ejercicios de la Parte II
Quarto, publicación reproducible, agentes de programación, Markdown, Python, EPUB, análisis de datos, k-means
Los cinco primeros ejercicios reúnen, en orden, el trabajo práctico de la Parte II. Cada uno nombra el capítulo que lo explica, cómo sabes que terminaste y la línea que te pone al día si no terminaste; un punto de control es el estado al final de su bloque, así que, después de ponerte al día, salta al ejercicio siguiente. El Apéndice E — Los puntos de control de un vistazo, y respuestas tiene la tabla completa. Si hiciste los pasos de los capítulos, usa estos cinco como lista de comprobación: confirma cada “terminaste cuando” y sigue. Si leíste sin hacer, hazlos aquí, en orden. Cada “terminaste cuando” pide las tres revisiones de la Tres revisiones para cada cambio donde corresponden: alcance (git status y git diff enumeran solo los archivos que querías cambiar), corrección (un número o un dato rastreado a mano hasta su fila en data/) y reconstrucción (un renderizado a partir de lo que tiene commit da el mismo resultado). Los ejercicios que siguen a estos cinco no traen prompts. En las tareas de transferencia escribes tú el prompt y la comprobación, y las preguntas de repaso comprueban si te quedaron las razones; al final hay respuestas cortas.
Inicia el agente en ~/london-guide/, al lado de ~/quarto-workshop/. Para ponerte al día se lee fuera de esa carpeta, así que aprueba la solicitud del agente para leer ../quarto-workshop.
Ejercicio II.1: Londres en Markdown
Del 6 Markdown, renderizado y reglas del proyecto. Inicia a mano el historial de la carpeta (git init -b main, un .gitignore y un primer commit); escribe london.md con un título, listas, un enlace, la foto del Big Ben con texto alternativo y crédito, una cita, una tabla a partir de data/sights.csv y un bloque de código; renderízalo y mantén una vista previa en vivo; escribe el AGENTS.md del proyecto; dale a la carpeta su propio entorno con uv. Lee el git diff de cada paso y haz commit.
Terminaste cuando london.html muestra las dos listas, la foto con su crédito, la tabla de cinco filas y la lista para marcar, uv run quarto check jupyter informa el Python del .venv de esta carpeta, un rango de precio de la tabla coincide con su fila en data/sights.csv, y git log --oneline enumera un commit por paso, con git status limpio.
¿Dos minutos sin avanzar? Pega esto en tu agente. Respalda tu trabajo y lleva el proyecto hasta este punto; luego sigue leyendo desde aquí.
Catch me up: follow ../quarto-workshop/checkpoints/01-london-markdown/README.mdEjercicio II.2: un documento que calcula
Del 7 Documentos que calculan. Cambia el nombre de la guía a london.qmd con un encabezado YAML, agrega una celda que lea data/attractions.csv y una oración con código en línea, agrega un gráfico de barras con pie y etiqueta, y luego renderiza en HTML, Word y un PDF de Typst (y, si quieres, PowerPoint, EPUB y Reveal.js).
Terminaste cuando london.html muestra el bloque del título, la oración calculada y un gráfico numerado, y london.docx y london.pdf muestran la misma oración y el mismo gráfico. Las visitas de la atracción más visitada que da la oración coinciden con su fila en data/attractions.csv, y después de tu commit, con git status limpio, uv run quarto render london.qmd vuelve a dar la misma oración.
¿Dos minutos sin avanzar? Pega esto en tu agente. Respalda tu trabajo y lleva el proyecto hasta este punto; luego sigue leyendo desde aquí.
Catch me up: follow ../quarto-workshop/checkpoints/02-london-qmd/README.mdEjercicio II.3: tres públicos a la vez
Del 8 Una guía, cinco públicos. Con un solo prompt y tres subagentes, escribe el dashboard, el informe en Word con su correo de presentación y el folleto A5; la sesión principal los renderiza uno por uno.
Terminaste cuando london-dashboard.html tiene una página Attractions con tres cuadros de valor, un gráfico de barras y uno de líneas, y una página Churches que enumera diez iglesias con enlaces a Visit London; london-email.docx abre con títulos y enlaces que funcionan; london-email-message.md contiene el correo en un solo bloque de texto; london-flyer.pdf es una página A5. Antes de hacer commit, git status enumera esos cuatro archivos fuente y nada en data/, images/ ni london.qmd.
¿Dos minutos sin avanzar? Pega esto en tu agente. Respalda tu trabajo y lleva el proyecto hasta este punto; luego sigue leyendo desde aquí.
Catch me up: follow ../quarto-workshop/checkpoints/04-london-audiences/README.mdNo hay punto de control 03: la numeración de bloques del taller se lo salta.
Ejercicio II.4: un sitio web publicado
Del 9 Publicar y demostrar la reconstrucción. Convierte la carpeta en un sitio web con una barra de navegación y un menú Downloads, súbela a GitHub y publícala con un uv run quarto publish gh-pages interactivo.
Terminaste cuando https://<your-github-username>.github.io/london-guide/london-dashboard.html se abre en tu teléfono, y git status estaba limpio cuando publicaste, así que el sitio en vivo se construyó a partir de lo que tiene commit y push.
¿Dos minutos sin avanzar? Pega esto en tu agente. Respalda tu trabajo y lleva el proyecto hasta este punto; luego sigue leyendo desde aquí.
Catch me up: follow ../quarto-workshop/examples/london/README.mdSi ya publicaste, ponerte al día copia el README y el .gitignore del proyecto terminado sobre los tuyos; recupera los tuyos con git checkout -- README.md .gitignore.
Ejercicio II.5: cambia un dato de entrada, explica la reconstrucción
De la Cambia un dato de entrada, explica la reconstrucción, sin prompt. Cambia el visits_2025 de la Tower of London a 8000000, predice qué salidas cambian, reconstruye, explica qué cambió y qué no, y restaura el valor real con git restore data/attractions.csv.
Terminaste cuando puedes nombrar las salidas que cambiaron, las que no, y la línea de código que conecta cada salida que cambió con el dato de entrada, y después de git restore y la segunda reconstrucción git status está limpio. Las respuestas modelo están en el Apéndice E — Los puntos de control de un vistazo, y respuestas.
Escribe tus propios prompts
Estos se construyen sobre la Parte II y no tienen puntos de control. Para cada uno, escribe tú el prompt, tan concreto como los del libro (los archivos, las columnas, la salida) y terminado en una comprobación que puedas verificar sin confiar en el informe del agente. Si te los saltaste, primero van las piezas opcionales: el anuncio cuadrado (Un anuncio cuadrado (opcional)), el documento técnico (Un documento técnico (opcional)) y la página de three.js (Las atracciones en tres dimensiones (opcional)).
- Un folleto de atracciones gratuitas. La oficina quiere un folleto A5 de una página con las atracciones de
data/attractions.csvque tienen entrada gratuita, cada una con sus visitas de- Decide qué valores de
admissioncuentan como gratuitos y dilo en el prompt. Terminaste cuando el folleto enumera tantas atracciones como cuenta el cuadro de valor “Top 10 with free entry” del dashboard, y ningún número del folleto se escribió a mano.
- Decide qué valores de
- Antes y ahora. Agrega a
london.qmduna sección que compare las visitas de 2025 de cada una de las cinco atracciones con las de 2019, a partir dedata/visits.csv. Tu prompt debería decir por qué 2019 es el año con el que hay que comparar, y pedir que se marque la única atracción cuyos conteos no son comparables. Terminaste cuando cada porcentaje sale de una celda y la atracción marcada es la que nombradata/README.md. - Convierte una copia en un cálculo. El folleto y las tablas de atracciones de la guía y del informe para socios copian todos sus datos de
data/sights.csv(Tabla 9.3). Haz que la tabla del folleto lea el archivo. Tu comprobación: cambia tú el nombre de una estación ensights.csv, reconstruye y velo en el folleto. Después, restaura el archivo. - Un mapa en dos dimensiones. Los datos del mapa 3-D están en
data/places.csv, y los límites de los distritos, endata/london-boroughs.geojson. Agrega una tercera página al dashboard que dibuje las atracciones y las iglesias en un mapa 2-D de Plotly a partir de esos archivos, con la fuente de cada punto en su texto emergente. Decide cómo vas a comprobar que cada punto está donde debe estar. - Actualiza el sitio en vivo. Cambia la oración de bienvenida de la guía y luego escribe un solo prompt que haga commit con un mensaje que diga por qué y publique la actualización con
uv run quarto publish gh-pages --no-prompt. Terminaste cuando la oración nueva está en tu teléfono.
Preguntas de repaso
- Las reglas del proyecto dicen “ALVA member attractions”, nunca “London’s most visited attractions” (las atracciones más visitadas de Londres). ¿Qué estaría mal en la segunda frase?
- Después de un prompt para agregar una lista “Getting around”,
git statusenumeralondon.mdyAGENTS.mdcomo modificados, ygit diff AGENTS.mdmuestra que se quitó la regla “Keepdata/andimages/unchanged”. ¿Qué haces, y por qué esto importa más que una palabra equivocada en la guía? - Alguien de tu equipo copia tu carpeta
london-guide/sin.venv/. ¿Qué le da los mismos paquetes que a ti, y qué escribe primero? - Mientras
quarto previewcorre sobrelondon.qmd, el agente ejecutaquarto render london.qmdy falla conreadfile 'london.quarto_ipynb'. ¿Qué pasó, y cuáles son dos formas de evitarlo? - En la oración de la guía sobre las visitas, ¿qué partes se actualizan cuando cambia
attractions.csv, y cuándo? ¿Hay alguna parte que no se actualice? - El gráfico de barras de la guía tiene un pie de figura y un texto alternativo. ¿Qué debería decir cada uno, y por qué no son lo mismo?
- Necesitas dos cambios en
london-dashboard.qmd: un cuadro de valor nuevo y un arreglo en la leyenda del gráfico de líneas. ¿Deberías dárselos a dos subagentes que trabajen en paralelo? - ¿Por qué el tamaño de página del folleto se fija con
papersize: a5, pero el del anuncio cuadrado en un bloque de Typst sin procesar? - Netlify puede construir tu sitio a partir del repositorio, o puedes renderizarlo tú y subirlo. ¿Qué necesita el proyecto de Londres, y por qué?
- Después de la reconstrucción del Ejercicio II.5, el dashboard de tu computadora muestra la Tower of London como la atracción más visitada, pero el folleto no cambió y el dashboard de tu teléfono sigue mostrando las cifras viejas. Explica las dos cosas.
Respuestas
- ALVA cuenta solo a sus sitios miembro, así que su tabla no es una lista de todas las atracciones de Londres. “London’s most visited attractions” afirmaría más de lo que muestran los datos (Reglas para la guía).
- Deshaz solo ese archivo con
git restore AGENTS.md, comprueba que el diff delondon.mdcontenga solo la lista, y haz commit de eso. Una palabra equivocada arruina una página y se ve en la vista previa; una regla quitada no se ve en ninguna parte de la página, pero cambia cada sesión siguiente, porque el agente leeAGENTS.mdal comienzo de cada una, y la protección de la evidencia desaparecería sin que nadie lo decidiera (Una lista que conserva su forma). uv.lock, que registra la versión exacta de cada paquete para cada sistema. Su primer comandouv run, comouv run quarto render london.md, construye.venv/a partir de él (Un entorno para el código que viene).- Un renderizado escribe un cuaderno temporal con el nombre del archivo, y la vista previa estaba renderizando el mismo archivo en el mismo momento, así que los dos chocaron. Deja que la vista previa renderice mientras corre, o detenla antes con Ctrl+C y vuelve a iniciarla después (Qué hace un renderizado, y por qué chocan dos renderizados).
- El código en línea (la atracción más visitada, sus visitas y el total) se actualiza en el siguiente renderizado, no cuando se guarda el archivo. La palabra “ten” está escrita a mano, así que nunca se actualiza (Números que calcula la guía).
- El pie dice qué es el gráfico: la medida, el año y de quién son las atracciones. El texto alternativo dice qué muestra, como cuál barra es la más larga y cuál la más corta, para quien no puede verlo (Un gráfico con pie de figura y texto alternativo).
- No. Los dos editan el mismo archivo, y los dos son pequeños. Los subagentes sirven para tareas independientes y sustanciales que escriben archivos distintos; haz estas dos ediciones una tras otra (Subagentes: una sesión principal, muchas manos).
- Typst tiene un nombre de papel para A5, pero ninguno para un cuadrado de 12 cm, así que el tamaño del anuncio necesita un bloque sin procesar, que Quarto le pasa intacto a Typst. Un bloque sin procesar ata la fuente a un solo formato, así que úsalo solo para lo que la configuración del formato no puede expresar (Un anuncio cuadrado (opcional)).
- Renderizarlo tú y subirlo: las páginas ejecutan Python, y el plugin de construcción de Quarto para Netlify no ejecuta ninguno. Un servicio que construye tampoco encontraría ningún sitio renderizado en el repositorio, porque
.gitignoredeja afuera_site/(Dónde vive un sitio). - El folleto no carga ningún dato: sus datos se copiaron en su Markdown, así que un cambio en
attractions.csvno puede llegarle. El sitio en vivo muestra lo último que se publicó, y solo cambia cuando vuelves a publicar (Cambia un dato de entrada, explica la reconstrucción).
La segunda tarea de transferencia compara con 2019 porque es el último año antes de los años de pandemia, 2020 y 2021, que según data/README.md no son comparables con los demás. La atracción que hay que marcar es el Natural History Museum: desde 2024, su conteo incluye sus jardines reabiertos.