Knowledge Base

Documentation to help you use the POEditor localization platform effectively

How to translate a language file from a GitLab project

Owner

Connect your POEditor account with a GitLab 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 GitLab 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.

1. Connect POEditor to the hosted version of GitLab

In your account's navigation bar, access the Integrations section.

Integrations page - POEditor translation platform

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

In the GitLab Integration page, select a localization project from your POEditor account and a language in this project. Link the language to the desired file in your GitLab repo.

Link POEditor language to GitLab file

2. Connect POEditor to an installed version of GitLab

If you have GitLab Community Edition or Enterprise Edition installed on your server, you'll need to manually enter the server URL and token. Fill in the form in the GitLab Integration page with the Git Server URL (the URL of the API endpoint of your installed GitLab version) and the Access Token (you can generate one in the Profile Settings > Personal Access Tokens) and press Connect.

Connect to an installed version of GitLab

Managing translations and syncing the language files

Each linked language file has several non-automated options in the GitLab Integration page:

Import terms - Uploads your terms from the file to the selected POEditor language.
Import terms and translations - Uploads your terms and the corresponding translations from the file to the selected POEditor language.
Import translations - Adds translations from your file to the language in your POEditor project. Note that you can import translations only after having imported terms.
Export to GitLab - Exports your terms and translations from the linked language to the file selected by you in the linking stage.
Add import rule - Adds a rule by which to tag strings on import.
Add export rule - Adds a rule by which to export strings.
Remove link - Deletes the link between the POEditor language and the GitLab repo.

Non-automated GitLab Integration Options

You can use the Import from and Export to options at the bottom of the page to perform bulk actions for multiple languages at a time.

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

How to give access to the GitLab integration to localization project admins

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

Project Settings - POEditor localization management platform

Additional help