Crowdin is a cloud-based localization management platform that aims to make the translation process more efficient.

Crowdin and Document360 integration provide an array of possibilities in context to quality machine and human translation of content between multiple languages. This would simplify and automate the localization of your multilingual knowledge base.

Crowdin integrated with Document360, where human translators and machine translation collaborate and work hand-in-hand.

Prerequisite

You must have an active Crowdin account to begin with, or sign up for one.

Basic setup guide

Creating a project in Crowdin

Organization account

To use the Crowdin platform as a translation partner with Document360 for content translation, ensure you are a registered user of Crowdin on an enterprise account.

  1. Log in to your Crowdin enterprise account and go to your Crowdin workspace.

  2. Click "Create Project" on the right of the screen

  3. In the project field, enter the name of your project.

Project name

We recommend having project names be the same to make the 'Push to Crowdin' option work seamlessly in Document360. If you choose to have different names in Document360 and Crowdin, follow the below steps.

  1. Create a project in Document360 and Crowdin with the same names

  2. Enable the extension for Crowdin in Document360 by creating the Crowdin API key. The project name must be the same to validate the API key. Document360 will not allow the storage of invalid API keys

  3. Now, you can choose to change the names

  1. Next, select the source language of your project
Source language

Similar to the project address, the source language cannot be changed once submitted.

  1. Select the target languages that are added to the versions in your project

  2. Choose a workflow that maps out the flow of content within your project

  3. Click CREATE PROJECT

2_Screenvideo-Creating_a_Project_in_crowdin.gif

Document360 integration with the Crowdin project

Navigate to the desired Document360 project

  1. Go to Settings -> Knowledge base portal -> API Tokens

  2. Click New API Token

  3. Enter the Token name in the field

  4. Select the options required in the Allowed Method(s) field (GET, POST, PUT, DELETE)

  5. Click Generate and copy the generated API token

1_ScreenVideo-Doc360_API_Generating.gif

Now, head back to the Crowdin integration webpage.

  1. Select the created Crowdin project, and you will be taken to the project dashboard.

  2. On the dashboard side menu, go to Integration

  3. From the list of integration options available, select the Document360 application

  4. Now, the application requires an API token from Document360. Paste the copied API token.

  5. Click Log in with Document360

Machine Translation

Machine translations are enabled for each project on Crowdin, with Crowdin Translate as the default translation engine. If you want to change the translation engines, it is required to configure them before the project members can use them. Some of the other translation engines supported by Crowdin are

  • MT Engine IDs
  • Microsoft Translator
  • Yandex Translate
  • DeepL Translator
  • Watson (IBM) Translator
  • ModernMT
  • Amazon Translate
  • Google Translate
  • Google Cloud AutoML Translation

Click here to learn more about how to configure machine translation engines on Crowdin

Acquiring API token from Crowdin

From your Crowdin workspace, select the Crowdin project configured with your Document360 knowledge base.

  1. From the top right corner, click profile -> Account settings

  2. Select the Access tokens, and in the Personal Access Tokens section, click New Token

  3. Enter the token name; select All scopes

  4. Click Create

  5. Your access token has been created. Copy the generated token

Head back to Document360,

  1. Go to Settings → Knowledge base portal → Extensions, select the Translation & Browser extension tab, and select Crowdin

  2. Paste the copied access token in the API key section

  3. Enter the organization name from your Crowdin account

  4. Click Save, and you are ready to go

You can now use the Push to Crowdin option from Document360.

Feature Highlights

Sync categories and articles to Crowdin for translation

You can sync your types and articles from your Document360 project to Crowdin for translation in the Crowdin workspace.

Project name

To sync articles seamlessly between Document360 and Crowdin workspace, ensure the project name is the same.

Log in to your Crowdin account and select the Crowdin project configured with your knowledge base.

  1. On the dashboard side menu, go to Integration

  2. You can view the Crowdin project and the Document360 project side-by-side

  3. On the Document360 side, you can view the categories and articles from your connected knowledge base

  4. You can search for articles using the search bar

  5. Select the categories and articles you'd like to sync with your Crowdin project for translation

  6. Click on the SYNC TO option in the Document360 section

Synced files

Each article synced with the Crowdin project would have 2 files.

  1. The article content file, mostly in markdown or HTML format
  2. The article title file, which is a .txt file

Push to Crowdin from Document360

After you've integrated your Document360 project with your Crowdin project and synced your categories and articles, you can directly use the Push to Crowdin feature on Document360.

For instance, you have synched and translated your articles on your knowledge base using Crowdin. Later, you may make some changes or update the content of your article. 
Instead of visiting your Crowdin workspace, you can directly click on Push to Crowdin from your Document360 article editor.

Click on the Crowdin icon on top of the article editor. You can find this next to the See contributor option.

Default language

In the dropdown Crowdin Sync info, you can view the time of Last push to Crowdin and the Push to Crowdin button.

3_Screenshot-Default_Language.png

Non-Default languages
In the dropdown Crowdin Sync info, you can view the time of Last translation sync from Crowdin, the time of Last push to Crowdin, and the Push to Crowdin button.

4_Screenshot-Non_Default_Language.png

Click the Push to Crowdin button, and the latest article content will be synched to your Crowdin project.

Only the categories and articles already synced with the Crowdin project would be able to use the 'Push to Crowdin' feature.

Timestamp feature

You can now view the timestamp of the translation actions performed on the specific article.

  • Last translation sync from Crowdin: The timestamp of the recent translation and Push to Document360 action performed from the Crowdin side
  • Last push to Crowdin: The timestamp of the recent Push to Crowdin action from the Document360 side

Translating your connected Knowledge base articles

Crowdin workspace: Project home

From your Crowdin platform, select the Crowdin project configured with your Document360 knowledge base. On the Project home, you can find details about your project.

You can view the current translation status, make sure if any translations are ongoing, and you can also pause the translation.

Below is the Home tab; under the Translation section, you can see the list of target languages for your project. Also, you can find individual progress indicators adjacent to them.

If you click on any language, you will be taken to a page that shows a detailed view of the categories and articles pushed to Crowdin from Document360 for translation.

You can invite members from your team or any external agencies to collaborate on the Crowdin platform. They can directly edit or review the machine-translated content before pushing it back to the Document360 project.

Does the Document360 subscription include Crowdin translation service?
No, the Document360 subscription does not include the Crowdin translation service. However, you can integrate Document360 with Crowdin for translation purposes.

Related articles