Picture by Miguel Á. Padriñán on Pexels.
Reemplazando la torre de Babel: herramientas para multilingüismo en R
Maëlle Salmon, rOpenSci
¡Bon dia!
Em dic Maëlle.
No vaig a parlar catalá, ni francés. 😌
https://babel-bcn.netlify.app/
¡Barcelona!
Dando una charla sobre desarrollo de paquetes R en el RUG de Barcelona en 2017
¡Barcelona!
Dando una charla sobre rmarkdown en R-Ladies Barcelona en 2017
Trabajo con rOpenSci
rOpenSci fomenta una cultura que valora la investigación abierta y reproducible utilizando datos compartidos y software reutilizable con una infraestructura técnica y una infraestructura social
Recursos / proyectos de rOpenSci
Aprende más sobre/con rOpenSci
¡Charla conmigo!
Comm call el jueves 23 de noviembre a las 13:00 Proyecto Multilingüe, organizado por Yanina Bellini Saibene con Maëlle Salmon, Paola Corrales, Elio Campitelli.
Colabora con rOpenSci
🌻 https://contributing.ropensci.org/
Picture by CECILE HOURNAU on Pexels.
Empecemos con una historia…
Picture by Enrico Perini on Pexels.
Lo que dice Yaveh en el mito
He aquí que todos forman un solo pueblo y todos hablan una misma lengua; siendo este el principio de sus empresas, nada les impedirá que lleven a cabo todo lo que se propongan. Pues bien, descendamos y allí mismo confundamos su lenguaje de modo que no se entiendan los unos con los otros
https://es.wikipedia.org/wiki/Torre_de_Babel#Relato_b%C3%ADblico
Nuestro mundo ahora…
Nuestro mundo ahora…
Utilizar inglés nos puede costar
https://journals.plos.org/plosbiology/article?id=10.1371/journal.pbio.3002184
The manifold costs of being a non-native English speaker in science, Tatsuya Amano et al, 2023, PLOS Biology.
“those of moderate and low English proficiency nationalities spend a median 93.7% (2.5 to 97.5 percentiles: 54.7% to 145.2%) and 38.0% (10.8% to 69.6%) more time, respectively, preparing an oral presentation in English than native English speakers do”
¿Tenemos que usar solo inglés cuando usamos R?
No! Hay cosas que ya existen, y esfuerzos para mejorar la situación.
Picture by Pixabay on Pexels.
R en español
R en español, un poquito
R en español, un poquito
En aparte: withr 📦
Paquete muy útil para cambiar opciones/variables de entorno/otras cosas solo para una pieza de código (ejemplo, test).
https://withr.r-lib.org/ (mantenido por Lionel Henry)
¿Cómo se traduce R?
https://contributor.r-project.org/translations
“En un mundo que se nutre de la interconexión y la comunicación global, la traducción desempeña un papel fundamental para salvar las barreras lingüísticas. La traducción, el arte de pasar de una lengua a otra, rompe esos límites y abre un mundo de posibilidades de entendimiento y colaboración.”
¿Qué se traduce de R?
https://contributor.r-project.org/translations
Todas las salidas en R base y paquetes recomendados (como los mensajes emitidos por
stop(),warning(), omessage()) son elegibles para la traducción, al igual que las etiquetas de menú en la GUI.
¿Cómo se traduce R?
Páginas específicas para cada idioma:
💬 Español
💬 Català
Qué hay que traducir después de R base…
Todas las partes donde se encuentra lenguaje humano 😉
- Mensajes de paquetes;
- Documentación (páginas de ayuda; sitios; libros…);
- (no visto aún) Nombres de funciones?
Traducción exitosa de documentación: R4DS
Traducción comunitaria
También traducción de datos
¿Qué significa traducir?
Mucho trabajo 😅
- 📏 Reglas sobre
- el proceso,
- el contenido;
- 🧰 Herramientas para
- presentar más de un idioma, cambiar el idioma;
- la traducción misma.
Fuera de R base: mensajes en paquetes
Por ejemplo data.table.
Picture by Pixabay on Pexels.
Cómo traducir mensajes de paquetes: potools
Paquete potools de Michael Chirico y Hadley Wickham.
📦 roxygen2 para crear documentación sin preocuparse de archivos .Rd.
📦 potools para tener mensajes multilingües sin preocuparse de archivos de traducción (.po, .pot, .mo).
Porqué saber como se usa potools
Porqué saber como se usa potools
💪 Para traducir sus propios paquetes
🙋 Para ayudar a traducir un paquete
🙏 Para preguntar si un paquete puede ser multilingüe
Como usar potools
Picture by Nataliya Vaitkevich on Pexels.
Registra el uso de potools en DESCRIPTION
Config/potools/style: explicitCrea función interna
Usa la función
En vez de
escribir
Crea el archivo general de traducción
Crea po/R-pockage.pot.
Crea el archivo de traducción en francés
Crea po/R-fr.po.
Llena po/R-fr.po
<metadata>
#: mensaje.R:9
msgid "user"
msgstr "utilisateur·rice"
#: mensaje.R:10
msgid "Hello {name}!"
msgstr "Salut {name} !"Compila la traducción
Crea inst/po/fr/LC_MESSAGES/R-pockage.mo (binary).
Testea la traducción
Añade idiomas
potools::po_create(c("es", "ca"))Modifica
po/R-es.poypo/R-ca.po.potools::po_compile().Instala el paquete de nuevo.
Traduce más texto
- Pone más texto dentro de
tr_(). potools::po_extract()otra vez.potools::po_update().- Modifica
po/R-fr.po,po/R-es.po,po/R-ca.po. potools::po_compile().
Resumen de uso de potools (1/2)
- Registra el estilo de uso de potools en
DESCRIPTION; - Crea y utiliza
tr_()para empaquetar texto que traducir; - Usa
potools::po_extract()cuando empezas a traducir y cada vez que el texto dentro detr_()cambia, aparece, desaparece; - Usa
potools::po_create()cada vez que quieres añadir un idioma;
Resumen de uso de potools (2/2)
- Usa
potools::po_update()después depotools::po_extract()cada vez que el texto dentro detr_()cambia, aparece, desaparece; - Usa
potools::po_compile()cada vez que cambias las traducciones.
potools tiene documentación muy bien hecha.
Documentación: páginas de ayuda
Páginas de ayuda en cualquier idioma: Si se puede.
Páginas de ayuda multilingües: No existe aún, proyecto de Elio Campitelli y Renata Hirota.
Documentación: pkgdown
pkgdown es un paquete para construir sitios de documentación de paquetes.
Captura de pantalla del sitio pkgdown del paquete purrr
En aparte: “aprender pkgdown”
Primeros pasos (puede ser suficiente!)
Para configurar más, https://pkgdown.r-lib.org/
Documentación: lo que puede pkgdown
Si la documentación es en español,
en _pkgdown.yml
Asi no dice “Developed by” pero “Desarrollado por” por ejemplo.
Documentación: lo que puede pkgdown
Catalan en la versión de desarrollo! 🙏 Joan Maspons y Lluís Revilla.
Documentación: lo que no puede pkgdown
No se puede crear sitios multilingües con pkgdown.
¿Qué es un sitio multilingüe?
- Fuente de la web en más de una idioma.
- Se construye todo.
- En cada página, enlace hasta las versiones en otras idiomas.
Picture by Yan Krukau on Pexels.
Sitios web multilingües: Hugo
Con Hugo se pueden crear sitios multilingües.
Elije un tema multilingüe (o crealo).
Picture by Ann poan on Pexels.
Sitios web multilingües: Quarto
No se puede con Quarto solo, pero si con babelquarto. ¡Experimental!
Sitios web multilingües: Quarto
Captura de pantalla del sitio web de Joel Nitta en japonés
Libros multilingües
No se puede con Quarto solo, pero si con babelquarto. ¡Experimental!
Libros multilingües
https://devdevguide.netlify.app/
Captura de pantalla del dev guide rOpenSci, versión de desarrollo
Libros multilingües con babelquarto
Cada capítulo: filepath.qmd y filepath.es.qmd.
babelquarto::register_main_language("en")babelquarto::register_further_languages(c("es", "pt"))babelquarto::render_book()
_quarto.yml
Con la ayuda de babelquarto::register_,
Cómo funciona babelquarto
Construye los dos sitios.
Añade los enlaces con {xml2}: XPath para modificar HTML.
Cómo traducir Markdown
Traducir Markdown desde cero? 😭
Copiar y pegar en DeepL o Google Translate? 😭
Usar babeldown y después revisión por humanos! 🎉
Traducir Markdown con babeldown
Respecta el formato Markdown.
Envia texto a la API de DeepL.
Picture by Heiner on Pexels.
Usar babeldown
Registra con DeepL.
Hello World.
Como usamos babeldown en rOpenSci
Para nuestra guía de desarrollo de paquetes (el “dev guide”), ahora traducido en español
- Primera traducción con babeldown;
- Primera revisión por un ser humano;
- Segunda revisión por un ser humano.
Traducion en portugés también.
Usar babeldown, con git y GitHub
Usar babeldown, con git y GitHub (1/3)
Usar babeldown, con git y GitHub (2/3)
Usar babeldown, con git y GitHub (3/3)
Cómo funciona babeldown
- Transforma Markdown en XML usando {tinkr} ({commonmark} + {xml2} + {xslt}).
- Protege algunas cosas (Hugo shortcodes).
- Envia XML a la API de DeepL.
- Envia también fragmentos de YAML a la API de DeepL.
- Crea Markdown de nuevo.
Guía de traducción de rOpenSci
En inglés y español.
https://translationguide.ropensci.org/
Picture by Monstera Production on Pexels.
Lo que queda por hacer para el multilinguismo en R
Mucho 😁
- Más idiomas;
- Páginas de ayuda;
- Sitios pkgdown multilingües;
- Mantenerlo todo.
Conferencias no solo en inglés
Rencontres R
Este congreso!
¿Se acuerdan?
He aquí que todos forman un solo pueblo y todos hablan una misma lengua; siendo este el principio de sus empresas, nada les impedirá que lleven a cabo todo lo que se propongan. Pues bien, descendamos y allí mismo confundamos su lenguaje de modo que no se entiendan los unos con los otros
https://es.wikipedia.org/wiki/Torre_de_Babel#Relato_b%C3%ADblico
En conclusión
¡Con más multilingüismo en R, nada nos impedirá que llevemos a cabo todo lo que nos propongamos!
Gracias / Gràcies
https://babel-bcn.netlify.app/
Yanina Bellini Saibene
Lluís Revilla Sancho + otros e otras organisadores de la conferencia
Reemplazando la torre de Babel: herramientas para multilingüismo en R Maëlle Salmon, rOpenSci