Proposito

Qué es Quarto

Quarto es un sistema open-source de publicación técnica y científica. Quarto es una interfaz de línea de comandos (CLI) que convierte formatos de texto plano (.qmd, .rmd, .md) o formatos mixtos (.ipynb/Jupyter notebook) en documentos estaticos o interactivos.

Por qué Quarto

Qué puedo hacer con Quarto: artículos

Qué puedo hacer con Quarto: dashboards

Qué puedo hacer con Quarto: libros

Qué puedo hacer con Quarto: presentaciones

Qué puedo hacer con Quarto: sitios web

Cómo funciona Quarto

Representación esquemática de cómo funciona Quarto. Allison Horst.

No es sólo R y RStudio

What You See Is What You Get (WYSIWYG)

What You See Is What You Mean (WYSIWYM)

---
title: "ggplot2 demo"
author: "Norah Jones"
date: "5/22/2021"
format: 
  html:
    fig-width: 8
    fig-height: 4
    code-fold: true
---

## Air Quality

@fig-airquality further explores the impact of temperature on ozone level.

```{r}
#| label: fig-airquality
#| fig-cap: "Temperature and ozone level."
#| warning: false

library(ggplot2)
ggplot(airquality, aes(Temp, Ozone)) + 
  geom_point() + 
  geom_smooth(method = "loess")
```

Integrated development environment (IDE)

Renderizar y formatos

library(quarto)
quarto::quarto_render(input = "documento.qmd") # html por defecto
quarto::quarto_render(input = "documento.qmd", output_format = "pdf")

quarto render document.qmd # html por defecto
quarto render document.qmd --to pdf

Anatomía de un archivo .qmd

Los archivos de Quarto (.qmd) son archivos de texto plano conformado por:

Metadata (YAML)

format: html
engine: knitr

format: html
engine: jupyter

Código

```{r}
library(dplyr)
mtcars |> 
  group_by(cyl) |> 
  summarize(mean = mean(mpg))
```

```{python}
from siuba import *
(mtcars
  >> group_by(_.cyl)
  >> summarize(avg_mpg = _.mpg.mean()))
```

Texto

# Título 1
Esta es una frase con algo de **texto en negrita**, *texto en cursiva* y una 
![Descripción de la imagen](imagen.png){fig-alt=«Alt text para la imagen»}.

Metadata (YAML)

«Yet Another Markup Language» o “YAML Ain’t Markup Language” se utiliza para proporcionar metadatos a nivel de documento o proyecto.

---
title: "El origen de las especies"
author: "Charles Darwin"
format: 
  html:
    toc: true
----

Markdown

Markdown: formato de texto

En Quarto se puede agregar texto en diferentes formatos.

Sintaxis básica

*cursiva*

**negrilla**

***cursiva y negrilla***

superíndice^2^

subíndice~2~

~~tachado~~

`código puro`

Markdown: párrafos

En Markdown los párrafos se construyen dejando una linea en blanco. De lo contrario, el salto de línea se trata como un espacio.

Lorem ipsum dolor sit amet,
consectetur adipiscing elit.

Sed do eiusmod tempor.

Markdown: encabezados

En Quarto se pueden agregar hasta seis niveles de encabezados o títulos.

# Encabezado 1

## Encabezado 2

### Encabezado 3

#### Encabezado 4

##### Encabezado 5

###### Encabezado 6

Markdown: listas

Lista desordenada

Para los elementos de una lista desordenada se puede utilizar: *, -, o +.

*   Elemento 1
    +   Elemento 1.1
        -   Elemento 1.1.1
    +   Elemento 1.2
*   Elemento 2

Lista ordenada

1.  Elemento 1
    i)  Elemento 1.1
        A.  Elemento 1.1.1
        A.  Elemento 1.1.2
    i)  Elemento 1.2
1.  Elemento 2

Markdown: enlaces e imágene

La sintaxis para agregar enlaces e imágenes e relativamente similar.

<https://quarto.org>

[Quarto](https://quarto.org)

![Descripción](images/quarto_logo.png)

Markdown: tablas

Quarto incluye características destinadas a facilitar la creación y personalización de tablas: especificar la alineación y el ancho de las columnas; proporcionar títulos y referencias cruzadas; generar tablas a partir de código. En Markdown las tablas pueden ser pipe tables o grid tables. Las tablas se pueden construir usando el Editor Visual o generadores https://www.tablesgenerator.com

| Por defecto | Izquierda | Derecha | Centro |
|-------------|:----------|--------:|:------:|
| 12          | 12        |      12 |   12   |
| 123         | 123       |     123 |  123   |
| 1           | 1         |       1 |   1    |

: Demostración de pipe table.

+-----------+-----------+--------------------------+
| Fruta     | Precio    | Ventajas                 |
+==========:+:=========:+:=========================+
| Banano    | $1.34     | - envoltorio incorporado |
|           |           | - color brillante        |
+-----------+-----------+--------------------------+

: Demostración de grid table.

Referencias cruzadas

Las referencias cruzadas facilitan a los lectores la navegación por el documento proporcionando referencias numeradas e hipervínculos a diversas entidades, como figuras y tablas. Toda entidad con la que se puedan establecer referencias cruzadas requiere una etiqueta (fig- y tbl-), un identificador único precedido de un tipo de referencia cruzada (fig-elemento y tbl-elemento).

![Istopipo de Quarto](images/quarto_logo.png){#fig-quarto}

La @fig-quarto muestra el isotipo de Quarto.

La Figura 1 muestra el isotipo de Quarto.

Código

En Quarto el código puede insertarse en linea o como bloques de código (conocidos como chunks). Los chunks siempre se encuentran entre ```, mientras el código en linea se encuentra entre `. Para que el código sea ejecutable se ha de poner el nombre del lenguaje entre {}, ej. {r}. Si sólo se pone el nombre del lenguaje, el código no se ejecutará y se resaltará la sintaxis del lenguaje. Los chunks pueden tener opciones que se indican con un #| (hash pipe) y siguen la sintaxis del YAML.

```{r}
#| label: fig-ejemplo-chunk
#| fig-cap: "Descripción de la figura. Note el prefijo generado automáticamente"
#| fig-dpi: 300
#| output-location: column-fragment
#| code-line-numbers: "|1|2-8|2|3-4"

library(ggplot2)

iris |> 
  ggplot2::ggplot(
    ggplot2::aes(x = Petal.Length, y = Petal.Width)
  ) + 
  ggplot2::geom_point(
    ggplot2::aes(color = Species, shape = Species)
  ) + 
  ggplot2::geom_smooth(
    formula = y ~ x, method = "loess"
  ) + 
  ggplot2::theme_classic()
```

De opciones de chunk al YAML

Hay una gran variedad de opciones disponibles para personalizar la salida del código ejecutado. Todas estas opciones se pueden especificar globalmente (YAML) o por bloque de código.

---
title: "El origen de las especies"
format: html
---

```{r}
#| echo: true

pi + 1
```

---
title: "El origen de las especies"
format: html
execute:
  echo: true
---

```{r}
pi + 1
```

Opciones de ejecución

Las opciones disponibles para personalizar la salida incluyen: