deepRstudio: Seamless Language Translation in RStudio using DeepL API and rstudioapi

GitHub/deepRstudio

Description

Enhancing cross-language compatibility within the RStudio environment and supporting seamless language understanding, the deepRstudio package leverages the power of the 'DeepL' API (see https://www.deepl.com/docs-api) to enable seamless, fast, accurate, and affordable translation of code comments, documents, and text. This package offers the ability to translate selected text into English, as well as from English (EN) into various languages, namely Japanese (JA), Chinese (ZH), Spanish (ES), French (FR), Russian (RU), Portuguese (PT), and Indonesian (ID). With much of the text being written in English, the emphasis is on compatibility from English. It is also designed for developers working on multilingual projects and data analysts collaborating with international teams, simplifying the translation process and making code more accessible and comprehensible to people with diverse language backgrounds. This package uses 'rstudioapi' package and 'DeepL' API, and is simply implemented, executed from addins or via shortcuts on RStudio. With just a few steps, content can be translated between supported languages, promoting better collaboration and expanding the global reach of work.

The functionality of this package works only on RStudio using rstudioapi.

DeepL API Docs : https://www.deepl.com/docs-api

To obtain your DeepL API key, you must register for an account at the DeepL website. You can register for a free account. This package is built for use with the free version of the Web API.

Demo video

• deepRstudio demo v1 on YouTube

• deepRstudio demo v2 on YouTube (02-SEP-2023)

Installation of the deepRstudio package

1. Start R / RStudio console.

2. Run the following commands in the R console:

CRAN-version installation

# CRAN-version installation
install.packages("deepRstudio")
library(deepRstudio)

Note: Once restart R (Restart R on the Session or .rs.restartR()) is recommended.

Dev-version installation

#v0.0.5
devtools::install_github("kumeS/deepRstudio", ref = "v0.0.5")
library(deepRstudio)

Note: Once restart R (Restart R on the Session or .rs.restartR()) is recommended.

3. Set the API key according to DeepL Web API.

Please register for a membership (either free or paid) on the DeepL website (https://www.deepl.com/docs-api) to obtain your API key.

Step 1: log in to the DeepL website.

Step 2: click on the Account item.

Step 3: Scroll down in the Account section and you will see your DeepL API key.

Note: DeepL API Free plan offers free translation of up to 500,000 words/characters per month.

# Set your key for the DeepL API
Sys.setenv(DeepL_API_KEY = "Your API key")

Create an .Rprofile file in your home directory and add your API key (using the code above) into it.

# Create a file
file.create("~/.Rprofile") 

# [MacOS X] Open the file and edit it
system(paste("open ~/.Rprofile"))

Note: Please be aware of newline character inconsistencies across different operating systems.

Here is an example of .Rprofile configuration.

Functions in deepRstudio

License

Copyright (c) 2023 Satoshi Kume. Released under the Artistic License 2.0.

Cite

Kume S. (2023) deepRstudio: Seamless Language Translation in RStudio using DeepL API and rstudioapi

#BibTeX
@misc{Kume2023deepRstudio,
  title={deepRstudio: Seamless Language Translation in RStudio using DeepL API and rstudioapi},
  author={Kume, Satoshi}, year={2023},
  publisher={GitHub}, note={R Package},
  howpublished={\url{https://github.com/kumeS/deepRstudio}},
}

Contributors

• Satoshi Kume.