+
+ + + +

Una de las cosas que aprendí de The Carpentries que más me gustan es codear en vivo. +Además de obligarme a ir más despacio y permitir que mis estudiantes vean mis errores, simplemente me resulta mucho más divertido que leer diapositivas o ir siguiendo un script ya escrito.

+

Pero en cuanto empecé a hacer codeo en vivo me encontré con algunos problemas. +Durante las clases era muy común que algune estudiante parara la clase para decir que el código no le funcionaba. +Entonces tenía que pedirle que copiara el código en el chat para verlo y encontrar el error de tipeo que inevitablemente le estaba dando problemas. +Paréntesis no cerrados y nombre de variables mal escritos eran errores comunes que rompían el flujo de la clase y agregaban carga cognitiva y frustración extra sin sumar mucho pedagógicamente.

+

Para solucionar estos problemas, empecé a compartir el archivo en tiempo real utilizando el paquete livecode de Colin Rundel y el servicio ngrok.

+

Uso livecode::serve_file("archivo.Rmd", upgrade_content_security_policy = TRUE) en una terminal corriendo R. +El paquete livecode va a iniciar un servidor que publica el archivo en una IP local y se mantiene actualizado. +Luego en otra terminal uso ngrok http <ip> para crear una URL pública que comparto a les estudiantes y así pueden ver una versión del archivo que estoy modificando de la cual puede seleccionar el texto.

+
+

Instalar y setear ngrok

+

Una vez que te create una cuenta en ngrok, andá al dashboard y seguí las instrucciones de instalacion según tu sistema operativo.

+

Captura de pantalla de la pantalla de Setup e instalación de ngrok. Muestra un título grande que dice "Download ngrok" y un botón que dice "Download for linux". A la derecha, un listado de distintos sistemas operativos.

+

Luego de la instalación, hay que autenticarse buscando la contaseña (el Authtoken) en la siguiente sección

+

Captura de pantalla de la sección "Your Authtoken" de ngrok. Debajo del título hay una serie de caracteres aparentemente aleatorios. Más abajo, hay un título que dice "Command line" y el código "ngrok config add-authtoken" seguido de la misma seire de caracteres.

+

Lo más fácil es correr la línea de código que muestra ahí en la terminal. +Por ejemplo:

+
ngrok config add-authtoken 1jHXu6CoMQRfdRvLqN9exqUwETs_6kAJC9v7ELubcDk5QHkE5
+

Y tiene que devolver algo como

+
Authtoken saved to configuration file: /home/elio/.ngrok2/ngrok.yml
+
+
+

Instalar livecode

+

Para poder usar livecode con ngrok hay que instalar este fork, que agrega el argumento upgrade_content_security_policy:

+
remotes::install_github("nareal/livecode")
+

Una vez instalado, probá creando un archivo cualquiera en RStudio y corriendo

+
livecode::serve_file(upgrade_content_security_policy = TRUE)
+

En la consola de R. +(El argumento upgrade_content_security_policy es necesario para usar ngrok). +Vas a ver un mensaje como este

+
#> ✔ Started sharing '2023-10-28-livecode-ngrok-R.Rmd' at 'http://192.168.100.7:32868'.
+#> ✖ The current ip address ('192.168.100.7') for the server is private, only users on the same local network are likely to be able to connect.
+#> Error: 'markdownExtensions' is not an exported object from 'namespace:markdown'
+

Y se te va a abrir una ventana de explorador. +Nos dice que estamos compartiendo el archivo en http://192.168.100.7:32868/ y nos advierte de que esta dirección es privada y sólo accesible a dispositivos conectados a la misma red local. +Esto es lo que vamos a arreglar con ngrok.

+

Copiá la dirección y abrí una terminal y corré

+
ngrok http http://192.168.100.7:32868/
+

(Usando la dirección que te dio livecode).

+

Te va a aparecer algo así en la terminal:

+

Captura de pantalla de una terminal. Hay un servicio corriendo y dice "Session Status online" así como una serie de otras entradas. Una dice "Forwarding" y tiene una dirección web larg que temrina con ngrok-free.app

+

Lo importante ahí es la dirección que está en la línea que dice “Forrwarding”. +Esa es la URL pública que le vas a compartir a tus estudiantes. +Si entrás, vas a ver que es una página web con una versión del documento que está en RStudio que se puede seleccionar y copiar.

+

Captura de pantalla de una ventana de Firefox con un documento de RMarkdown de ese mismo post.

+
+
+

Consejos

+

No recomiendo correr livecode::serve_file() en la misma sesión de R donde se está enseñando. +En vez de eso, abrí una terminal extra, corré R y usá livecode::serve_file("ruta al archivo", upgrade_content_security_policy = TRUE). +Las ventajas de esto es que el proceso que publica el archivo es independiente del proceso de R que usamos para enseñar, de modo que no se pierde todo si la sesión de R se cuelga o la reiniciás por alguna razón.

+

Tené en cuenta que tus estudiantes van a acceder a la versión en disco del archivo, por lo que no van a ver cualquier cambio que no guardes. +Podés usar esto para evitar que les estudiantes copien y peguen sin pensarlo. +Guardá el archivo al final de secciones donde se terminó de explicar algún concepto y evitá guardar el archivo si estás haciendo algún ejercicio formativo en el que escribís código en pantalla y preguntás cuál va a ser el resultado.

+

Espero que esta combinación de livecode y ngrok les sea útil para limar las asperezas del codeo en vivo.

+
+ + +
+