Using Multilingual - Akumina Community

Using Multilingual

You are here:
Estimated reading time: 8 min

The multilingual capability in the Akumina Platform complements the core functionality.  For detailed information on how to enable and work with multilingual content, please watch the Multilingual Solution video tutorial:

 

 

You can navigate directly to a multilingual topic in the video using the following start times (mm:ss):

  • Introduction
  • Multilingual Approach Overview (1:03)
  • Adding the Multilingual Feature key (Admins) (9:51)
  • Deploying New and Adding to Existing Sites (Admins) (10:52)
  • Language Manager (Admins) (13:29)
  • Using Multilingual Content Apps (All) (17:52)
    • Author App Type (18:10)
    • Quicklinks App Type (26:42)
    • Slider App Type (27:47)
    • Non-multilingual Enabled Content Apps (29:11)
  • Using Fallback (30:21)
  • Site Specific setup for multilingual support (Admins) (32:32)
    • Search Term Setup (32:32)
    • Using “tokens” for Static Label Replacement (35:01)
    • Required List Columns (38:19)
    • Language Specific Widget Instances (41:08)

 

Using Multilingual Auto-Translate

The purpose of this topic is to provide the steps necessary to configure and use the Auto-Translate feature that is available for the Akumina Multilingual solution beginning with the 4.0 Release.  The Auto-Translate feature enables a content editor to automatically translate the text of the source language content item as part of generating the matching items for the additional languages.  In addition, it can be configured to translate only specific fields or be enabled only for specific Content Apps to help you govern the use of automatic translation.

Note: Auto-Translate uses the Microsoft Cognitive Services Text Translation service.  For the latest list of supported languages check the following URL: https://www.microsoft.com/en-us/translator/languages.aspx

Step 1: Setup Microsoft Cognitive Services Translator API

The first step is to configure the Microsoft Cognitive Services translation functionality to provide the translation engine.

  • Login to your Microsoft Azure portal
  • In the left column, click on the “+New
  • Search for “translator” and then select the “Translator Text API
  • At the bottom of the information panel, click on the “Create” button
  • Enter a name for the service, subscription and pricing tier level (recommend Pay-As-You-Go) as well as a Resource group (either new or existing, it is just an organizing shortcut).  Confirm and then click on “Create
  • Once created, you will be presented with the Overview screen for the new service.  Click on “Show access keys…” to display the keys you will need to add the service to the App Manager
  • The Access Keys will be displayed.  Copy both keys and save them (you will only need one to enable the service in AppManager).  This completes the setup of the translation service in the Azure Portal.

 

 

 

Step 2: Configure AppManager for Auto-Translate

Once you have setup the translation service in Azure and have an Access Key, the next step is to enable and configure the Auto-translate function in the AppManager.

Enter the Access Key in the AppManager Settings

When the Multilingual License is enabled in AppManager, the option for enabling Auto-Translate is displayed.  Turn on the Auto-Translate option, enter the Access Key and Validate.  This will validate the connection to the Azure Text Translation API.  A message will be displayed once the key is validated.

 

If your Access Key expires, use the “Update Key” button to add the new Access Key.

 

Enable Content Apps for Auto-Translate

Each Content App can be individually enabled for auto-translation.  This allows you to choose on which apps and which content auto-translation is appropriate.

 

Access the Content Apps Settings

 

Select a Content App to enable for auto-translation and edit its settings (only Author and Slider App Types can be enabled)

 

There are two areas to configure for each content app.

  • Under the “Columns” section, you can select the text fields that you want to enable for auto-translation.  This allows you to control which sections of the content in each app can use auto-translation.  By default, all the text-based fields are selected.  Non-text based field types (such as date, checkbox and metadata) cannot be enabled for auto-translation.
  • Next, you must enable Auto-Translate for the app.  This allows you to only make Auto-Translate available on those apps where it is appropriate to use.

 

 

 

Step 3: Using Auto-Translate in Content Apps

The Auto-Translate feature is available only for Author and Slider types of Content Apps.  It is not available for Quicklinks, File or Image Gallery app types.

There are two ways to use Auto-Translate in a Content App:

  • As part of creating the Language Versions of a content item
  • From within a content item to translate new text from another language

Creating Language Versions with Auto-Translate

