Difference between revisions of "Translations"

From Ultronomicon
Jump to navigation Jump to search
 
(60 intermediate revisions by 30 users not shown)
Line 1: Line 1:
 +
This article describes the current localization efforts in the [[The Ur-Quan Masters]] project.
 +
 
==General information==
 
==General information==
  
Line 12: Line 14:
 
Currently, only left-to-right writing systems are supported.
 
Currently, only left-to-right writing systems are supported.
  
Support for non-ascii input in text fields is not present yet.
+
Support for non-ascii input in text fields is still limited.
 
 
  
 
===Using language packs===
 
===Using language packs===
 
A language pack can be used [[The Ur-Quan Masters Technical FAQ#How do I use add-on packages?|like any other add-on package]].
 
A language pack can be used [[The Ur-Quan Masters Technical FAQ#How do I use add-on packages?|like any other add-on package]].
 
  
 
===Creating language packs===
 
===Creating language packs===
 
Language packs are normal add-on packages, which means they will be a .zip file (renamed to .uqm), with in it a directory structure which overrides the files in the default content.
 
Language packs are normal add-on packages, which means they will be a .zip file (renamed to .uqm), with in it a directory structure which overrides the files in the default content.
 +
 +
'''NOTE: You can skip manually extracting files below and use the contents of [http://www.bjwaymods.net/uploads/translation_skeleton483.zip this] skeleton translation pack.'''
  
 
====Text files====
 
====Text files====
Line 40: Line 42:
  
 
====Fonts====
 
====Fonts====
If you need additional characters you will need to add appropriate entries to the font dirs slides/slides.fon/, ipanims/lander.fon/, lbm/micro.fon/, lbm/tiny.fon/, lbm/player.fon/, lbm/starcon.fon/ and comm/<race>/<race>.fon/. The number of the file is the UNICODE character code.
+
If you need additional characters you will need to add appropriate entries to the font dirs slides/slides.fon/, ipanims/lander.fon/, lbm/micro.fon/, lbm/tiny.fon/, lbm/player.fon/, lbm/starcon.fon/, credits/pt13.fon, credits/pt17.fon, credits/pt45.fon and comm/<race>/<race>.fon/ (note that starbas.fon, rebel.fon and spahome.fon do not exist). The number of the file is the UNICODE character code converted into decimal (from hex). [http://unicode.org/charts/ Here] are the official UNICODE character code charts. For hex-decimal conversion you can use [http://www.easycalculation.com/hex-converter.php this] online converter.
 +
 
 +
Note that translation projects for other languages may have already created glyphs usable for your language.
  
 
====Images====
 
====Images====
Some game images include text. A full translation would need modified versions of those. <nowiki>[Insert list of relevant files here]</nowiki>.
+
Some game images include text. A full translation would need modified versions of those. Here goes a full list:
 +
 
 +
lbm/activity.[0-1].png, modules.[0-15].png, newgame.[0-5].png, playmenu.[0-37,58-66].png, shipyard.[3-16,20,22,23].png, sismods.55.png, title.png, title.0.png
 +
 
 +
melee/melebkgd.[0-27].png
 +
 
 +
lastbat/lascap.0.png
 +
 
 +
sis_ship/siscap.[0,9-14].png
 +
 
 +
shofixti/oldcap.0.png, shocap.[0,12-19].png
 +
 
 +
ipanims/lander.32.png, orbenter.0.png
 +
 
 +
slides/intro/title.[1-2].png
 +
 
 +
slides/ending/ending.6.png
  
 
====Speech====
 
====Speech====
 
If you want to dub the actual speech, you'll need to create new versions of the .ogg files in comm/<race>/ in the content dir. You'll also need to create new .ts files for synchronisation with the subtitles. See [[#Tools|Tools]] below.
 
If you want to dub the actual speech, you'll need to create new versions of the .ogg files in comm/<race>/ in the content dir. You'll also need to create new .ts files for synchronisation with the subtitles. See [[#Tools|Tools]] below.
 +
 +
====Sounds====
 +
In melee, some ships play sound effects containing speech. Here's a list:
 +
 +
orz/intruder.wav, secondary.wav
 +
 +
pkunk/insult[01-14].wav
 +
 +
slylandr/secondary.wav
 +
 +
urquan/secondary.wav
  
 
====Documentation====
 
====Documentation====
 
The game comes with several documentation files. In particular the game manual would be a good candidate for translation.
 
The game comes with several documentation files. In particular the game manual would be a good candidate for translation.
 
  
 
===Tools===
 
===Tools===
The Russion translation project created a program to make editing the UQM fonts easy. It's available [http://cs.ozerki.net/zap/sc2-rus/ here].
+
The Russian translation project created a program to make editing the UQM fonts easy. It's available [http://cs.ozerki.net/zap/sc2-rus/ here].
  
 
Unix-like systems will have a program '''iconv''' which can be used to easilly change the encoding of a text file (from latin1 to UTF-8 for instance).
 
Unix-like systems will have a program '''iconv''' which can be used to easilly change the encoding of a text file (from latin1 to UTF-8 for instance).
Line 59: Line 89:
 
A tool for generating the time stamps used to synchronise the speech with the subtitles is available in the official CVS tree of the [[The Ur-Quan Masters]] project, in the '''tools''' module. [http://cvs.sourceforge.net/viewcvs.py/sc2/tools/synch/]
 
A tool for generating the time stamps used to synchronise the speech with the subtitles is available in the official CVS tree of the [[The Ur-Quan Masters]] project, in the '''tools''' module. [http://cvs.sourceforge.net/viewcvs.py/sc2/tools/synch/]
  
 +
==Translation projects==
  
==Translation projects==
+
===Finnish===
 +
Project site: http://web.archive.org/web/20090306075410/http://www2.kyamk.fi/~vi3dhepe/uqm-fin/index.html
 +
 
 +
Download link: http://koti.mbnet.fi/tuukkar/uqm_fin_099.zip
 +
 
 +
Forum thread: [http://uqm.stack.nl/forum/index.php?topic=2070.0]
 +
 
 +
Status: almost complete
  
 
===German===
 
===German===
Line 71: Line 109:
 
CVS tree: http://cvs.berlios.de/cgi-bin/viewcvs.cgi/sc2de/Sternkontrolle/
 
CVS tree: http://cvs.berlios.de/cgi-bin/viewcvs.cgi/sc2de/Sternkontrolle/
  
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=1952.0], [http://uqm.stack.nl/forum/index.php?topic=2070.0], [http://uqm.stack.nl/forum/index.php?topic=2236.0]
+
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=1952.0], [http://uqm.stack.nl/forum/index.php?topic=2070.0], [http://uqm.stack.nl/forum/index.php?topic=2236.0] [http://forum.uqm.stack.nl/index.php?topic=4879.0]
  
 
Status: almost complete
 
Status: almost complete
  
===Finnish===
+
===Italian===
Project site: http://www.kyamk.fi/~vi3dhepe/uqm-fin/index.html
+
Home page: http://urquanitalia.blogspot.it
 +
 
 +
The project is just started. We need help. If interested in contributing contact [mailto:giacomog88@gmail.com Giacomo]
  
Forum thread: [http://uqm.stack.nl/forum/index.php?topic=2070.0]
+
Forum thread: [http://forum.uqm.stack.nl/index.php?topic=5252.0]
  
Status: almost complete
+
Status: ?%, accelerating towards light speed
  
 
===Japanese===
 
===Japanese===
 
There currently is no Japanese translation project underway, but the original 3DO version was also released in Japanese. We have a copy, and if the copyrights allow it, we may be able to add Japanese speech files without much problems.
 
There currently is no Japanese translation project underway, but the original 3DO version was also released in Japanese. We have a copy, and if the copyrights allow it, we may be able to add Japanese speech files without much problems.
  
Bugzilla entry: [http://uqm.stack.nl/cgi-bin/bugs/show_bug.cgi?id=605 #605]
+
Bugzilla entry: [[uqmbug:605|#605]]
  
 
Status: 0% complete
 
Status: 0% complete
  
 
===Polish===
 
===Polish===
Main site: http://uqm.prv.pl
+
For information contact [mailto:arael@tenbit.pl Arael]
(for now, contact '''arael@tenbit.pl''')
 
  
 
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=2391]
 
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=2391]
  
Status: just started
+
Status: temporarily stalled
  
 
===Portuguese===
 
===Portuguese===
Line 102: Line 141:
 
Project Site: http://pt-masters.net/
 
Project Site: http://pt-masters.net/
  
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=2425.0],[http://uqm.stack.nl/forum/index.php?topic=2044.0], [http://uqm.stack.nl/forum/index.php?topic=2070.0]
+
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=2425.0],[http://uqm.stack.nl/forum/index.php?topic=2044.0], [http://uqm.stack.nl/forum/index.php?topic=2070.0], [http://uqm.stack.nl/forum/index.php?topic=3639.0]
  
 
Status: Just Started
 
Status: Just Started
  
 
===Russian===
 
===Russian===
Main site: http://cs.ozerki.net/zap/sc2-rus/
+
Main site: http://uqm-rus.uvw.ru/
  
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=2070.0], [http://uqm.stack.nl/forum/index.php?topic=1952.0], [http://uqm.stack.nl/forum/index.php?topic=2221.0]
+
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=2070.0], [http://uqm.stack.nl/forum/index.php?topic=1952.0], [http://uqm.stack.nl/forum/index.php?topic=2221.0] [http://uqm.stack.nl/forum/index.php?topic=2426.0]
  
Status:  
+
Status: complete
  
 
===Spanish===
 
===Spanish===
Lot of help is needed.
+
The Spanish translation project has been halted at 80%. The last available version of the translation only works for uqm v0.6.2.
Main site: http://www.custom-creations.org/~starsite/UQM-spa/
+
A playable translation for Windows (uqm v0.6.2 + translation installer) can be found here as a .zip file:
 +
 
 +
[https://drive.google.com/open?id=0B5ZR7n6oIvzbNWdtT0lENlJLRUk Download] (311 MB)
 +
 
 +
Contact [mailto:tehvolka@gmail.com Volka] if you're interested in contributing.
 +
 
 +
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=2070.0] [http://uqm.stack.nl/forum/index.php?topic=2332.0] [http://uqm.stack.nl/forum/index.php?topic=2633.0]
  
Forum threads: [http://uqm.stack.nl/forum/index.php?topic=2070.0] [http://uqm.stack.nl/forum/index.php?topic=2332.0]
 
  
Status: Just started.
+
[[Category:About the Star Control series]]

Latest revision as of 16:00, 11 June 2017

This article describes the current localization efforts in the The Ur-Quan Masters project.

General information[edit]

Current status[edit]

The resource system is suitable for creating language packs. An add-on package can be created to override any content file.

The game works with UTF-8 encoded UNICODE characters. The currently available characters are mostly the ASCII characters. The various translation projects use their own characters where needed. Eventually, we will want to have shared font packs.

Currently, all text is in simple text files. Eventually, we'll move to a richer XML-based file format. A conversion tool will be created to convert existing material.

Some text still is hard-coded in the game. This will change at some point in the future.

Currently, only left-to-right writing systems are supported.

Support for non-ascii input in text fields is still limited.

Using language packs[edit]

A language pack can be used like any other add-on package.

Creating language packs[edit]

Language packs are normal add-on packages, which means they will be a .zip file (renamed to .uqm), with in it a directory structure which overrides the files in the default content.

NOTE: You can skip manually extracting files below and use the contents of this skeleton translation pack.

Text files[edit]

The game expects all of its text files to be in UTF-8 format.

The subtitle files can be found in comm/<race>/<race>.txt in the content tree.

The melee strings for the various ships can be found in the <race>/<race>.txt files.

The text displayed for planetary exploration finds is contained in the ipanims/*.txt files.

The file lbm/starcon.txt contains various other game strings.

The file slides/intro/intro.txt contains the text for the intro sequence, as used by the DOS version of Star Control II. The files slides/ending/victory1.txt, slides/ending/victory2.txt and slides/ending/final.txt contain the text for the victory slides.

Hard-coded strings[edit]

There are several places in the game where strings are used that are hard-coded in the source code. Most of those are error strings you may never see, but some are actually important in the game. For now, it would be best to ignore these strings, and translate them when these strings are no longer hard-coded. If you do translate them at this time, you would need to distribute game binaries of your own.

Fonts[edit]

If you need additional characters you will need to add appropriate entries to the font dirs slides/slides.fon/, ipanims/lander.fon/, lbm/micro.fon/, lbm/tiny.fon/, lbm/player.fon/, lbm/starcon.fon/, credits/pt13.fon, credits/pt17.fon, credits/pt45.fon and comm/<race>/<race>.fon/ (note that starbas.fon, rebel.fon and spahome.fon do not exist). The number of the file is the UNICODE character code converted into decimal (from hex). Here are the official UNICODE character code charts. For hex-decimal conversion you can use this online converter.

Note that translation projects for other languages may have already created glyphs usable for your language.

Images[edit]

Some game images include text. A full translation would need modified versions of those. Here goes a full list:

lbm/activity.[0-1].png, modules.[0-15].png, newgame.[0-5].png, playmenu.[0-37,58-66].png, shipyard.[3-16,20,22,23].png, sismods.55.png, title.png, title.0.png

melee/melebkgd.[0-27].png

lastbat/lascap.0.png

sis_ship/siscap.[0,9-14].png

shofixti/oldcap.0.png, shocap.[0,12-19].png

ipanims/lander.32.png, orbenter.0.png

slides/intro/title.[1-2].png

slides/ending/ending.6.png

Speech[edit]

If you want to dub the actual speech, you'll need to create new versions of the .ogg files in comm/<race>/ in the content dir. You'll also need to create new .ts files for synchronisation with the subtitles. See Tools below.

Sounds[edit]

In melee, some ships play sound effects containing speech. Here's a list:

orz/intruder.wav, secondary.wav

pkunk/insult[01-14].wav

slylandr/secondary.wav

urquan/secondary.wav

Documentation[edit]

The game comes with several documentation files. In particular the game manual would be a good candidate for translation.

Tools[edit]

The Russian translation project created a program to make editing the UQM fonts easy. It's available here.

Unix-like systems will have a program iconv which can be used to easilly change the encoding of a text file (from latin1 to UTF-8 for instance).

A tool for generating the time stamps used to synchronise the speech with the subtitles is available in the official CVS tree of the The Ur-Quan Masters project, in the tools module. [1]

Translation projects[edit]

Finnish[edit]

Project site: http://web.archive.org/web/20090306075410/http://www2.kyamk.fi/~vi3dhepe/uqm-fin/index.html

Download link: http://koti.mbnet.fi/tuukkar/uqm_fin_099.zip

Forum thread: [2]

Status: almost complete

German[edit]

Home page: http://sc2de.berlios.de/

Project site: http://developer.berlios.de/projects/sc2de/

Download: http://developer.berlios.de/project/showfiles.php?group_id=818

CVS tree: http://cvs.berlios.de/cgi-bin/viewcvs.cgi/sc2de/Sternkontrolle/

Forum threads: [3], [4], [5] [6]

Status: almost complete

Italian[edit]

Home page: http://urquanitalia.blogspot.it

The project is just started. We need help. If interested in contributing contact Giacomo

Forum thread: [7]

Status: ?%, accelerating towards light speed

Japanese[edit]

There currently is no Japanese translation project underway, but the original 3DO version was also released in Japanese. We have a copy, and if the copyrights allow it, we may be able to add Japanese speech files without much problems.

Bugzilla entry: #605

Status: 0% complete

Polish[edit]

For information contact Arael

Forum threads: [8]

Status: temporarily stalled

Portuguese[edit]

The project has already been started. Plans are to do both a Brazilian and Portuguese version. A call for contributors has been made. Contact nightshadow if interested.

Project Site: http://pt-masters.net/

Forum threads: [9],[10], [11], [12]

Status: Just Started

Russian[edit]

Main site: http://uqm-rus.uvw.ru/

Forum threads: [13], [14], [15] [16]

Status: complete

Spanish[edit]

The Spanish translation project has been halted at 80%. The last available version of the translation only works for uqm v0.6.2. A playable translation for Windows (uqm v0.6.2 + translation installer) can be found here as a .zip file:

Download (311 MB)

Contact Volka if you're interested in contributing.

Forum threads: [17] [18] [19]