Package 'polyglotr'

Description

This function retrieves the supported language pairs from the Apertium API.

Usage

apertium_get_language_pairs(host = "https://apertium.org/apy")

Arguments

Value

A list of language pairs. Each element contains sourceLanguage and targetLanguage.

Examples

pairs <- apertium_get_language_pairs()
head(pairs, 5)

Description

Translate text using Apertium

Usage

apertium_translate(
  text,
  target_language,
  source_language,
  host = "https://apertium.org/apy"
)

Arguments

Value

Translated text. Returns a vector if input is a vector.

Examples

apertium_translate("Hello World", target_language = "es", source_language = "en")
apertium_translate("Hola mundo", target_language = "en", source_language = "es")

# Translate multiple texts
texts <- c("Hello", "Good morning", "Thank you")
apertium_translate(texts, target_language = "es", source_language = "en")

Description

This function translates a file into each target language using the polyglotr package's translate_file function, and saves the translated files.

Usage

batch_translate(input_file, source_language, target_languages)

Arguments

Value

Nothing is returned.

Examples

## Not run: 
batch_translate("README.md", "nl", c("fr", "es", "de"))

## End(Not run)

Description

This function generates a translation table by translating a list of words into multiple languages.

Usage

create_translation_table(words, languages)

Arguments

Value

A data frame representing the translation table with original words and translations in each language.

Examples

## Not run: 
words <- c("Hello", "Translate", "Table", "Script")
languages <- c("es", "fr", "de", "nl")
translations <- create_translation_table(words, languages)
print(translations)

## End(Not run)

Description

This function generates a transliteration table by transliterating a list of words into multiple languages.

Usage

create_transliteration_table(words, languages)

Arguments

Value

A data frame representing the transliteration table with original words and transliterations in each language.

Examples

## Not run: 
words <- c("Hello world", "Goodbye", "Thank you", "Please")
languages <- c("ar", "he", "el", "ru", "fa")
transliterations <- create_transliteration_table(words, languages)
print(transliterations)

## End(Not run)

Description

This function fetches the supported languages from the Google Cloud Translate documentation page.

Usage

google_get_supported_languages()

Value

A data frame containing the supported languages and their corresponding ISO 639-1 codes.

Description

This function checks if a given language code is in the google_supported_languages dataset.

Usage

google_is_valid_language_code(language_code)

Arguments

Value

A logical value indicating if the language code is valid.

Examples

## Not run: 
google_is_valid_language_code("en") # TRUE
google_is_valid_language_code("fr") # TRUE
google_is_valid_language_code("xx") # FALSE

## End(Not run)

Description

This dataset contains the language names and iso codes of languages supported by Google Translate API.

Usage

google_supported_languages

Format

A data frame with two variables: language_name and iso_code

Source

Google Translate API

Description

Translates input text to a specified language using the Google Translate mobile web interface. Automatically detects and preserves URLs by temporarily replacing them with placeholders. Long texts are split on word boundaries and translated in chunks, then reassembled.

Usage

google_translate(text, target_language = "en", source_language = "auto")

Arguments

Value

A translated string or vector of translated strings, matching the length of the input.

Examples

# Translate a simple sentence
google_translate("I love languages", target_language = "es")

# Translate a vector of words
text_to_translate <- c("the", "quick", "brown")
google_translate(text_to_translate, "fr", "en")

# Translate text containing a URL
google_translate("Visit http://example.com for more info.", target_language = "de")

Description

Translates long text from one language to another using Google Translate by splitting the input into manageable chunks if necessary.

Usage

google_translate_long_text(
  text,
  target_language = "en",
  source_language = "auto",
  chunk_size = 1000,
  preserve_newlines = FALSE
)

Arguments

Value

A single character string containing the translated text.

Examples

## Not run: 
long_text <- paste(rep("This is a long text to translate.", 100), collapse = " ")
google_translate_long_text(
  long_text,
  target_language = "de",
  source_language = "en",
  chunk_size = 500,
  preserve_newlines = TRUE
)

## End(Not run)

Description

Transliterate a single word or a sentence to the required language.

Usage

google_transliterate(text, language_tag = "el", num = 5)

Arguments

Value

Character vector of transliterated sentences or larger pieces of text.

Examples

## Not run: 
google_transliterate("Hello world", "fr", 10)
google_transliterate("hello", "el", 10)

## End(Not run)

Description

This function detects the language of a given text using the Google Translate API.

Usage

language_detect(text)

Arguments

Value

A character string representing the detected language.

Description

This function launches the Shiny web application for polyglotr, providing a user-friendly interface to access multiple translation services.

Usage

launch_polyglotr_app(launch.browser = TRUE, port = NULL, host = "127.0.0.1")

Arguments

Value

Starts the Shiny application. No return value.

Examples

## Not run: 
# Launch the app in default browser
launch_polyglotr_app()

# Launch on specific port
launch_polyglotr_app(port = 3838)

# Launch without opening browser
launch_polyglotr_app(launch.browser = FALSE)

## End(Not run)

Description

Get the set of languages currently supported by the Microsoft Translator API

Usage

microsoft_supported_languages(scope = NULL)

Arguments

Value

A list of supported languages for the specified groups.

Examples

## Not run: 
microsoft_supported_languages(scope = "translation,transliteration,dictionary")

## End(Not run)

Description

Translate text using mymemory translate

Usage

mymemory_translate(text, target_language = "en", source_language = "auto")

Arguments

Value

Translated text.