As part of the “Create Language Version” process (for a content app enabled for Auto-Translate), you can choose to have the source language content translated to the target language(s) at the same time the target language(s) version is created.

Example:

The following is a content item in English. You want to create the Spanish version. Choose “Create Language Versions” to start the process.

 

The Create Language Versions dialog box is displayed.  The “Auto-Translate” option is shown as it is enabled for this content app (you always have the option to disable it should you not want to use it).  Select the Spanish language to create its version.  You can create versions and Auto-Translate more than one language at a time if needed.

When the new version is created, the text fields (such as Title and Body in this example) will have automatically been translated to the target (Spanish) language.  The fields that are translated will be those that were specified in the Content App Settings for this app.

Translating Fields Within the Current Content Item

You can also use Auto-Translate to re-translate selected fields in an existing content item.

For example, you may have an item in Spanish, but just received updated English text for the Body field of the item.  From within the Spanish version:

  • Enter the new English text for the Body field (you cannot mix two languages in one field, so must replace the entire text in the field)
  • Click on Auto-Translate
  • You will be given the option to select the fields you want to translate.  Leaving all fields is technically fine as it will auto-detect the current language in the field and translate to the target (in this case Spanish).  You can disable fields that don’t need translation to reduce the time to process as well as the character counts against the monthly translation quota of the service.
  • When the process completes, the content in the targeted field(s) will be translated into the current language.  Be sure to “Save” or “Publish” the content item to keep the new translated text.

 

Site Content Supported Languages

The following is a table of the languages supported for the front-end site content as part of the default Akumina installation (stored in the Languages_AK list). The table also indicates their default status when deployed.

