Localization

Translations

Gettext is based on a text-file-dictionary called pot or po files.
The primary one is called keys.pot, and contains all the "msgids" used by the program.
You can edit the .po files using your favourite po/pot editor, as listed below

Some Suggestions are:

  • Loco - Free online po-editor
  • POEdit - Windows/Mac/Linux client (recommended)
  • Gted - Eclipse Plugin

Getting the keys.pot file

  1. Get a copy of the keys.pot file from GitHub
  2. Make a copy of the keys.pot file, and rename it to <language-code>.po
    The language-code is the ISO-639-1 code, see a list what to use here
  3. Open the newly created .po file in a text-editor or a po-editor
  4. Edit the headers, with your texteditor (recommended is Notepad Plus Plus), to reflect the language and other state of the translation
  5. Make sure your texteditor is set to UTF-8 Things that are important to be filled in properly:
  1. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  2. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  3. "Language-Team: LANGUAGE <LL@li.org>\n"
  4. "Language: <your language code>\n"

Example:

msgid ""
msgstr ""
"Project-Id-Version: v2.4\n"
"Report-Msgid-Bugs-To: https://github.com/rlf/uSkyBlock/issues\n"
"POT-Creation-Date: 2015-04-17 08:45+0200\n"
"PO-Revision-Date: 2015-04-20 22:16+0000\n"
"Last-Translator: Mikey Mouse <Mikey.Mouse@Disney.Com>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: nl\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

After those fields, mentioned above, are filled in, you can use your favourite po-editor to translate all the `msgstr` entries in the .po file.

  • Note: Never touch or translate the msgid`s.

Updating the language files

Each release of the plugin can have an update to the text, this means that the translations need to be updated too.
The keys.pot file you downloaded in the first section of this tutorial is updated by us automatic (you can check the date of creation (POT-Creation-Date:) about 10 lines from the top).
Download the new version and overwrite the keys.pot you already got from the first time translating the file (or create a new file called keys.pot).

Update keys.pot with Poedit

In Poedit (link is above) is an option in the "Catalog" tab to "update from .pot file...", click that and browse to the keys.pot file to update your current language.po file.
After updating there might be a chance that some translations have been changed, these lines are called "fuzzy" and will be highlighted in the Poedit.
After this you can translate the new added lines and correct the "fuzzy" lines.

  • Loco - Free online po-editor does NOT have the option to update the keys.pot file (I couldn't find the option)

Updating the language.po files

As this system is very input intense we have to allow others to help out or correct mistakes.
Make sure you have the latest keys.pot file to update the lanuage.po file first (see above for link and explanation howto), you can then continue to update or correct the translation.

You can find the latest translation here, copy/paste them into your favourite text editor and use "save as" to save it in the correct format (.po).

Once the .po file has been translated, post the .po file back to uSkyBlock, by either:

  • create a pull-request to get it added to the official-release.
  • paste it to pastebin, and create an issue on GitHub linking to it
  • paste it to pastebin, and create a forum post on Spigot linking to it
  • paste it to pastebin, and create a forum post on DevBukkit linking to it
  • create an issue on GitHub, and attach the .po file to it

Once the .po file has been approved and merged to the uSkyBlock master, the translations will be available in the next release.
Files completed less then 50% will not be added.

Customize your translation

From uSkyblock v2.5.2 it will be possible to add your own [lang].po file.
Add a new folder at plugins/uskyblock folder and name it i18n and place the [country].po in there.
You can create the [lang].po files as explained above or you can download a ready made country.po and adjust what you want.

The way it works
When ever we need to lookup a translation, we look in:
a) uSkyBlock/i18n/[lang].po <-first look created by you
b) uSkyBlock.jar:i18n/[lang].po <-second look inside the plugin

So what that means is that when you add E.G. nl.po as default language but you don't like some of the translations (or want them more server orientated) you can add a nl.po file in the i18n folder with only the lines you want to be customized. The rest of the translation will be read from the original nl.po file from inside the plugin.

Translated so far

  • Danish by R4zorax (99.9% done)
  • Dutch by Dutchy1001 (99.9% done)
  • Portuguese (Brazil) by _Rodrigo (85% done)
  • Russian by Egor (85 done)
  • French by TheWura (87% done)
  • Spanish by HeertzMC (93% done)
  • Pirate by R4zorax (99.9% done)
  • Chinese (Simplified) by Miku_Snow (47% done)
  • German by Notker (62% done)
  • Swedish by maol3 (99.9% done

Disclaimer

We can not be held responsible for translations not made by us.
If in any case a translation is not correct you can contact us and we will deal with the matter as soon we can.
In case of an translation on purpose being rude or inappropriate we will remove the translation.








Support our Server cost ..

With your support we can create even better gameplay .. 


04/06/16

Survival Creative skyblock(classic) and uskygrid reayd to be played and tested aslo uploaded the gameplay survival screenshots


03/06/16

updatedthe classic skyblock page and creative skyblock page and on the moment testing network wide permissions


01/06/16

survival world discovred on the server


30/05/16

updated lgamemodes with screenshot sneakpeaks and hidden tips


29/05/16

updated lthe Guardian Schematic


28/05/16

added the schematic for the uskybloc Guardian Farom in the Deep Ocoen Biome


27/05/16

added mor plugins so the compatible plugin page is removed for total restyling


25/05/16

Updated multiple pages on the website with teswted plugins that work well with uskyblock 2.6.8 all listed plugins where tested together at a ssetup of 141 plugins there also soon will be a test rusult page


24/05/16

Updated multiple pages on the website added lot of pages in the structure to show you what will be added. Also we will add approved and tested custom island schematics for download ..


24/05/16

Updated 0.3.1 uskyworld got over 100 plugin settings updated recompiled for 1.9.4 and the lastest paperclip version


23/05/16

More pages added to the website over 150 pages with plugin information will be added. with links to the buckit and spiggot pages also we made a start with our uBible project.


22/05/16

uskyworld has now 140 plugins htat work as good frends next to our main plugin uSkyBlock current version 2.6.8


20/05/16

Updated updateed all servers to play 1.9.x still 1/9.4 is adviced also many changes made for our new donation system


08/05/16

new plugins added after long testing periode cosmetics pets and ofc npc will be made ready for use and interact in the next 24 hours .. in the skyblock and skygrid world


07/05/16

Updated Custom Armor and Weapons in the Armory also added multiple Bonus Commands And explination

06/05/16

new website online with information about our plugins and how to use them also we openend a donation shop



04/04/16

Our skyblock server is allmostready to play thanks to our staff we hopen to open gor continue plaing in a week



12/03/16

Area51 is now at beta stage we are curently playing testing and solving bugs problems and gameplay

01/03/16

Area51 went in alpha stage
we are curently playing testing and solving bugs problems and gameplay




Support our Server cost .. With your support we can create even better gameplay ..