Translation action

This action translates any text to any language supported by chosen provider. There is a list of providers that can be used for text translation. Please find more details for each provider below.

Contents

• Translation action
  • Contents
  • Inputs
  • Outputs
  • Providers
    • DeepL
    • Google
    • Linguatools
    • Microsoft
    • MyMemory
    • FunTranslations

Inputs

Name	Required	Description	Default	Possible values
source	Yes	Can be text or path to the file for translation		<Path>,<String>
provider	Yes	Provider identifier		deepl, google, linguatools, microsoft, mymemory, funtranslations
api_key	No	API key that should be used for chosen provider	""	<String>
api_additional_parameter	No	Additional parameter for the API. eg the region for Microsoft: canadacentral	""	<String>
lang	Yes	The translation direction. Should be one of the option proposed by chosen provider		<String>

Outputs

Name	Required	Description
text	Yes	Translated text

Providers

DeepL

• Identifier is deepl.
• Supported translation directions can be found here.
  • Be aware that source and target languages should be separated by - (hyphen) character while using them in lang input. For example, en-uk should be used in case you want to translate text from English into Ukrainian. See example below for more details.
• How to get API key:
  • Sign up to DeepL (free plan is fine).
  • Go to Account -> Account -> Authentication Key for DeepL API section

Example of translating "Love" word from English into Ukrainian:

jobs:
  deepl:
    name: DeepL
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: fabasoad/translation-action@main
        id: deepl-step
        with:
          provider: deepl
          lang: en-uk
          source: Love
          api_key: ${{ secrets.DEEPL_API_KEY }}
      - name: Print the result
        run: echo "Translation is '${{ steps.deepl-step.outputs.text }}'"
        shell: sh

Output is the following:

> echo "Translation is 'Любов'"
Translation is 'Любов'

Google

• Identifier is google.
• Supported translation directions can be found here.
  • Be aware that source and target languages should be separated by - (hyphen) character while using them in lang input. For example, ms-en should be used in case you want to translate text from Malay into English. See example below for more details.

Example of translating "Victory" word from Malay into English:

jobs:
  google:
    name: Google
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: fabasoad/translation-action@main
        id: google-step
        with:
          provider: google
          lang: ms-en
          source: Kemenangan
      - name: Print the result
        run: echo "Translation is '${{ steps.google-step.outputs.text }}'"
        shell: sh

Output is the following:

> echo "Translation is 'Victory'"
Translation is 'Victory'

Linguatools

• Identifier is linguatools. API Key is not needed for this provider.
• Supported translation directions:

"de-en","de-es","de-nl","de-pl","de-it","de-cs","en-de","es-de","nl-de","pl-de","it-de","cs-de"

Microsoft

• Identifier is microsoft.
• Supported translation directions:

"af","ar","bg","bn","bs","ca","cs","cy","da","de","el","en","es","et","fa","fi","fr","he","hi","hr","ht","hu","id","is","it","ja","ko","lt","lv","ms","mt","mww","nb","nl","pl","pt","ro","ru","sk","sl","sr-Latn","sv","sw","ta","th","tlh-Latn","tr","uk","ur","vi","zh-Hans"

• How to get API key:

Please follow the steps described in this article.

You will also need to provide the region of the key using the api_additional_parameter, e.g.:

with:
  api_additional_parameter: canadacentral

MyMemory

• Identifier is mymemory.
• Supported translation directions:

Language direction should be separated by | character. For example, en|it (from English to Italian). More details here.

• How to get API key:

API Key is optional. Visit Usage Limit Page to see the usage limit for free accounts. In case you want to use your API KEY, you should go to Registration Page and register a new account. Then go to API Key Generator Page and generate a new key.

FunTranslations

• Identifier is funtranslations.
• Supported translation directions:

from direction is English only at this moment, so lang parameter can be found here. Example:

- uses: fabasoad/translation-action@main
  with:
    provider: funtranslations
    lang: 'klingon'
    source: 'Who are you'