Una Nueva Manera de Escribir

taller
Autor/a

Miguel Equihua

Fecha de publicación

Xalapa, Ver., 14 de febrero, 2025

Curso-taller para iniciarse en las habilidades que promueve la ciencia abierta. La apertura invita a ampliar la colaboración, pero también la eficacia con la que se colabora. Hay mucho que ya se puede hacer con el apoyo de Dropbox®, GoogleDocs® y con las mismas aplicaciones de Microsoft® ¿Qué significa que esto esté ocurriendo? ¿Qué implicaciones podría tener sobre la forma como se hace y comunica la ciencia?

El curso-taller se propone acercar al estudiante a la increíble evolución mundial de las capacidades de cómputo y de comunicación que ya está en marcha. No sólo porque cada vez hay mayores facilidades para colaborar, sino por la capacidad actual para producir documentos que combinan el texto con el procesamiento estadístico de datos y las gráficas resultantes. El que la secuencia completa datos→análisis→texto se pueda unificar, da todo un nuevo significado al proceso de comunicación en favor de la reproducibilidad científica.


Los estudiantes aprenderán a producir reportes académicos en distintos formatos: páginas web, documentos tipo Word®, PDF, carteles, presentaciones e incluso artículos o libros. Todo esto sin que se requiera un conocimiento previo de R o RStudio. Lo haremos paso a paso y con un enfoque de manos a la obra. El estudiante podrá elegir los materiales, datos y textos que le interese ensayar.

Las actividades se desarrollarán a lo largo de 16 sesiones teórico prácticas que se impartirán entre el 10/feb/2025 y el 6/jun/2025. Las sesiones serán principalmente presenciales a lo largo de 3 horas. Se desarrollarán los viernes de 10 am a 1pm. Se espera que el estudiante desarrollará actividades a su paso para desarrollar el producto que será la entrega final al término del taller. La carga de trabajo se estima requerirá 9 horas adicionales cada semana.

Temario

El curso-taller introducirá al estudiante a los siguientes temas:

  • Tematica 1
    • ¿Ciencia abierta y reproducibilidad?
    • El proceso científico abierto y su trazabilidad
    • Escribir en RStudio recurriendo a:
      • markdown
      • Quarto
      • pandoc
      • ecuaciones Latex
  • Tematica 2
    • Leer datos desde distintos orígenes: Excel®, Google Sheets®, OneCloud®
    • Colaboración y control de versiones
    • Publicación en línea.
  • Tematica 3 - Un Blog como libreta colaborativa de trabajo - Organización del contenido - Producción de Diapositivas para presentaciones Web - Documentos abiertos a comentarios desde la web


Actividades presenciales

Las sesiones presenciales se llevarán a cabo en el Aula 16 o en un espacio apropiado del Inecol que convendremos con los estudiantes participantes.

Requisitos previos

El estudiante tiene familiaridad con el uso de computadoras y el uso de Internet. Para algunas de las actividades será provechoso tener cuentas activas en los servicios en línea Github (como sistema de control de versiones) y Netlify (para publicar blogs y sitios web personales). El estudiante tendrá que generar su cuenta personal en cada uno de estos servicios. Se recomienda hacerlo con antelación. También se sugiere obtener una cuenta ennel servicio hypothesis.

  1. Alta en Github.
  2. Alta en Netlify.
  3. Alta en hypothesis

Para las actividades en clase se espera que el participante tendrá ya instalado en su máquina el sistema de control de versiones Git (windows requiere instalarlo. Linux y macOS normalmente ya tienen git instalado). Además, para quienes prefieren el mundo gráfico de windows y desean evitar el uso de terminales y comandos, se sugiere utilizar Github Desktop o TortoiseGit). También habrá que tener listo el interprete del lenguaje de computo R y la interface de desarrollo RStudio. Las instrucciones para estos dós últimos están aquí, en el caso de ambiente MS-Windows® pueden usarse los siguientes enlaces:

  1. git for windows
  2. Instalar Github Desktop
  3. Instalar R
  4. Instalar RStudio

Para las actividdades de preparación es importante verrificar que las siguientes bibliotecas estén instaladas en R. Para hacerlo puedes usar el menú Tools \(\rightarrow\) Install packages… o el siguiente commando en la pestaña Consola.

muestra el escript:
install.packages(c("rmarkdown", "usethis", "knitter", "tinytex" ))
  1. rmarkdown
  2. knitr
  3. usethis
  4. tinytex

Si interesa verificar la publicación Web de documentos en el campus, hay que prever que no estén bloqueados en el Firewall de la institución los sitios con terminación .netlify.app, pues es la que utilizará el servicio Netlify por defecto.

Quarto es un sistema de fuente abierta para la autoría de documentos científicos y técnicos. Puedes aprender más sobre lo que ofrece Quarto en este enlace.

La construcción de comunidades de aprendizaje requiere compartir intereses y actitudes. Al respecto pongo a su consideración el Pacto del Contribuyente, que busca exponer ideas y conceptos que hace la convivencia grata y productiva. Pienso que el espíritu de este documento es muy adecuado para estimular la reflexión que buscamos propicie lo que estaremos haciendo en este taller.

muestra el escript:
# devtools::install_github("benjcunningham/googlecalendar", force=TRUE)

library(qrcode)

code <- qr_code("https://2025-ciencia-reproducible.netlify.app/")
plot(code, col = c("white", "#2268bb"))
Código QR del blog

Código QR del blog