NOTE: Although content management is supported for these languages, the “token” file will still need to be created for any enabled language(s) in order to automatically replace the static content on the site. See “Using “tokens” for Static Label Replacement” in the Multilingual Video.
Language Title LanguageId LanguageCode Direction IsActive SiteVisible IsDefault
Arabic (Saudi Arabia) 1025 ar-SA rtl FALSE FALSE FALSE
Bulgarian 1026 bg-BG FALSE FALSE FALSE
Catalan 1027 ca-ES FALSE FALSE FALSE
Chinese (Taiwan) 1028 zh-TW FALSE FALSE FALSE
Czech 1029 cs-CZ FALSE FALSE FALSE
Danish 1030 da-DK FALSE FALSE FALSE
German 1031 de-DE FALSE FALSE FALSE
Greek 1032 el-GR FALSE FALSE FALSE
English (U.S.) 1033 en-US TRUE TRUE TRUE
Spanish 1034 es-ES TRUE TRUE FALSE
Finnish 1035 fi-FI FALSE FALSE FALSE
French 1036 fr-FR FALSE FALSE FALSE
Hebrew 1037 he-IL FALSE FALSE FALSE
Hungarian 1038 hu-HU FALSE FALSE FALSE
Icelandic 1039 is-IS FALSE FALSE FALSE
Italian 1040 it-IT FALSE FALSE FALSE
Japanese 1041 ja-JP FALSE FALSE FALSE
Korean 1042 ko-KR FALSE FALSE FALSE
Dutch 1043 nl-NL FALSE FALSE FALSE
Norwegian (Bokmâl) 1044 nb-NO FALSE FALSE FALSE
Polish 1045 pl-PL FALSE FALSE FALSE
Portuguese (Brazil) 1046 pt-BR FALSE FALSE FALSE
Romansh 1047 rm-CH FALSE FALSE FALSE
Romanian 1048 ro-RO FALSE FALSE FALSE
Russian 1049 ru-RU FALSE FALSE FALSE
Croatian 1050 hr-HR FALSE FALSE FALSE
Slovak 1051 sk-SK FALSE FALSE FALSE
Albanian 1052 sq-AL FALSE FALSE FALSE
Swedish 1053 sv-SE FALSE FALSE FALSE
Thai 1054 th-TH FALSE FALSE FALSE
Turkish 1055 tr-TR FALSE FALSE FALSE
Urdu (Pakistan) 1056 ur-PK FALSE FALSE FALSE
Indonesian 1057 id-ID FALSE FALSE FALSE
Ukrainian 1058 uk-UA FALSE FALSE FALSE
Belarusian 1059 be-BY FALSE FALSE FALSE
Slovenian 1060 sl-SI FALSE FALSE FALSE
Estonian 1061 et-EE FALSE FALSE FALSE
Latvian 1062 lv-LV FALSE FALSE FALSE
Lithuanian 1063 lt-LT FALSE FALSE FALSE
Tajik 1064 tg-Cyrl-TJ FALSE FALSE FALSE
Persian 1065 fa-IR FALSE FALSE FALSE
Vietnamese 1066 vi-VN FALSE FALSE FALSE
Armenian 1067 hy-AM FALSE FALSE FALSE
Azeri (Latin) 1068 az-Latn-AZ FALSE FALSE FALSE
Basque 1069 eu-ES FALSE FALSE FALSE
Upper Sorbian 1070 wen-DE FALSE FALSE FALSE
Macedonian 1071 mk-MK FALSE FALSE FALSE
Tswana 1074 tn-ZA FALSE FALSE FALSE
Xhosa 1076 xh-ZA FALSE FALSE FALSE
Zulu 1077 zu-ZA FALSE FALSE FALSE
Afrikaans 1078 af-ZA FALSE FALSE FALSE
Georgian 1079 ka-GE FALSE FALSE FALSE
Faeroese 1080 fo-FO FALSE FALSE FALSE
Hindi 1081 hi-IN FALSE FALSE FALSE
Maltese 1082 mt-MT FALSE FALSE FALSE
Sami (Northern, Norway) 1083 se-NO FALSE FALSE FALSE
Malay (Malaysia) 1086 ms-MY FALSE FALSE FALSE
Kazakh 1087 kk-KZ FALSE FALSE FALSE
Kyrgyz 1088 ky-KG FALSE FALSE FALSE
Swahili 1089 sw-KE FALSE FALSE FALSE
Turkmen 1090 tk-TM FALSE FALSE FALSE
Uzbek (Latin) 1091 uz-Latn-UZ FALSE FALSE FALSE
Tatar 1092 tt-RU FALSE FALSE FALSE
Bengali 1093 bn-IN FALSE FALSE FALSE
Punjabi 1094 pa-IN FALSE FALSE FALSE
Gujarati 1095 gu-IN FALSE FALSE FALSE
Oriya 1096 or-IN FALSE FALSE FALSE
Tamil 1097 ta-IN FALSE FALSE FALSE
Telugu 1098 te-IN FALSE FALSE FALSE
Kannada 1099 kn-IN FALSE FALSE FALSE
Malayalam 1100 ml-IN FALSE FALSE FALSE
Assamese 1101 as-IN FALSE FALSE FALSE
Marathi 1102 mr-IN FALSE FALSE FALSE
Sanskrit 1103 sa-IN FALSE FALSE FALSE
Mongolian (Mongolia) 1104 mn-MN FALSE FALSE FALSE
Tibetan (PRC) 1105 bo-CN FALSE FALSE FALSE
Welsh 1106 cy-GB FALSE FALSE FALSE
Khmer 1107 kh-KH FALSE FALSE FALSE
Lao 1108 lo-LA FALSE FALSE FALSE
Galician 1110 gl-ES FALSE FALSE FALSE
Konkani 1111 kok-IN FALSE FALSE FALSE
Syriac 1114 syr-SY FALSE FALSE FALSE
Sinhala 1115 si-LK FALSE FALSE FALSE
Inuktitut (Syllabics) 1117 iu-CA-Cans FALSE FALSE FALSE
Amharic 1118 am-ET FALSE FALSE FALSE
Nepali 1121 ne-NP FALSE FALSE FALSE
Frisian 1122 fy-NL FALSE FALSE FALSE
Pashto 1123 ps-AF FALSE FALSE FALSE
Filipino 1124 fil-PH FALSE FALSE FALSE
Divehi 1125 div-MV FALSE FALSE FALSE
Hausa 1128 ha-Latn-NG FALSE FALSE FALSE
Yoruba 1130 yo-NG FALSE FALSE FALSE
Quechua (Bolivia) 1131 quz-BO FALSE FALSE FALSE
Northern Sotho 1132 ns-ZA FALSE FALSE FALSE
Bashkir 1133 ba-RU FALSE FALSE FALSE
Luxembourgish 1134 lb-LU FALSE FALSE FALSE
Greenlandic 1135 kl-GL FALSE FALSE FALSE
Yi 1144 ii-CN FALSE FALSE FALSE
Mapudungun 1146 arn-CL FALSE FALSE FALSE
Mohawk 1148 moh-CA FALSE FALSE FALSE
Breton 1150 br-FR FALSE FALSE FALSE
Uighur 1152 ug-CN FALSE FALSE FALSE
Maori 1153 mi-NZ FALSE FALSE FALSE
Occitan 1154 oc-FR FALSE FALSE FALSE
Corsican 1155 co-FR FALSE FALSE FALSE
Alsatian 1156 gsw-FR FALSE FALSE FALSE
Yakut 1157 sah-RU FALSE FALSE FALSE
K’iche 1158 qut-GT FALSE FALSE FALSE
Kinyarwanda 1159 rw-RW FALSE FALSE FALSE
Wolof 1160 wo-SN FALSE FALSE FALSE
Dari 1164 gbz-AF FALSE FALSE FALSE
Arabic (Iraq) 2049 ar-IQ rtl FALSE FALSE FALSE
Chinese (PRC) 2052 zh-CN FALSE FALSE FALSE
German (Switzerland) 2055 de-CH FALSE FALSE FALSE
English (U.K.) 2057 en-GB FALSE FALSE FALSE
Spanish (Mexico) 2058 es-MX FALSE FALSE FALSE
French (Belgium) 2060 fr-BE FALSE FALSE FALSE
Italian (Switzerland) 2064 it-CH FALSE FALSE FALSE
Dutch (Belgium) 2067 nl-BE FALSE FALSE FALSE
Norwegian (Nynorsk) 2068 nn-NO FALSE FALSE FALSE
Portuguese (Portugal) 2070 pt-PT FALSE FALSE FALSE
Serbian (S. and M., Latin) 2074 sr-Latn-SP FALSE FALSE FALSE
Swedish (Finland) 2077 sv-FI FALSE FALSE FALSE
Urdu (India) 2080 tr-IN FALSE FALSE FALSE
Azeri (Cyrillic) 2092 az-AZ-Cyrl FALSE FALSE FALSE
Lower Sorbian 2094 wee-DE FALSE FALSE FALSE
Sami (Northern, Sweden) 2107 se-SE FALSE FALSE FALSE
Irish 2108 ga-IE FALSE FALSE FALSE
Malay (Brunei Darussalam) 2110 ms-BN FALSE FALSE FALSE
Uzbek (Cyrillic) 2115 uz-UZ-Cyrl FALSE FALSE FALSE
Mongolian (PRC) 2128 mn-CN FALSE FALSE FALSE
Tibetan (Bhutan) 2129 bo-BT FALSE FALSE FALSE
Inuktitut (Latin) 2141 iu-Latn-CA FALSE FALSE FALSE
Tamazight 2143 ber-DZ FALSE FALSE FALSE
Quechua (Ecuador) 2155 quz-EC FALSE FALSE FALSE
Arabic (Egypt) 3073 ar-EG rtl FALSE FALSE FALSE
Chinese (Hong Kong) 3076 zh-HK FALSE FALSE FALSE
German (Austria) 3079 de-AT FALSE FALSE FALSE
English (Australia) 3081 en-AU FALSE FALSE FALSE
French (Canada) 3084 fr-CA FALSE FALSE FALSE
Serbian (S. and M., Cyrillic) 3098 sr-Cyrl-SP FALSE FALSE FALSE
Sami (Northern, Finland) 3131 se-FI FALSE FALSE FALSE
Quechua (Peru) 3179 quz-PE FALSE FALSE FALSE
Arabic (Libya) 4097 ar-LY rtl FALSE FALSE FALSE
Chinese (Singapore) 4100 zh-SG FALSE FALSE FALSE
German (Luxembourg) 4103 de-LU FALSE FALSE FALSE
English (Canada) 4105 en-CA FALSE FALSE FALSE
Spanish (Guatemala) 4106 es-GT FALSE FALSE FALSE
French (Switzerland) 4108 fr-CH FALSE FALSE FALSE
Croatian (Latin) 4122 hr-BA FALSE FALSE FALSE
Sami (Lule, Norway) 4155 smj-NO FALSE FALSE FALSE
Arabic (Algeria) 5121 ar-DZ rtl FALSE FALSE FALSE
Chinese (Macao) 5124 zh-MO FALSE FALSE FALSE
German (Liechtenstein) 5127 de-LI FALSE FALSE FALSE
English (New Zealand) 5129 en-NZ FALSE FALSE FALSE
Spanish (Costa Rica) 5130 es-CR FALSE FALSE FALSE
French (Luxembourg) 5132 fr-LU FALSE FALSE FALSE
Bosnian (Latin) 5146 bs-Latn-BA FALSE FALSE FALSE
Sami (Lule, Sweden) 5179 smj-SE FALSE FALSE FALSE
Arabic (Morocco) 6145 ar-MA rtl FALSE FALSE FALSE
English (Ireland) 6153 en-IE FALSE FALSE FALSE
Spanish (Panama) 6154 es-PA FALSE FALSE FALSE
French (Monaco) 6156 fr-MC FALSE FALSE FALSE
Serbian (B. and H., Latin) 6170 sr-Latn-BA FALSE FALSE FALSE
Sami (Southern, Norway) 6203 sma-NO FALSE FALSE FALSE
Arabic (Tunisia) 7169 ar-TN rtl FALSE FALSE FALSE
English (South Africa) 7177 en-ZA FALSE FALSE FALSE
Spanish (Dominican Republic) 7178 es-DO FALSE FALSE FALSE
Serbian (B. and H., Cyrillic) 7194 sr-Cyrl-BA FALSE FALSE FALSE
Sami (Southern, Sweden) 7227 sma-SE FALSE FALSE FALSE
Arabic (Oman) 8193 ar-OM rtl FALSE FALSE FALSE
English (Jamaica) 8201 en-JA FALSE FALSE FALSE
Spanish (Venezuela) 8202 es-VE FALSE FALSE FALSE
Bosnian (Cyrillic) 8218 bs-Cyrl-BA FALSE FALSE FALSE
Sami (Skolt, Finland) 8251 sms-FI FALSE FALSE FALSE
Arabic (Yemen) 9217 ar-YE rtl FALSE FALSE FALSE
English (Caribbean) 9225 en-CB FALSE FALSE FALSE
Spanish (Colombia) 9226 es-CO FALSE FALSE FALSE
Sami (Inari, Finland) 9275 smn-FI FALSE FALSE FALSE
Arabic (Syria) 10241 ar-SY rtl FALSE FALSE FALSE
English (Belize) 10249 en-BZ FALSE FALSE FALSE
Spanish (Peru) 10250 es-PE FALSE FALSE FALSE
Arabic (Jordan) 11265 ar-JO rtl FALSE FALSE FALSE
English (Trinidad) 11273 en-TT FALSE FALSE FALSE
Spanish (Argentina) 11274 es-AR FALSE FALSE FALSE
Arabic (Lebanon) 12289 ar-LB rtl FALSE FALSE FALSE
English (Zimbabwe) 12297 en-ZW FALSE FALSE FALSE
Spanish (Ecuador) 12298 es-EC FALSE FALSE FALSE
Arabic (Kuwait) 13313 ar-KW rtl FALSE FALSE FALSE
English (Philippines) 13321 en-PH FALSE FALSE FALSE
Spanish (Chile) 13322 es-CL FALSE FALSE FALSE
Arabic (U.A.E.) 14337 ar-AE rtl FALSE FALSE FALSE
Spanish (Uruguay) 14346 es-UR FALSE FALSE FALSE
Arabic (Bahrain) 15361 ar-BH rtl FALSE FALSE FALSE
Spanish (Paraguay) 15370 es-PY FALSE FALSE FALSE
Arabic (Qatar) 16385 ar-QA rtl FALSE FALSE FALSE
English (India) 16393 en-IN FALSE FALSE FALSE
Spanish (Bolivia) 16394 es-BO FALSE FALSE FALSE
English (Malaysia) 17417 en-MY FALSE FALSE FALSE
Spanish (El Salvador) 17418 es-SV FALSE FALSE FALSE
English (Singapore) 18441 en-SG FALSE FALSE FALSE
Spanish (Honduras) 18442 es-HN FALSE FALSE FALSE
Spanish (Nicaragua) 19466 es-NI FALSE FALSE FALSE
Spanish (Puerto Rico) 20490 es-PR FALSE FALSE FALSE
Spanish (U.S.) 21514 es-US FALSE FALSE FALSE
Was this article helpful?
Dislike 0
Views: 180
//]]>