Grub Translator Guide
This guide is for people which want translate any part of Grub project. For now its cover GrubNG C# client. About translations of new Grub page, please see new Grub page. Translations of Grub base on GNU gettext files *.po This is first version of guide thus if you don't understand something or you have any suggestion, go to Discussion page.
Contents |
[edit] Preparations
Before start you need tools to edit .po files. Of course, you can edit translation files by normal text editor but this is very difficult way. Better use special editors for .po files.
- Gnu/Linux and *BSD systems
On this system are available few editors. Most popular are KBabel for KDE environment and Poedit.
- Windows and MacOS X
You can use Poedit program too.
This guide been based on Poedit configuration and usage.
At first program start you need enter information about you (name and email). As a name you can enter your real name or nickname. Set this informations which you want to be public available (it been written in translation file plus used in ChangeLog file and during uploading file on SVN repository - thus everyone can see it). If you don't fill this informations its been write Anonymous as a translator or <private@mail.org> as a translator mail.
Next step is for people which want start work on new translation. If you want only upgrade existing translation, go to step 3.
[edit] Request for new translation
If you want start work on translation which not exist, first you must request about file with this translation. You can do in two ways:
- Creating issue in Grub Bugtrack. Fill form with informations, on which translation you want work. This is the best way.
- You can send email on Grub-dev Mailing List or to thindil2@gmail.com with informations about desired translation.
After 24-48 hours new translation appear on Grub Subversion repository and you can start work on translation.
[edit] Working with translation
- First you must check, that your desired translation exist. You can do by browsing Grub Subversion repository. Translations for Grub page you can found at http://svn.swlabs.org/grubng/trunk/site/translations/ and for Grub C# client at http://svn.swlabs.org/grubng/trunk/csharp/Grubngtranslations/
- It would be good if you inform all that you start work on selected translation. The best way for this is using Grub Bugtrack and fill new issue as a "task" in selected project.
- Download selected translation from repository. You can use for this browser or special Subversion client.
- Run translation tool, use Open option and select .po file with translation
- Start fill empty translations. You don't need translate all. You can even translate only one text.
[edit] Uploading
If you finish work with translation, you can send it to us. Before send, please compress translated file (by zip, gzip or bz2 but not as self extracting archive). There are two ways to send it:
- Create issue in Grub Bugtrack or use existing issue for selected translation. Attach compressed file with translation to this issue. This is preferable way.
- Send compressed file on thindil2@gmail.com
In next 24-48 hours your translation been uploaded on Grub Subversion repository and later:
- Grub C# client translation been added to next client update (probably in next week or two)