5

Translation

Pavel Baksy edited this page 2026-01-13 17:53:31 +01:00

Table of Contents

• Translation Guide
• For Translators
• 1. Download the Translation Template
• 2. Create Your Translation
• 3. Submit Your Translation
• Language Codes
• What Gets Translated
• Questions?

Translation Guide

Help translate Roster to your language! The process is simple.

For Translators

1. Download the Translation Template

Get the latest template file from the repository (37 translatable strings):

• File location: po/roster.pot
• Direct link: https://git.bugsy.cz/beval/roster/src/branch/master/po/roster.pot
• Or browse: https://git.bugsy.cz/beval/roster/src/branch/master/po

2. Create Your Translation

Open the .pot file with any translation editor:

• Poedit (recommended for beginners) - https://poedit.net
• GNOME Translation Editor (gtranslator)
• Lokalize (KDE)

The editor will ask for your language - choose it and start translating!

3. Submit Your Translation

Once finished, submit your .po file:

Option A: Pull Request (preferred)

1. Fork the repository
2. Add your LANGUAGE.po file to the po/ folder
3. Add your language code to po/LINGUAS (one per line, alphabetically sorted)
4. Create a pull request

Option B: Issue Attachment

• Create an issue at https://git.bugsy.cz/beval/roster/issues
• Attach your .po file
• Mention your language code (e.g., cs, de, fr)

That's it! No need to build or test - the maintainer will handle the rest.

Language Codes

Use standard codes:

• Two letters: cs, de, fr, es, it, pl
• With region: pt_BR, zh_CN, en_GB

What Gets Translated

Your translation covers:

• Application interface and menus
• Button labels and tooltips
• Error messages

Questions?

See Contributing or open an issue if you need help!