SandboxInYourLanguage
How to use existing translations and create your own.
Introduction
Existing translations are included with stable releases from 1.3. To use the translations follow the general Wordpress instructions for setting another language. Once you have set the desired language, the corresponding language should apply on the Sandbox theme as well (if language files were provided in our zip).
The following provides information on how to create your own translations. You might want to check with us or the trunk (next version) before you start translating to make sure that a translation is not forthcoming.
Translations can be added to this project by starting a new issue (the Issues tab) and attaching your .mo and .po files.
For the unexperienced: the following rough guide is provided. If you are experienced use the provided sandbox.pot from the forthcoming version.
How to translate to your own language?
Read up on and refer to the general Wordpress instructions at: http://codex.wordpress.org/Translating_WordPress The file you need to translate is called sandbox.pot, it is included in the plugin download or found in http://sandbox-theme.googlecode.com/svn/trunk/sandbox-translation/sandbox.pot if you plan to help out for the next version of Sandbox Use this file to create you own human readable file (*.po) and machine readable file (*.mo) with the correct country code in the name (e.g. fr_FR.mo). (One easy to use tool for this is Poedit - http://www.poedit.net) Place the translation file (*.mo) in the main Sandbox theme directory.
Once you have finalized your translation, open a new issue (the Issues tab) and attach the .po and .mo files. It will then be included in the next Sandbox release!
Please remember to state the version of Sandbox on which you based your localization.
How to enhance an existing translation?
Not happy with the quality of the translation provided or is it of a different country variation than yours? Download the closest .po file in the /sandbox-translation/ subfolder and edit away like described above.
If you feel that your translation is of significantly better quality, please open a ticket and we'll see if we change and talk to the previous translator about his opinions.
If you have a local variation of your language (e.g. Colombian Spanish) which we don't have, then that will of course be added as a separate file. Just remember to change to the appropriate language code or tell us your country and language and we will try.
How to update a translation to the latest version of sandbox
Translations can easily be updated to be valid for the latest version of Sandbox. First obtain a copy of the translation you want to update and the sandbox.pot file from the Sandbox version you wish to use (preferably trunk if you're updating for a new Sandbox release).
Open the old translated file in PoEdit (eg. fr_FR.mo) Go to Catalog > Update from POT file ... PoEdit will add new items to translate and remove what's no longer in use. Translate the new items and follow the procedures as for a new translation.
Don't forget to submit your translation to make sure it's included in the distribution and on this site.
References: Danish Sandbox and Swedish Sandbox
Thanks to Jan Reister for tip on updating translations.
Jan 26, 2008
My apologies. I hadn't added the POT file that was provided. It is available as of . . . right now! Anyhow, the MO and PO files can be emailed to me for inclusion: swallick AT gmail DOT com. Thanks!
Jan 27, 2008
WordPress? Chinese Team transtaled Sandbox into Simplified Chinese, and sent the language files via e-mail to you.
Feb 05, 2008
I'm having difficulties in creating the .mo file with Poedit. I'm able to create the .po file, but I guess Poedit is having troubles creating the .mo file. I get the following error:
...\pt_BR.po:220:60: invalid control sequence msgfmt: found 1 fatal error
Anyways. I posted the .po file in my personal website. However, as you see, I'm not able to test it with my installation of Sandbox. ):
Feb 18, 2008
hi adriano.
There are some HTML and others errors in what you have translated. PoEdit? will report errors and stop if coding is not replicated in the translated version. I've fixed and sent for inclusion in the code. Usually you can find out by reading the poedit error codes and either checking the lines it reports errors on or just reading the errors.
For others - be careful to put all coding exactly as it is in the English version. You must also specify a language team for poedit to be happy.
I've sent the fixed po and mo files to be included in the next version.
Feb 18, 2008
Ah... okay. Thanks for your help, Kjell.
Mar 05, 2008
I translated Sandbox into Turkish and would love to share it. You Can find it at my blog -> http://abdullaharik.com/
Sandbox'ı Türkçe'ye çevirdim ve bunu herkesle paylaşmaktan mutluluk duyacağım. Dosyayı blog sitemde bulabilirsiniz. -> http://abdullaharik.com/
May 13, 2008
Where are the instructions so one can use the translations? I can't find them here. For months I want to test my translation but I don't know how.
May 13, 2008
Dumb me. Just seen it's only setting the language in the wp-config file. Gosh!
![[image]](http://mowser.com/img?url=http%3A%2F%2Fcode.google.com%2Fhosting%2Fimages%2Ftriangle.gif)
Sign in to add a comment
I translated Sandbox into Italian and would love to share it. Where exactly do I submit Italian MO and PO? BTW the above link does not conduct to any POT for Sandbox. Anyways you do not need it since PoEdit? happily does the whole job for you generating MO and PO, which is all you need. I recomend very much the excellent article on UrbanGiraffe?.com on localizing themes. http://urbangiraffe.com/articles/translating-wordpress-themes-and-plugins/