es un sistema para confeccionar documentos científico-técnicos reproducibles , integrando código, texto y resultados en un solo flujo de trabajo.


Agenda


  • About me (mi uso de Quarto)

  • Quarto: ¿Qué es? ¿Para qué sirve?

  • Galería: ejemplos de uso

  • Primeros pasos con Quarto

  • Práctica con Quarto en:

https://mybinder.org/v2/gh/perezp44/my_mybinder_01/main?urlpath=rstudio

sobre mí … y por qué uso Quarto

  • Trabajo como PDI en la Universitat de València (dpto de Análisis Económico)

  • En mi docencia e investigación trabajo con datos y modelos estadísticos

  • He utilizado: RATS, Gauss, Stata, Python, … pero finalmente entusiasta de R


  • Intento que mis materiales sean reproducibles y compartidos, lo que me llevó a Rmarkdown y después a Quarto. Lo utilizo para todo!!!

  • En mi web en la UV puedes ver algunos de mis cursos, trabajos de investigación y blogs. Están todos hechos con Quarto

¿Qué es Quarto?

  • Sistema de publicación científica y técnica de código abierto basado en Pandoc.

    • Licencia MIT desde la v1.4 (anteriormente GNU GPL v2).


  • Desarrollado por Posit PBC (antiguo RStudio).


  • Evolución de R Markdown: Representa la segunda generación del ecosistema, diseñada para ser independiente del lenguaje.

    Quarto is a multi-language, next generation version of R Markdown, with many new features and capabilities.


  • Arquitectura basada en CLI (Interfaz de línea de comandos): Permite ejecutar Quarto desde la terminal, facilitando la automatización del renderizado e integración en flujos de trabajo programados.

¿Por qué usar Quarto?

  • Documentos reproducibles: Integra código, texto y resultados en un solo flujo. Si los datos cambian, el documento se actualiza automáticamente.

  • Soporte multilenguaje: Ejecución nativa de código R, Python, Julia y Observable JS.

  • Publicación multiformato: genera documentos en HTML, PDF, presentaciones, libros, dashboards y muchos mas desde un único documento fuente

  • Escritura técnica avanzada( através de Pandoc’s Markdown): incluye muchas extensiones útiles para la escritura técnica, como ecuaciones en \(LaTeX\), notas al pie, referencias cruzadas, bibliográfía, atributos en bloques y clases, bloques de divs y spans etc …

  • Personalización: permite controlar la apariencia mediante temas, plantillas y estilos personalizados. con CSS, SaSS

  • Colaboración: facilita el trabajo abierto y transparente mediante el uso de archivos de texto plano compatibles con control de versiones

  • Documentación excelente y comunidad muy activa

Galería: ejemplos de uso II

Quarto: ¿Cómo empezar?

  • Instalar Quarto: Descarga e instalación
  • Crear un nuevo documento .qmd con: quarto create my_docu.qmd
  • Escribir lo que quieras contar, incluyendo código, en formato QMD
  • Renderizar el documento con: quarto render my_docu.qmd --to typst
    Se ejecutará el código, generándose un archivo .md intermedio que pasará a Pandoc para producir un archivo de salida (HTML, PDF, etc.)


además …

aprendiendo a escribir en QMD

  • Los archivos fuente de Quarto tienen extensión .qmd (Quarto Markdown)

  • Son archivos de texto plano que combinan texto en formato Markdown con bloques de código ejecutable



La estructura básica de un archivo .qmd incluye:

  1. Encabezado: escrito en YAML, delimitada por las marcas ---,
    contiene metadatos y configuración del documento (título, autor, formato de salida, etc.)

  2. Texto o narrativa: formateado usando la sintaxis de Markdown para títulos, listas, enlaces, imágenes, etc…

  3. Bloques de Código: secciones delimitadas por las marcas {r} o {python}, que contienen código ejecutable.
    Estos bloques pueden incluir opciones para controlar su ejecución y visualización.

un ejemplo visual

Documento fuente (.qmd)

Documento renderizado (.html)

vamos a practicar (un poco) con Quarto


  • Vamos a usar el un entorno de desarrollo con RStudio como IDE en la nube de MyBinder, que ya tiene Quarto y R instalados


  • Solo tenéis que abrir este enlace:


https://mybinder.org/v2/gh/perezp44/my_mybinder_01/main?urlpath=rstudio

Algunos recursos

Fin!!

  • Muchas gracias por la atención

  • Espero que os animéis a usar Quarto para vuestros proyectos de investigación, docencia o …

  • Big thanks to all the Posit/Quarto team !!!! 👏🏼👏🏼

  • Moitas grazas á xente de GALPon e de MELISA !!! 👏🏼👏🏼 🙌🏼 🙌🏼 💜

Reveal.on('fragmentshown', function(event) { document.querySelectorAll('.lista-desvanece .fragment.visible:not(.current-fragment)').forEach(el => { el.style.opacity = '0.25'; el.style.filter = 'blur(1.5px)'; el.style.transform = 'scale(0.8)'; }); });