---
title: "Uso de tutoriales learnr + gradethis"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{Uso de tutoriales learnr + gradethis}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
---

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>"
)

options(rmarkdown.html_vignette.check_title = FALSE)
```

Los tutoriales parte de
[`introR`](https://ixpantia.github.io/introR/)
están basados en el paquete [`learnr`](https://rstudio.github.io/learnr/). A 
continuación se comentan los principales elementos que constituyen dichos 
recursos. 

Todo tutorial tiene una sección en la esquina superior izquierda donde se 
detalla el nombre y las distintas partes o secciones que lo conforman.

```{r echo=FALSE}
knitr::include_graphics("https://storage.googleapis.com/datos_cursos/ixpantia_introR/header.png")
```

Ahora, dependiendo del tutorial y la pregunta, los elementos a conocer cambian.

El **primer** y más común caso que encontrarás es el siguiente:

```{r echo=FALSE}
knitr::include_graphics("https://storage.googleapis.com/datos_cursos/ixpantia_introR/partes1.png")
```

En estos ejercicios hay un espacio para escribir código R, un botón para 
reiniciar o borrar el código escrito, un botón que despliega la(s) pista(s) para
resolver el ejercicio (en caso de que las haya), otro para ejecutar el código 
escrito y por último uno para enviar la respuesta. Cuando se presiona este último botón, se despliega un mensaje para identificar si la respuesta es correcta o no. 

**Nota**: al presionar el botón de "Ejecutar código", no se 
recibe la calificación del ejercicio, solamente el resultado el código. 

El **segundo** caso es cuando no existe botón de "Pista" ni de "Enviar respuesta"
pero aparece uno nuevo de "Solución" donde se tiene acceso a la respuesta del
ejercicio, como se puede ver a continuación: 
```{r echo=FALSE}
knitr::include_graphics("https://storage.googleapis.com/datos_cursos/ixpantia_introR/partes2.png")
```

El **último** caso son aquellas preguntas de selección única o múltiple, donde 
solamente se tienen las opciones, de las cuales se selecciona una o varias 
respuestas y luego se presiona el botón de "Enviar respuesta" y este, al igual
que en el primer caso, despliega un mensaje de retroalimentación. 
```{r echo=FALSE, out.width='90%'}
knitr::include_graphics("https://storage.googleapis.com/datos_cursos/ixpantia_introR/seleccion.png")
```

## Tutorial en vivo sobre learnr y gradethis 
En el webinario de setiembre 2020 de [Data Latam](http://www.datalatam.com/), 
Andrea Vargas explicó cómo se crean los tutoriales basados en `leanr` y cómo 
utilizar `gradethis` cómo herramienta de evaluación dentro de los mismos. La
grabación de este webinario se puede encontrar [aquí](https://www.youtube.com/watch?v=HyB0Lsa9ixo). 
Utilizando este recurso es posible entender lo que hay detrás de los tutoriales incluidos en este paquete.