Knowledge Base

Documentation to help you use the POEditor localization platform effectively

How to translate a language file from Azure Repos

Owner

You can connect your POEditor account with an Azure Repos account to more easily manage the localization of language files hosted on this code hosting service.

Note that the localization project needs to be hosted on your POEditor account in order for you to be able to links the files on Azure Repos to the project languages. However, after these links are made, you can also allow the localization project admins to import/export strings using the integration.

How to connect POEditor to Azure Repos

Go to Account Settings in POEditor and access the Integrations tab.

Integrations page

Click on Azure Repos and then click the Connect button. Log in to your Azure Repos account (if you aren't) and authorize the POEditor localization app.

In the Azure Repos integration page, select a POEditor project and the language you want to link, then press Link to a Azure Repos file. Then choose a repository, branch and file and link them together.

Link a language in POEditor to Azure Repos file

How to connect POEditor to Azure Repos Server

If you have Azure Repos installed on your server, you'll need to manually enter the server URL and token. Fill in the form in the Azure Repos Integration page with the Git Server URL (the URL of the API endpoint of your installed DevOps version) and the Access Token (you can generate one in your Azure Repos Server account in User Settings > Security > Personal Access Tokens; make sure to check 'Code (read and write)' to create a valid token) and press Connect.

Connect to Azure Repos Server - POEditor localization management platform

Managing translations and syncing the language files

Linked language files have non-automated features on the Azure Repos integration page:

Get terms - Imports your terms from the Azure Repos file to the selected POEditor language page
Import translations from Azure Repos - Imports values from your Azure Repos repository to the POEditor language page. If your language page lacks uploaded terms, you'll need to get the terms from Azure Repos first and them import the translations.
Export to Azure Repos - Exports your terms and translations in the linked language to the file selected by you in the linking stage.
Add import rule (in Settings) - Adds a rule by which to tag strings on import.
Add export rule (in Settings) - Add a rule by which to export strings.
Remove link - Deletes the link between the POEditor language file and your Azure Repos repo

Azure Repos integration options - POEditor app localization tool

You can automatically sync the terms whenever you make changes in your repos with Azure Repos webhooks. Here's some info about using webhooks with POEditor.

How to give access to the Azure Repos integration to localization project admins

After you, as the project owner, set up the links between the files on Azure Repos and the languages in the l10n project, you can give admins access to the integration from the project's settings, by enabling the option Admins Can Access Integrations.

Project Settings - POEditor localization management platform

Additional help