Quarto
1 Introducción
1.1 ¿Qué es Quarto?
Quarto es un entorno de trabajo que facilita estructurar un documento que reúne las salidas —tanto gráficas como de texto—, con el código que las genera y los comentarios e interpretaciones redactados por el usuario. Este entorno se basa en el lenguaje Markdown1 y puede usarse desde RStudio.
El proceso de estructuración del documento involucra dos archivos: un archivo fuente y un documento de salida para la lectura. Los formatos más populares para documentos de salida son html, pdf y Word. Por su parte, el documento fuente de Quarto es un archivo de texto plano con extensión qmd, lo que lo hace identificable y procesable por RStudio. La figura 1.1 ilustra este concepto.
Libros y otros
Quarto permite construir desde pequeños documentos hasta libros. La diferencia más evidente entre los libros y los demás documentos es que los libros están estructurados en capítulos, cada uno de los cuales exige un archivo fuente y genera un archivo de salida. Para los demás documentos se utiliza un único archivo fuente, que genera un único archivo de salida.
Inicialmente se considera el caso más sencillo, es decir, el de los documentos que no son libros, para presentar las generalidades de Quarto, las cuales en su mayoría aplican a cualquier tipo de documento.
1.2 Formatos de Salida
La manera en la que se visualizan los diferentes elementos (fragmentos de código, texto, resultados) en el documento de salida puede variar en función del tipo de documento (html, pdf o Word). No obstante, en general, el código aparece dentro de una caja, con fondo gris. Los resultados se muestran de la misma manera en la que aparecen en la consola de RStudio, es decir, que no están antecedidos por ningun símbolo artificial2 y no tienen ningún tipo de resaltado, modificándose únicamente la fuente.
El texto aparece como tal, incluyendo las especificaciones de formato que se hubieran elegido para el mismo.
Cada uno de los principales formatos de salida tiene sus ventajas y especificidades:
1.2.1 Documentos html
El formato html es el más ventajoso para el lector final, por las posibilidades que le ofrece; muy particularmente, cuando se aplica a contenidos de gran extensión —como el de los libros— que estén divididos en capítulos y secciones:
- Pueden visualizarse en cualquier navegador de internet.
- Los paneles de navegación facilitan moverse fluidamente a través de los diferentes temas.
- El contenido se adapta al tamaño del dispositivo de lectura, resultando cómodo incluso desde un teléfono móvil. Dependiendo del espacio disponible, los paneles de navegación se muestran o se ocultan. Cuando la lectura se realiza desde un teléfono móvil, el contenido y los paneles de navegación se adaptan al giro de la pantalla.
- Todos los vínculos externos son funcionales, dirigiendo a los recursos citados: páginas, instaladores, libros en línea…
- Todos los vínculos internos también son funcionales, facilitando ir rápidamente a alguna otra sección o recurso (tablas, figuras o ecuaciones) dentro del mismo libro y regresar al sitio de origen.
- Cuando se pasa el mouse por encima de los vínculos internos aparece una previsualización, lo que en muchas ocasiones es suficiente para saber a qué se está haciendo referencia, sin necesidad de ir al recurso en cuestión.
- Puesto que no hay cortes de página, las figuras y tablas pueden incluirse justo después de citarlas.
- Igualmente, por no haber cortes de página, las tablas se muestra completas y los bloques de código se muestran de manera compacta.
- Al no haber páginas físicas, las denominadas ‘notas de pie de página’ ya no aparecen al ‘pie de la página’, sino que se despliegan al pasar el ratón por encima. También puede irse a la nota3, haciendo clic sobre el correspondiente identificador numérico y regresar al punto de origen, haciendo clic sobre el ícono
.
- Cuando se trate de un libro que incluya código R (no es obligatorio que sea así), es fácil copiarlo y llevarlo a R para realizar la correspondiente verificación y/o adaptación.
- Pueden disponerse vínculos para descargar material complementario: bases de datos, scripts, paquetes, figuras…
- Cuando el libro se encuentra en algún repositorio, v. gr. Quarto Pub, es probable que su autor realice constantes actualizaciones, con lo cual los lectores tendrán la certeza de estar accediendo siempre a la versión más reciente.
1.2.2 Documentos pdf
Son los más adecuados cuando su destino final es un soporte físico. Este formato considera las restricciones que impone la impresión en páginas de un tamaño definido, dando lugar a resultados bastante estéticos. Internamente, el proceso de generación del documento pdf se da a partir de un documento intermedio LaTeX.
1.2.3 Documentos Word
Tienen la ventaja de su versatilidad para edición e incorporación en otros documentos. Es el formato ideal para compartir con otros usuarios, facilitándoles el proceso de incluir correcciones y comentarios, sin que tengan que entenderse con ninguna herramienta ‘esotérica’.
1.3 Antes de iniciar
Llegado a este punto, usted probablemente estará ansioso por empezar a explorar Quarto. No obstante, antes de que lo haga, vale la pena que tenga en cuenta un par de recomendaciones:
¡No hay que instalar nada!
Para usar Quarto desde RStudio, basta con tener instalado el paquete rmarkdown y, desde luego, los paquetes con los que vaya a trabajar, pero no hace falta instalar ningún otro paquete relacionado con Quarto.
¡Respalde la información!
Aunque en este libro no se hace referencia al modo visual, muy probablemente este se descubrirá en algún momento. Este modo contiene una serie de herramientas que agilizan el proceso de edición y ayudan a descubrir nuevas funcionalidades. El paso entre el modo visual y el modo fuente suele ser fluido. No obstante, en ocasiones, en particular en documentos que contienen cajas de llamado (cf. sección 3.2 y tablas en código html estas se desconfiguran al pasar al modo visual.
Antes de ensayar este modo —si decide hacerlo— se recomienda respaldar la información.
Información de referencia
Si usted es de los que prefiere beber directamente de la fuente, puede visitar la página de la aplicación https://quarto.org/. Allí se recomienda empezar por el inicio: Get Started. Recuerde que no tiene que instalar nada. A continuación pude pasar a la guía Guide, donde encontrará mayores detalles sobre las diferentes funcionalidades de Quarto.
Sobre el autor
Guillermo Correa Londoño es un Ingeniero Forestal que obtuvo su título de Maestría en Estadística en el Colegio de Postgraduados (Texcoco, México) y de doctorado en Estadística Multivariante Aplicada en la Universidad de Salamanca (Salamanca, España). Actualmente es Profesor Titular, adscrito al Departamento de Ciencias Agronómicas de la Facultad de Ciencias Agrarias de la Universidad Nacional de Colombia. Su ámbito de desempeño está relacionado principalmente con investigación aplicada en ciencias agrarias y biotecnología.
email: gcorrea@unal.edu.co
CvLAC
ORC
Otros textos del mismo autor
Índice de Condición Integral. Se desarrolla una metodología que desglosa los diferentes procesos involucrados en la construcción de un Índice de Condición Integral, que permite realizar valoraciones a partir de variables complejas en diversos ámbitos. La propuesta está acompañada de un paquete para R.
R paso a paso. Este manual introduce al neófito en el fascinante mundo de R y sus posibilidades, iniciando desde cero, hasta llevarlo a un punto en el que programe sus propias funciones personalizadas.
MEITools. Compendio de funciones personalizadas para R.
Licencia
El contenido de este sitio puede usarse bajo las condiciones de la licencia Creative Commons Atribución-NoComercial-CompartirIgual 4.0 Internacional (CC BY-NC-SA 4.0).
Quarto es la siguiente generación de R Markdown.↩︎
Cuando sea del caso aparecerán los marcadores de posición del primer elemento de la fila, de la misma manera en que aparecen en la consola, pero nunca aparecerán símbolos como
#>o##, que aparecían en los documentos de R Markdown.↩︎Todas las notas aparecen al final del documento.↩︎