Lenguajes y Fundamentos de Programación · LNG-104

Quarto: documentos, webs y libros desde el notebook

Publicar informes, apuntes, webs y libros desde cuadernos con código ejecutado y citas.

Bajo demanda Intermedio 6 módulos · 30 clases

Formato asíncrono Docentes FP, Ingeniería / Industria, Desarrollo Quarto, JupyterLab

DESARROLLO DOCENCIA JUPYTER

Lo que aprenderás

Estructurar un documento Quarto con cabecera YAML, secciones y opciones de ejecución de bloques.
Renderizar el mismo origen a HTML, PDF y Word controlando las diferencias de cada formato.
Ejecutar código de Python o R dentro del documento y controlar la salida de figuras y tablas.
Referenciar figuras, tablas, ecuaciones y secciones con etiquetas cruzadas.
Gestionar bibliografía con ficheros BibTeX y estilos de cita CSL.
Construir un sitio web o un libro con navegación, búsqueda y publicación automatizada.

Contenido del curso

6 módulos · 30 clases en vídeo · práctica guiada en cada módulo

Módulo 1 · Primer documento 5 clases

Qué es Quarto y qué relación tiene con el cuaderno
Instalación y comprobación del entorno
Anatomía de un fichero qmd
Cabecera YAML y opciones básicas
Renderizar y previsualizar mientras se escribe

Módulo 2 · Texto y código 5 clases

Markdown útil: secciones, listas, notas y bloques destacados
Bloques de código y opciones de ejecución
Ocultar código, mostrar solo resultados o mostrar ambos
Código en línea para que las cifras del texto no envejezcan
Caché de resultados y tiempos de renderizado

Módulo 3 · Figuras, tablas y referencias 5 clases

Figuras con pie, tamaño y disposición
Tablas a partir de datos y formato de columnas
Etiquetas y referencias cruzadas
Ecuaciones y notación matemática
Diagramas incrustados en el documento

Módulo 4 · Formatos de salida 5 clases

HTML: temas, tabla de contenidos y código plegable
PDF: plantillas, márgenes y tipografía
Word para entregas que exigen ese formato
Presentaciones desde el mismo origen
Condicionar contenido según el formato

Módulo 5 · Bibliografía y documentos parametrizados 5 clases

Ficheros BibTeX y gestión de referencias
Estilos de cita con CSL
Citas, notas al pie y lista final
Parámetros del documento y renderizado por lotes
Generar un informe por cada cliente o grupo

Módulo 6 · Webs y libros 5 clases

Proyecto de sitio web: estructura y navegación
Páginas, entradas y búsqueda
Proyecto de libro con capítulos y numeración
Publicación automatizada y despliegue
Proyecto de cierre: informe, web y libro desde un mismo material

Requisitos

Saber trabajar con cuadernos y ejecutar código en Python o en R.
Nociones básicas de Markdown.
Quarto instalado en el equipo, o el entorno de JupyterLab del curso, que ya lo incluye.

Descripción

El informe se escribe en un procesador de textos, los cálculos están en un cuaderno y las gráficas se pegan a mano. Cuando cambian los datos hay que rehacer el recorrido entero, y casi siempre queda algún número viejo en algún párrafo. Lo mismo ocurre con los apuntes de un módulo o con la memoria de un proyecto.

Quarto une las dos mitades: el texto y el código viven en el mismo fichero y el documento se regenera con un comando. El curso empieza por un informe sencillo, añade control de bloques, figuras y tablas con referencias cruzadas, incorpora bibliografía y parámetros, y termina construyendo un sitio web y un libro completos con navegación y publicación automatizada.

El material que se produce sirve igual para una memoria técnica, para los apuntes de un ciclo o para la documentación de un proyecto, y se mantiene actualizado sin trabajo manual. Encaja directamente con los cursos de R para estadística e informes reproducibles y con cualquier itinerario de análisis de datos.

¿Para quién es este curso?

Profesorado de FP que mantiene apuntes y prácticas y no quiere rehacerlos cada curso.
Ingenieros que entregan memorias técnicas con cálculos y gráficas que cambian con los datos.
Desarrolladores y analistas que documentan proyectos y publican resultados reproducibles.