Hercules Ultimate Localization Design

[Ind 945]

Hercules Ultimate Localization Design
Hello~! - What?!

• Servers are now able to run under any number of languages, without having any of the default files modified
• Designed by Haruna and Ind

 

Translating NPCs without editing them

• By launching map server with the --generate-translations param a .pot (.po template) file will be created with all of the servers translate-able strings (including all npc dialogue), this file can be edited in text mode or by utilising any .po editor (there are many out there; for a high range of OSes)
• A .po file does not need to be fully translated to be used, map server will know when loading the file, and will fallback to the hardcoded string in the npc files as necessary
• Users are able to change their language with the new @lang command, @lang controls what language users see in @commands (msg_txt stuff) as well as over npc dialogues
• map-server.conf has a new setting called default_language where server owners may specify which language should be used as a base
• When you have a new .po file you want map server to use, add it to db/translations.conf

Easy to Maintain

• Since .po is a widely used format there are many tools that can help with merging for example Poedit, which easily consolidates a translated .po file with a newly generated .pot. For example when you have a translated .po and since it was created npc dialogs were added or modified all you have to do is launch map server to generate a new .pot, open your old .po in Poedit, go "Catalog -> Update from POT file" and it will insert the new translatable strings without touching your existing translations, it will also notify you of any "obsolete" strings that are in your .po file but that are no longer in use

Script Command Macro

• Besides messages.conf, all the dialogue utilised by 'mes' and 'select' is included in the .pot automatically, this patch also introduces a mechanism for utilising strings outside of these commands, the script macro _() which can be employed just as if it were a script function, for example set .@status$,_("Available"); tells map server to export "Available" as a translate-able string when it is run with --generate-translations (when running map server normally the macro has no overhead during runtime)

Special Thanks to

• Raizen and Roberto from Cronus, we would not have worked on this if it weren't for them

Links~!

• Commit

Editing Example

• 

Edited January 4, 2017 by Dastgir
formatting

[Edgar 2]

Thx a lot

[zackdreaver 90]

Cool!

[Dastgir 1246]

Awesome

[Legend 43]

Finally. Thanks~

[JulioCF 105]

nice nice!

[Roberto 5]

Ind, could we send pull requests with updated pots for each language?

[daim 5]

awsome! thanks

[Milamber 1]

Nice! A Enterprising new Feature!

[Kusoo 3]

Amazing! Thanks for this.

[Petey Pablo 0]

nice work

[evilpuncker 503]

the file is so f*cking huge xD lets see who will dare to translate it

[Kenpachi 65]

Hi guys. ( Yes, I'm still alive. )

 

First of all: great idea, great work!
 

 

Besides messages.conf, all the dialogue utilised by 'mes' and 'select' is included in the .pot automatically

This confused me, and so I checked the commit...

Is it supposed to not include announce, mapannounce, areaaanounce, menu, dispbottom and probably some other string related commands?

 

//EDIT: I put my hand up if you need a volunteer for a german translation.

 

 

~ Kenpachi

[Mystery 594]

Ind, could we send pull requests with updated pots for each language?

I'm pretty sure it's more than welcomed But of course, just like any other pull request, it'd be under review.

[Mhalicot 392]

Awesome

[Judas 100]

amazing work!!

[Relzz 32]

YOU IND, HARU JUST REALIZED MY DREAM ;-;  GUYS THIS IS GREAT! THANKS 

 

I really love it:D I hope it will improve later, great job guys, really:D

 

 

 

I had an orgasm, really

[OverLord 4]

Great job! Very thx! I loved!

[Kichi 6]

Ind has raised from his hibernate
and bring good news

[Kichi 6]

btw how to use it on windows?

 

by typing
--generate-translations on map server?

[zackdreaver 90]

btw how to use it on windows?

 

by typing

--generate-translations on map server?

make a shortcut then in target field add --generate-translations

[Kichi 6]

 

btw how to use it on windows?

 

by typing

--generate-translations on map server?

make a shortcut then in target field add --generate-translations

are you able to give me the example

 

 

[Dastgir 1246]

 

 

 

btw how to use it on windows?

 

by typing

--generate-translations on map server?

 

make a shortcut then in target field add --generate-translations

are you able to give me the example

 

Open cmd, go to your Hercules folder , type

map-server --generate-translations

Or save the above line in .bat file and run it

[Kichi 6]

 

 

 

 

btw how to use it on windows?

 

by typing

--generate-translations on map server?

make a shortcut then in target field add --generate-translations

are you able to give me the example

 

Open cmd, go to your Hercules folder , type

map-server --generate-translations

Or save the above line in .bat file and run it

this is the result

[Warning]: Unable to open 'map-server', caching capabilities have been disabled!

 

and i didn't see the output

 

-- EDIT --

even map-server.exe --generate-translations

still unable to produce the output

 

 

are you guys able to produce the output or no?

 

Edited February 24, 2015 by Kichi

[Kichi 6]

sry my mistake
after i read the source
 

generatetranslations, "Creates './generated_translations.pot' file with all

the output file is generated_translations.pot'