Crowdin

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.

Being a cloud-based localization management platform that can be integrated with Document360, where human translators and machine translation collaborate and work hand-in-hand.

Prerequisite

The integration between Document360 and Crowdin is straightforward and seamless, as briefed below.
But, before that, make sure that you're an existing user on Crowdin or create a new account on the website https://accounts.crowdin.com/register. Once you're on the platform, follow these instructions to create a new project.

Basic setup guide

Creating a project on 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 organizational account.

1. log in to your Crowdin organization account and go to your Crowdin workspace
2. Click on the Create a Project button (+) on the right bottom of the screen
3. On the Project name field, type in the name of your project

4. Next, select the source language of your project

5. Select the target languages that are added to the versions in your project
6. Choose a workflow that maps out the flow of content within your project
7. Select from any of the four translation options based on your need. Most of the options are self-explanatory

8. In the MT Engine field, select the Crowdin Translate option
9. Click on the Create project button

For more information, see the Crowdin support article.

Document360 integration with Crowdin project

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

1. On the dashboard side menu, go to Resources → Integrations & API

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

3. Now, the application would require an API token from Document360

4. To fetch the API token, go to Document360 and log in to the portal

5. Go to Settings → Knowledge base portal → API tokens

6. Type in the Token name in the field

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

8. Click on the Generate button and copy the generated API token

9. Head back to the Document360 app on the Crowdin integration page
10. Paste the copied token in the field and press enter

Acquiring API token from Crowdin

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

1. Click on your profile from the top right corner and select Account settings
2. Select the Access tokens and in the Personal Access Tokens section, click on the New token button
3. Type in the Token name; select All scopes and click on the Create button at the bottom
4. You'd be asked to verify by login screen
5. Your access token has been created. Click on the icon to copy the token
6. Head back to the Document360 Settings → Knowledge base portal → Extensions, select the Translation & Browser extension tab, and select Crowdin
7. Paste the copied access token in the API key section
8. Type in the Organization name from your Crowdin account
9. Click the Save button, 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 on the Crowdin workspace.

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

1. On the left, under the Resources menu, click on Integrations & API
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 want to sync with your Crowdin project for translation
6. Click on the SYNC TO option on the Document360 section

Push to Crowdin from Document360

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

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.

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.

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

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 the 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 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.