Examples

mymemory_translate("Hello World", target_language = "es", source_language = "en")

Description

Get the list of available dictionaries from PONS API

Usage

pons_dictionaries(language = "en")

Arguments

Value

A list of available dictionaries in the specified language.

Examples

## Not run: 
pons_dictionaries(language = "es")

## End(Not run)

Description

Translate text using PONS

Usage

pons_translate(text, target_language = "pt", source_language = "en")

Arguments

Value

Translated text. If the input is a vector, it returns a character vector of translated strings.

Examples

## Not run: 
pons_translate("I love languages!", target_language = "pt", source_language = "en")
text_to_translate <- c("The", "Greatest", "Language")
pons_translate(text_to_translate, "pt", "en")

## End(Not run)

Description

Get the QCRI API key from the environment variable

Usage

qcri_api_key()

Value

The QCRI API key stored in the QCRI_API_KEY environment variable.

Description

This function retrieves the supported domains from the QCRI Multiterm API.

Usage

qcri_get_domains(api_key = qcri_api_key())

Arguments

Value

A list with keys:

• success: Boolean indicating whether the request succeeded.

• domains: Array of supported domains, such as news, tedtalks etc. Only present if success is true.

• error: Error message in case success is false.

Examples

## Not run: 
qcri_get_domains(api_key = "YourApiKey")
qcri_get_domains()

## End(Not run)

Description

This function retrieves the supported language pairs from the QCRI Multiterm API.

Usage

qcri_get_language_pairs(api_key = qcri_api_key())

Arguments

Value

Language pairs.

Examples

## Not run: 
qcri_get_language_pairs(api_key = "YourApiKey")
qcri_get_language_pairs()

## End(Not run)

Description

This function translates a text from the source language to the target language using the QCRI Multiterm API.

Usage

qcri_translate_text(text, langpair, domain, api_key = qcri_api_key())

Arguments

Value

Translated text.

Examples

## Not run: 
qcri_translate_text(text = "Hello, world!",
langpair = "en-ar",
domain = "general",
api_key = "YourApiKey")
qcri_translate_text(text = "Hello, world!",
langpair = "en-ar",
domain = "general")

## End(Not run)

Description

Detects and replaces protocol-style links (e.g., ⁠http://⁠, ⁠https://⁠, ⁠ftp://⁠) in a given sentence with unique placeholders like ⁠__URL1__⁠, ⁠__URL2__⁠, etc. This is useful for preparing text for translation or further processing while preserving original URLs.

Usage

replace_urls_with_placeholders(sentence)

Arguments

Value

A list with two elements:

text

The input sentence with URLs replaced by placeholders.

urls

A character vector of the extracted URLs.

Description

Replaces placeholders like ⁠__URL1__⁠, ⁠__URL2__⁠, etc. in a translated sentence back with their original URLs. Handles both original and lowercased versions of the placeholder (to account for translation artifacts).

Usage

restore_urls_from_placeholders(translated, urls)

Arguments

Value

A character string with the placeholders replaced by the corresponding URLs.

Description

Translates the content of a file using Google Translate API.

Usage

translate_file(
  file_path,
  target_language = "en",
  source_language = "auto",
  overwrite = FALSE
)

Arguments

Examples

## Not run: 
translate_file("path/to/file.txt", target_language = "fr", source_language = "en", overwrite = TRUE)

## End(Not run)

Description

This function takes a string of text as input and translates it to Morse code using the FunTranslations API.

Usage

translate_to_morse(text, api_key = NULL)

Arguments

Value

A list containing the translated Morse code text and other metadata.

Description

This function takes an English text string as input and translates it to Morse code with an audio output using the FunTranslations API.

Usage

translate_to_morse_audio(text, api_key = NULL)

Arguments

Value

A list containing the translated Morse code text, the Morse code audio as a base64-encoded string, and other metadata.

Description

This function sends a POST request to the Wikimedia Language ID API with the specified text, parses the JSON response, and returns the detected language.

Usage

wikimedia_detect_language(text)

Arguments

Value

The detected language.

Examples

{

# Detect the language of a text
wikimedia_detect_language("Hallo, wereld")

}

Description

This function sends a GET request to the Wikipedia API and returns the language names as a dataframe.

Usage

wikipedia_get_language_names()

Value

A dataframe of language names.

Examples

wikipedia_get_language_names()

Description

This function sends a POST request to the WMCloud translation API with the specified parameters, parses the JSON response, and returns the translated content.

Usage

wmcloud_translate(
  content,
  target_language = "en",
  source_language = "en",
  format = "text",
  model = "nllb200-600M"
)

Arguments

Value

The translated content.

Examples

## Not run: 
# Translate plain text
wmcloud_translate("rijst",
target_language = "es",
source_language = "nl", format = "text")

# Translate a webpage
wmcloud_translate("https://en.m.wikivoyage.org/wiki/Goes",
target_language = "es",
source_language = "en", format = "webpage")

# Translate JSON content
wmcloud_translate('{
    "id": 1,
    "title": "Chicken Biryani",
    "description": "Chicken Biryani is a savory chicken and rice dish",
    "ingredients": [ "Vegetable oil", "Garlic", "Ginger" ,"Rice"]
}
               ', target_language = "es", source_language = "en", format = "json")

# Translate Markdown content
wmcloud_translate('# Heading

This is a [link to Wikipedia](https://wikipedia.org)
                ', target_language = "es", source_language = "en", format = "markdown")

## End(Not run)