Once you have successfully connected your repository (GitHub, GitLab, Bitbucket, or Azure), LingoHub provides a comprehensive suite of tools to manage data synchronization. This article explains how to configure your integration settings and how to automatically or manually exchange data between LingoHub and your repository.
Managing integration settings
To access your repository settings, navigate to your project and go to Settings > Integration ([Your Provider]), e.g. GitLab. Here, you can manage the following sections:
Repository: Review your authentication and change the primary repository or default branch used for synchronization.
Branches & Files:
Branches: Enable "Branching" to synchronize multiple repository branches into a single project.
Files: Configure Resource Filters to define exactly which files should be included or excluded from synchronization.
Pull & Push:
Automatic Pull/Push: Define rules for automated synchronization (e.g., pulling changes automatically on every commit).
Push & Pull Request Settings: Set default behaviors for your data exchange, such as default commit messages.
Exchanging data via the sync menu
In the top right corner of your project view, you will find the Sync icon (labeled with your provider's name, e.g., GitLab). Clicking this icon opens a status dropdown showing the date of your last pull/push and provides manual triggers for data exchange.
How to pull data (import to LingoHub)
Click the Sync icon and select Pull.
In the Pull files dialog:
Branches: Select the LingoHub branch you want to pull into. You can also specify a custom Repository branch if it differs from the default.
Select files & languages: Toggle between All or Specific to filter exactly what data you want to import.
Click Pull.
How to push data (export to repository)
Click the Sync icon and select Push.
In the Push files dialog, configure the following:
Push type:
Create pull request: Proposes changes via a new PR. This is the safest method for collaborative environments, as it enables code review.
Push directly: Commits changes directly to the specified branch. Use this with caution, as it overwrites repository content without a review process.
Branches: Select your source LingoHub branch and the target Base branch in your repository.
Settings: Customize the PR branch name, PR title, and Description using placeholders like {project} or {date}.
Select files & languages: Choose to push all translated content or only specific files/languages.
Click Push.
Awesome! You have finished the article on managing your project repository integration. We hope that it helped you find answers to all your questions. Otherwise, contact our support, and we will gladly help!