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

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:

Get terms - Imports your terms from the GitLab file to the selected POEditor language
Import translations from GitLab - Imports translations from your GitLab repository to the language in your POEditor project. If project doesn't have any terms, you'll need to get the terms from GitLab first, and then import the translations.
Export to GitLab - 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) - Adds a rule by which to export strings.
Remove Link - Deletes the link between the POEditor language and your GitLab repository

Non-automated GitLab Integration Options

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