+
Set up Bitbucket localization by integrating with PTC. Get human-quality translations to your repository via automated pull requests.
How To Integrate Bitbucket with PTC
PTC integrates with your Bitbucket repository to keep your resource files translated continuously. As you push code changes, PTC:
- Translates the updated strings
- Delivers the translations straight to your repository as a pull request
1
Connect Bitbucket to PTC
To set up the Bitbucket integration, choose the option that applies to you:
- When creating a new project in PTC, select Git Integration in the setup wizard.
- To switch an existing project from manual file uploads to a continuous Git-based workflow, go to Settings → Merge Requests and click Add Git Integration.
In both cases, you’ll see a screen asking you to enter the URL to your repository. PTC will automatically detect that you’re using Bitbucket.
To connect your repository, you can use an access token (recommended) or sign in with OAuth. If you connect using an access token, make sure it includes the correct scopes.
Once PTC validates the token, choose which branches you want it to monitor. PTC automatically detects the resource files in the selected branch.
2
Translate Your Project with PTC
After linking your Bitbucket repository to PTC, continue through the setup steps to tell PTC about your project and add languages.
PTC can import and reuse any translation files already in your Bitbucket repo. However, the best results come from translating the full project with PTC.
3
Review Pull Requests
PTC completes translations in just a few minutes and delivers them to your Bitbucket repository as a pull request. You can merge the changes immediately.
As you update monitored files, PTC automatically detects changes and opens new pull requests with the latest translations. This keeps your Bitbucket project fully localized over time.
How to Generate New Pull Requests Manually
You can manually trigger a new pull request from the Dashboard or the Translations tab, where you can view and make changes to translated text.
For example, if a translation exceeds the length limit, PTC highlights it so you can shorten it manually or ask PTC to generate a more compact version. Once you save the change, generate a new pull request to push the updated translations into your Bitbucket repository.
4
Make Sure PTC Translates Any New Resource Files
As your project grows, you may add new resource files to your repository. To bring them into PTC:
- Go to Settings → Monitored Files and click Rescan your repository.
- Any new files found will appear as drafts. Click the + icon to add a file to your translation workflow, then hit Save with translation to apply.
If you prefer not to review new files manually, select the Automatically include new translation files checkbox. PTC will then monitor and include newly discovered resource files in your repository without requiring confirmation.
Why Translate Bitbucket Projects With PTC
Quick and Easy Repository Integration
Connect PTC directly to your Bitbucket repository and eliminate the need for manual file imports or exports or for running fragile scripts. Once integrated, PTC detects resource files, generates human-quality translations using AI, and sends them back via pull requests.
Always Up-to-Date Translations
PTC tracks changes to your resource files and updates translations automatically. No extra effort from your team required.
Agile and Scalable Localization
PTC supports multiple languages and works with all major resource file formats. Choose which branches to monitor, and adjust settings as your project grows or changes.
