glossary

The goal of this package is to manage a glossary for R translation projects. The idea is based on a proposal created by Saranjeet Kaur Bhogal (@SaranjeetKaur). The project was launched during the R Dev Day @ RSE Con25. This is repo is currently Work in Progress.

Installation

You can install the development version of glossary from GitHub with:

# install.packages("pak")
pak::pak("r-devel/glossary")

Using pre-commit when contributing

This repository uses pre-commit. To install and run the it, follow the steps below:

• In an external terminal run pip3 install pre-commit --user (for Windows) or brew install pre-commit (for macOS).
• Based on the level of permissions you have, either directly clone this repository or clone a fork of this repository to a local directory.

git clone https://github.com/r-devel/glossary (or git clone https://github.com/USER_NAME/glossary, if it is your fork of the repo)
cd glossary

• Install the {devtools} and {precommit} package.

install.packages("devtools")
install.packages("precommit")

• Run precommit::use_precommit() in the console.
• Once precommit is installed, each time you run git commit, the precommit hooks will run automatically. If any of the checks fail, you will need to fix the issues before you can successfully commit your changes.

Example

This is a basic example which shows you how to solve a common problem:

library(glossary)
current_glossary <- data.frame()
updated_glossary <- update_glossary(
    glossary = current_glossary,
    english = "data frame",
    spanish = "marco de datos",
    updated_via = "GitHub",
    weblate = "include"
    )
updated_glossary

##      english        spanish synonym observation source source_url retrieved_at
## 1 data frame marco de datos    <NA>        <NA>   User       <NA>   2026-09-03
##   added_via updated_via weblate location   id fuzzy context translator_comments
## 1    GitHub      GitHub include     <NA> <NA>    NA    <NA>                <NA>
##   developer_comments
## 1               <NA>

Contributors

All contributions to this project are gratefully acknowledged using the allcontributors package following the all-contributors specification. Contributions of any kind are welcome!

Code

SaranjeetKaur

rivaquiroga

sndaba

Issues

jyoti-bhogal