Pipe operator

Description

See magrittr::%>% for details.

Usage

lhs %>% rhs

Arguments

Value

The result of calling rhs(lhs).

Batch Translation Function

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)

Create a Translation Table

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)

Create a Transliteration Table

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)

Get Supported Languages

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.

Check if a language code is valid

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)

Google Supported Languages

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

Translate text using Google Translate

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.

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")

Translate Long Text Using Google Translate

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)

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

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)

Detect Language using Google Translate API

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.

Retrieve external sources using Linguee Translation API

Description

Retrieve external sources using Linguee Translation API

Usage

linguee_external_sources(query, src, dst, limit = 5)

Arguments

Value

A dataframe of external sources with columns: src, dst, src_url, dst_url.

See Also

linguee_word_translation, linguee_translation_examples

Examples

linguee_external_sources(query = "hello", src = "en", dst = "es")

Provide translation examples using Linguee Translation API

Description

Provide translation examples using Linguee Translation API

Usage

linguee_translation_examples(
  query,
  src,
  dst,
  guess_direction = FALSE,
  follow_corrections = "always"
)

Arguments

Value

A dataframe of translation examples with columns: source, target, pos.

See Also

linguee_word_translation

Examples

linguee_translation_examples(query = "hello", src = "en", dst = "es")

Translate word using Linguee Translation API

Description

Translate word using Linguee Translation API

Usage

linguee_word_translation(
  word,
  target_language,
  source_language,
  guess_direction = FALSE,
  follow_corrections = "always"
)

Arguments

Value

Translated word options.

Examples

linguee_word_translation("hello", target_language = "es", source_language = "en")

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

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)

Translate text using mymemory translate

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")

Get the list of available dictionaries from PONS API

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)

Translate text using PONS

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)

Get the QCRI API key from the environment variable

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.

QCRI Get Domains

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)

QCRI Get Language Pairs

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)

QCRI Translate Text

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)

Replace URLs in a sentence with placeholders

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.

Restore URLs from placeholders in a translated text

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.

Translate File

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)

Translate Text to Morse Code using the FunTranslations API

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.

Translate English Text to Morse Code with Audio

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.

Detect the language of a text

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")

Get language names

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

# Get language names
wikipedia_get_language_names()

Translate content using WMCloud

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)