- 05 Sep 2022
- 6 Minutes à lire
- Mis à jour le 05 Sep 2022
- 6 Minutes à lire
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.
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
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.
- log in to your Crowdin organization account and go to your Crowdin workspace
- Click on the Create a Project button (+) on the right bottom of the screen
- On the Project name field, type in the name of your project
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.
- Create a project in Document360 and Crowdin with the same names
- 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.
- Now, you can choose to change the names.
- Next, select the source language of your project
Similar to the project address, the source language cannot be changed once submitted.
- Select the target languages that are added to the versions in your project
- Choose a workflow that maps out the flow of content within your project
- Select from any of the four translation options based on your need. Most of the options are self-explanatory
This is an amalgamation of human translators and Machine Translation technology.
• Pre-translation - Translation Memory
• Pre-translation - Machine Translation
• Translation - in-house translators
• Proofreading - in-house proofreaders
- In the MT Engine field, select the Crowdin Translate option
- Click on the Create project button
Document360 integration with Crowdin project
Select the created Crowdin project, and you will be taken to the project dashboard.
On the dashboard side menu, go to Resources → Integrations & API
From the list of integration options available, select the Document360 application
Now, the application would require an API token from Document360
To fetch the API token, go to Document360 and log in to the portal
Go to Settings → Knowledge base portal → API tokens
Type in the Token name in the field
Select the options required in the Allowed Method(s) field (GET, POST, PUT, DELETE)
Click on the Generate button and copy the generated API token
- Head back to the Document360 app on the Crowdin integration page
- Paste the copied token in the field and press enter
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
- DeepL Translator
- Watson (IBM) Translator
- Amazon Translate
- Google Translate
- Google Cloud AutoML Translation
Click here to know more on 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.
- Click on your profile from the top right corner and select Account settings
- Select the Access tokens and in the Personal Access Tokens section, click on the New token button
- Type in the Token name; select All scopes and click on the Create button at the bottom
- You'd be asked to verify by login screen
- Your access token has been created. Click on the icon to copy the token
- Head back to the Document360 Settings → Knowledge base portal → Extensions, select the Translation & Browser extension tab, and select Crowdin
- Paste the copied access token in the API key section
- Type in the Organization name from your Crowdin account
- Click the Save button, and you are ready to go.
You can now use the Push to Crowdin option from Document360.
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.
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.
- On the left, under the Resources menu, click on Integrations & API
- You can view the Crowdin project and the Document360 project side-by-side
- On the Document360 side, you can view the categories and articles from your connected knowledge base
- You can search for articles using the search bar
- Select the categories and articles you'd want to sync with your Crowdin project for translation
- Click on the SYNC TO option on the Document360 section
Each article synced with the Crowdin project would have 2 files.
- The article content file, mostly in markdown or HTML format
- The article titles 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 article, 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 make some changes or update the content in your article.
Instead of visiting your Crowdin workspace, you can directly click on the 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.
In the dropdown Crowdin Sync info, you can view the time of Last push to Crowdin and the Push to Crowdin button.
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.
Only the categories and articles already synced with the Crowdin project would be able to use the 'Push to Crowdin' 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.