This page is intended to provide information for those interested in helping to translate Diplomancer for non-English locales.
How Diplomancer works
Diplomancer recognizes your current location and selects a faction to watch according to a data table. The keys and values in this table are the names of zones, subzones, and factions. This means that if the names in the table don't match the names in your game client, Diplomancer won't work.
There are currently two libraries, LibBabble-Faction-3.0 and LibBabble-Zone-3.0, which provide comprehensive lists of translated names for factions and zones. However, no such list exists for subzone names.
For example, the zone Shattrath City is mapped to the faction The Sha'tar. However, within Shattrath City there are five subzones which are mapped to other factions. The subzone Lower City is mapped to the faction Lower City. The subzones Aldor Rise and Shrine of Unending Light are mapped to the faction The Aldor. The subzones Scryer's Tier and The Seer's Library are mapped to the faction The Scryers. (There are also two subzones that share the name Bank, of which one should be mapped to The Aldor, and one to The Scryers, but since their names are identical, there is no way to tell them apart by name, so Diplomancer ignores them.)
How you can help
In order for Diplomancer to work in non-English locales, I need a list of subzone names that match the in-game names for each locale. Further down this page you'll find a list of text strings in this format:
L["Some text"] = ""
and
Z["Some text"] = ""
The lines beginning with L are text strings that are shown to users in-game. The translation for "Inactive" much match exactly the in-game text for the Inactive faction group heading. The other translations in this group can be translated however is most natural for your language.
The lines beginning with Z are subzone names, and again, must match those used in-game. Copy and paste them into an empty text file.
For both types of translations, don't alter the English text in the brackets. Instead, add your translated text between the quotation marks at the end of the line. For example, if you were translating into Spanish, you might do:
L["Hello world"] = "Ola mundo"
Please excuse my poor Spanish, but hopefully you get the idea.
Once you have completed at least the subzone translations, save your file as "xxXX.lua", where "xxXX" is the appropriate locale code. European Spanish is "esES", Korean is "koKR", and so forth. Inside the file, at the top, you can add your name, and an email address if you like, so that you get credit for your work.
Please do
not use hex escape sequences for non-Latin characters! Instead,
save the file with UTF-8 encoding so that these characters are preserved in their normal, human-readable state.
Finally, you can send the file to me by email at < addons AT phanx net >, or upload it to a file host of your choice and send me a PM on this site with the URL. Feel free to contact me via email or PM if you have any questions!
The List
-----------------------
-- Interface strings --
-----------------------
L["Inactive"] = ""
-- Important: this must match the in-game name of the Inactive faction group heading in your locale!
L["Default Faction"] = ""
L["Select a faction to watch when your current location doesn't have an associated faction."] = ""
L["Reset"] = ""
L["Reset your default faction preference to your race's faction"] = ""
L["Ignore Exalted Factions"] = ""
L["Don't watch factions you've already acheived Exalted standing with."] = ""
L["Enable Notifications"] = ""
L["Show a message in the chat frame when your watched faction changes."] = ""
-------------------
-- Subzone names --
-------------------
-- Azshara
Z["Bay of Storms"] = ""
Z["Timbermaw Hold"] = ""
Z["Ursolan"] = ""
-- Blade's Edge Mountains
Z["Evergrove"] = ""
Z["Forge Camp: Terror"] = ""
Z["Forge Camp: Wrath"] = ""
Z["Ogri'la"] = ""
Z["Ruuan Weald"] = ""
Z["Shartuul's Transporter"] = ""
Z["Vortex Pinnacle"] = ""
-- Borean Tundra
Z["Amber Ledge"] = ""
Z["D.E.H.T.A. Encampment"] = ""
Z["Taunka'le Village"] = ""
Z["Transitus Shield"] = ""
Z["Unu'pe"] = ""
-- Crystalsong Forest
Z["Sunreaver's Command"] = ""
Z["Windrunner Overlook"] = ""
-- Dalaran
Z["Sunreaver's Sanctuary"] = ""
Z["The Silver Enclave"] = ""
-- Desolace
Z["Gelkis Village"] = ""
Z["Magram Village"] = ""
-- Dragonblight
Z["Agmar's Hammer"] = ""
Z["Dragon's Fall"] = ""
Z["Light's Trust"] = ""
Z["Moa'ki Harbor"] = ""
Z["Stars' Rest"] = ""
Z["Venomspite"] = ""
Z["Westwind Refugee Camp"] = ""
Z["Wintergarde Keep"] = ""
-- Durotar
Z["Sen'jin Village"] = ""
-- Eastern Plaguelands
Z["Acherus: The Ebon Hold"] = ""
-- Felwood
Z["Deadwood Village"] = ""
Z["Felpaw Village"] = ""
-- Grizzly Hills
Z["Camp Oneqwah"] = ""
-- Hellfire Peninsula
Z["Cenarion Post"] = ""
Z["Mag'har Grounds"] = ""
Z["Mag'har Post"] = ""
Z["Temple of Telhamat"] = ""
Z["Throne of Kil'jaeden"] = ""
-- Howling Fjord
Z["Camp Winterhoof"] = ""
Z["Kamagua"] = ""
-- Icecrown
Z["Orgrim's Hammer"] = ""
Z["The Argent Vanguard"] = ""
Z["The Skybreaker"] = ""
-- Nagrand
Z["Aeris Landing"] = ""
Z["Oshu'gun"] = ""
Z["Spirit Fields"] = ""
-- Netherstorm
Z["Netherwing Ledge"] = ""
Z["Tempest Keep"] = ""
-- Searing Gorge
Z["Thorium Point"] = ""
-- Shadowmoon Valley
Z["Altar of Sha'tar"] = ""
Z["Sanctum of the Stars"] = ""
Z["Warden's Cage"] = ""
-- Shattrath City
Z["Aldor Rise"] = ""
Z["Lower City"] = ""
Z["Scryer's Tier"] = ""
Z["Shrine of Unending Light"] = ""
Z["The Seer's Library"] = ""
-- Sholazar Basin
Z["Frenzyheart Hill"] = ""
Z["Kartak's Hold"] = ""
Z["Mistwhisper Refuge"] = ""
Z["Rainspeaker Canopy"] = ""
Z["Sparktouched Haven"] = ""
Z["Spearborn Encampment"] = ""
-- Stranglethorn Vale
Z["Booty Bay"] = ""
Z["Salty Sailor Tavern"] = ""
Z["Yojamba Isle"] = ""
Z["Zul'Gurub"] = ""
-- Storm Peaks
Z["Camp Tunka'lo"] = ""
Z["Frostfloe Deep"] = ""
Z["Frosthold"] = ""
Z["Frosthowl Cavern"] = ""
Z["Gimorak's Den"] = ""
Z["Grom'arsh Crash-site"] = ""
Z["Howling Hollow"] = ""
Z["Inventor's Library"] = ""
Z["Loken's Bargain"] = ""
Z["Mimir's Workshop"] = ""
Z["Narvir's Cradle"] = ""
Z["Nidavelir"] = ""
Z["Temple of Invention"] = ""
Z["Temple of Life"] = ""
Z["Temple of Order"] = ""
Z["Temple of Winter"] = ""
Z["Terrace of the Makers"] = ""
Z["The Foot Steppes"] = ""
Z["The Plain of Echoes"] = ""
-- Tanaris
Z["Caverns of Time"] = ""
-- The Barrens
Z["Ratchet"] = ""
-- Terokkar Forest
Z["Blackwind Lake"] = ""
Z["Blackwind Landing"] = ""
Z["Blackwind Valley"] = ""
Z["Lake Ere'noru"] = ""
Z["Lower Veil Shil'ak"] = ""
Z["Mana Tombs"] = ""
Z["Skettis"] = ""
Z["Terokk's Rest"] = ""
Z["Upper Veil Shil'ak"] = ""
Z["Veil Ala'rak"] = ""
Z["Veil Harr'ik"] = ""
-- Tirisfal Glades
Z["The Bulwark"] = ""
-- Winterspring
Z["Frostfire Hot Springs"] = ""
Z["Frostsaber Rock"] = ""
Z["Timbermaw Post"] = ""
Z["Winterfall Village"] = ""
-- Zangarmarsh
Z["Funggor Cavern"] = ""
Z["Quagg Ridge"] = ""
Z["Sporeggar"] = ""
Z["Swamprat Post"] = ""
Z["Telredor"] = ""
Z["The Spawning Glen"] = ""
Z["Zabra'jin"] = ""
-- Zul'Drak
Z["Ebon Watch"] = ""