README

TorrentPier Translations

Composer package containing TorrentPier localization files, automatically synchronized from the TorrentPier Crowdin project.

About

This repository serves as a standalone translation library for TorrentPier, containing community-contributed translations in 48+ languages. All translations are managed through Crowdin, enabling collaborative localization with quality control and consistency checks.

Installation

Install via Composer:

composer require torrentpier/translations

Requirements: PHP 8.2 or higher

Supported Languages

The package includes translations for 48 languages, including but not limited to:

English (source)
Russian, Ukrainian, Belarusian
German, French, Spanish, Italian
Polish, Czech, Slovak
Japanese, Chinese, Korean
Arabic, Hebrew
And many more...

For the complete list, see the /languages directory.

Usage

After installation, language files are available in the vendor/torrentpier/translations/languages/ directory. Each language uses its two-letter ISO 639-1 code:

vendor/torrentpier/translations/languages/
├── en/       # English (source)
├── ru/       # Russian
├── de/       # German
├── fr/       # French
└── ...

Each language directory contains:

main.php - Primary translation strings
email/ - Email template translations
html/ - HTML template translations

Contributing Translations

All translations are managed through Crowdin to ensure quality and consistency.

How to Contribute

Join the project: Visit crowdin.com/project/torrentpier
Select your language: Choose an existing language or request a new one
Start translating: Use Crowdin's interface to translate strings
Review and vote: Help review other translations for quality

Why Crowdin?

No technical knowledge required - translate directly in your browser
Translation memory - consistent terminology across the project
Quality assurance - built-in checks for formatting, placeholders, and more
Collaboration - vote on translations and discuss with other contributors
Automatic synchronization - approved translations sync to this repository

For Developers

This repository is automatically synchronized with Crowdin. Do not edit translation files directly - all manual changes will be overwritten on the next sync.

To update translations:

Make changes on Crowdin
Wait for automatic synchronization (or trigger manually if you have access)
Update your composer.lock to get the latest version

Development

Crowdin Configuration

The repository includes a crowdin.yml configuration file that defines:

Source language location (/languages/source/)
Translation file patterns
Target language directory structure

Syncing Process

Translations are synchronized from Crowdin to this repository through:

Translators work on Crowdin platform
Translations are reviewed and approved by proofreaders
Approved translations are automatically pushed to this repository
New package versions are tagged and released

Support

Translations issues: crowdin.com/project/torrentpier
Package issues: github.com/torrentpier/torrentpier/issues
Community: torrentpier.com
Email: support@torrentpier.com

License

This package is open-sourced software licensed under the MIT license.

Credits

Maintained by the TorrentPier team and translated by the amazing community of contributors on Crowdin. Thank you to everyone who helps make TorrentPier accessible to users worldwide!

torrentpier / translations

Maintainers

Details