Crowdin
  • 05 Sep 2022
  • 6 Minutos para leer
  • Colaboradores
  • Oscuro
    Ligero
  • PDF

Crowdin

  • Oscuro
    Ligero
  • PDF

There is no Spanish content available for this article, You are viewing the fallback version (English).

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.

2 ScreenGIF - Creating a project in crowdin workspace

  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
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. Select from any of the four translation options based on your need. Most of the options are self-explanatory
In-house + Machine translation

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

  1. In the MT Engine field, select the Crowdin Translate option
  2. 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.

  1. On the dashboard side menu, go to ResourcesIntegrations & 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

1 Screenshot - API token in crowdin page

  1. Head back to the Document360 app on the Crowdin integration page
  2. Paste the copied token in the field and press enter
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 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.

  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.

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

Default language

In the dropdown Crowdin Sync info, you can view the time of Last push to Crowdin and the Push to Crowdin button.
7 Screenshot - Push to crowdin in Default language

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.
8 Screenshot - Push to crowdin in Non-Default language

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


¿Te ha sido útil este artículo?


What's Next