You are not logged in.

#1 2007-04-16 16:10:07

Eóin
Administrator
From: Ireland
Registered: 2006-08-08
Posts: 473
Website

How to make Translations

Hello,

I finally managed to get the SVN repo working properly whereby I have now setup a folder 'lang' which can house the translation files.

I decided to opt for Subversion as the means of managing these files over an earlier idea of using a wiki page per language. The reason for this is due to the way the files themselves will change inclemently and
a wiki page would have quickly become very unwieldy. Unfortunately this does mean the any translators will need to use SVN too. However, anyone who doesn't want to go to that difficultly can get in touch with me through email.

For those happy to use the SVN setup let me explain how to use it. I'd recommend RapidSVN as an easy to use GUI to Subversion. When you fire it goto 'Bookmmarks' >> 'Add existing repository' and use the URL 'svn://svn.geekisp.com/halite'. To get write access to the lang folder you need to use the user name and password. To try and avoid casual spam these won't be posted but are availible upon request, just send me a mail.

The language files are the .TXT files, the .RC files are generated automatically from the .TXT files and don't need to be worried about.

So if you want to contribute a translation download the Template.txt file and rename it to your language. When naming the file try to stick to non-unicode filenames, inside the files you can of course use unicode as necessary.

The file will look something like this-

"English" --->  ???
"MS Shell Dlg" --->  ???
"Torrent" --->  ???
"Tracker" --->  ???
"" --->  ???
"msctls_progress32" --->  ???
"N/A" --->  ???

Replace the '???'s with your translations, any you don't add will remain in English. This can be an incremental process, half translated files will work, they'll just still conain some English text. Also note that not all strings should be translated, for example "msctls_progress32" needs to remain as it is. In future I'll screen those bits of text out to avoid any confusion but for the moment if you do translate something which needed to remain unchanged I can fix that so it's no problem. So for example you might end up with a file like the following-

"English" --->  "1337"
"MS Shell Dlg" --->  ???
"Torrent" ---> "70|2|23n7"
"Tracker" ---> "7|24CK3|2"
"" --->  ???
"msctls_progress32" --->  ???
"N/A" ---> "N/4"

Also note that the very first string "English" should be set to the language name, here you can use unicode and this name is what the UI will use when presenting a list of language options to users. If you run into any troubles committing these files back onto the repository send them to me in an email and I'll do it.

I probably didn't make that all very clear but I'll start a thread in the forums which will be the ideal place to ask any questions. Hopefully that will address any issues people might run into.

Finally let me just say thanks to anyone who volunteers to do a translation, it's very much appreciated. And again let me say that this will be an incremental process, half-done translations are still very much appreciated.

Last edited by Tw@in 28 (2008-06-22 16:56:52)

Offline

 

#2 2007-04-16 20:43:58

SledgeDG
New member
Registered: 2007-04-16
Posts: 6

Re: How to make Translations

I downloaded the recommended RapidSVN,  Login worked just fine.
But for some reason I neither can't figure out how to get the template.txt to export to my comp nor how to edit it online. All I get are Errormessages like the requestet data is a file, not a directory (na doh) etc.
Do you think you could have the actual Template.txt in English somewhere as a downloadable file. On subsequent versions I could run my own Diff...no problem.
Thanks
-DG

Offline

 

#3 2007-04-17 03:40:28

webdr
Member
Registered: 2007-01-03
Posts: 70

Re: How to make Translations

Turkish is uploaded to SVN.

SledgeDG try different repository browser.

Offline

 

#4 2007-04-17 04:39:52

devGod
Member
Registered: 2007-01-05
Posts: 70

Re: How to make Translations

About the language name.

Do you want it like:
"English" --> "Dutch"
or:
"English" --> "Nederlands"

Offline

 

#5 2007-04-17 04:57:20

cyRq
New member
Registered: 2007-01-04
Posts: 7

Re: How to make Translations

Polish translation uploaded.
Not fully translated yet but It will be updated.

Offline

 

#6 2007-04-17 04:57:42

webdr
Member
Registered: 2007-01-03
Posts: 70

Re: How to make Translations

devGod wrote:

About the language name.

Do you want it like:
"English" --> "Dutch"
or:
"English" --> "Nederlands"

I think Netherlands is the country and the Dutch is the official language of Netherlads.

Offline

 

#7 2007-04-17 06:15:35

Eóin
Administrator
From: Ireland
Registered: 2006-08-08
Posts: 473
Website

Re: How to make Translations

Hi webdr and cyRq, thanks I really appreciate your help. The UI will need to be tweaked so that the translates string fit. I'm not sure yet if I'll try to find one size fits all or make the adjustments on a per language basis I'll have to look into it properly but first I want to tackle the bug reported by kapsnet and bug.

I thought I'll post some instructions on using the commandline svn approach which in many ways is much simpler to RapidSVN.

To login in for the first time cd the a desired working directory and issue the command

Code:

svn checkout svn://svn.geekisp.com/halite/lang

That should download all the language files. Now if there isn't already a translation for language make a copy of the Template.txt file renamed appropriately. Then add this file to the local repository with the command

Code:

svn add ./lang/NewLang.txt

In future you won't need to perform these two steps, instead you need only cd to your local working directory and issue the command

Code:

svn update

I would recommend always updating your local repo in case someone else has modified your translation file since you last updated it.

Finally after you've made changes you can commit them back to the online repository with the simple command

Code:

svn commit ./lang --username the_user_name --message "Some message just needed for the logs."

You'll also be asked for the password at this point.

Hope that proves helpful, thanks again to everyone for their help.

Offline

 

#8 2007-04-17 09:11:52

SledgeDG
New member
Registered: 2007-04-16
Posts: 6

Re: How to make Translations

German translation uploaded to SVN
I tried to stay within the boundaries of the English template, as much as possible.
But I would like very much  a way to crosscheck with the actual Program.
Meaning the ability for Halite to use an external language file, just to prevent messing up the GUI
-DG

Last edited by SledgeDG (2007-04-18 04:13:42)

Offline

 

#9 2007-04-18 03:31:21

devGod
Member
Registered: 2007-01-05
Posts: 70

Re: How to make Translations

webdr wrote:

devGod wrote:

About the language name.

Do you want it like:
"English" --> "Dutch"
or:
"English" --> "Nederlands"

I think Netherlands is the country and the Dutch is the official language of Netherlads.

It says Nederlands, not Netherlands.

Nederlands is how the Dutch call their language.

Offline

 

#10 2007-04-18 07:14:55

Eóin
Administrator
From: Ireland
Registered: 2006-08-08
Posts: 473
Website

Re: How to make Translations

SeldgeDG, thanks really appreciated. Have two very busy days ahead of me so won't be able to address what you've said just at the mo, but I won't forget.

devGod, didn't realise myself that you typed "Nederlands". I would say yes use the native word for the language, I think that's what users would expect.

Offline

 

#11 2007-04-19 10:02:25

SledgeDG
New member
Registered: 2007-04-16
Posts: 6

Re: How to make Translations

Don't you worry about it, Eoin. No rush. I just can't see you tweaking GUIs for every language, every time. Just set the parameters once (as wide as possible) and let the translators take care of the rest.
When I translated the 2.8 (by editing the .EXE) I had to modify the GUI at 2 or 3 spots (which is not bad, really...in  Foxit Reader it used to be more like 25 - 30 locations). German Language tends to be lenghty at times big_smile
My goal is to keep it short and snappy without changing the actual meaning.We're getting there big_smile :up: :up:

-DG

Offline

 

#12 2007-04-19 16:05:19

upurii
Member
From: France
Registered: 2007-02-14
Posts: 18
Website

Re: How to make Translations

Hi. I am actually translating Halite in french, but I have a little question. It will be possible to check the tranlation with the next Halite for testing, before the publication ? I ask it because, some things are a bit difficult to translate without the program (for a better translation). ^^

Offline

 

#13 2007-04-20 06:40:22

webdr
Member
Registered: 2007-01-03
Posts: 70

Re: How to make Translations

Hi upurii,

from Eoin

The UI will need to be tweaked so that the translates string fit. I'm not sure yet if I'll try to find one size fits all or make the adjustments on a per language basis I'll have to look into it properly but first I want to tackle the bug reported by kapsnet and bug.

Offline

 

#14 2007-04-20 11:27:43

devGod
Member
Registered: 2007-01-05
Posts: 70

Re: How to make Translations

Dutch translation is up. Now to wait for a Halite version where I can tweak the strings to better fit the space. smile

Offline

 

#15 2007-04-20 13:16:24

upurii
Member
From: France
Registered: 2007-02-14
Posts: 18
Website

Re: How to make Translations

Ok webdr. ^^

Like devGod , I will wait to tweak the translation for a correct one. The french translation will be up tomorrow or sunday.

EDIT: Ok i think it's correctly uploaded. I hope I don't have make some mistakes in the process. hmm

Last edited by upurii (2007-04-21 07:34:08)

Offline

 

#16 2007-04-21 13:29:36

devGod
Member
Registered: 2007-01-05
Posts: 70

Re: How to make Translations

SVN Updated correctly for me. smile

Offline

 

#17 2007-04-21 14:18:56

upurii
Member
From: France
Registered: 2007-02-14
Posts: 18
Website

Re: How to make Translations

cool. ^^

Last edited by upurii (2007-04-21 14:19:28)

Offline

 

#18 2007-04-22 23:39:49

chiclete
New member
Registered: 2007-03-10
Posts: 4

Re: How to make Translations

I'm getting this erros:

Code:

Can't check path 'svn:\\svn.geekisp.com\halite\lang\NewLang.txt': The filename, directory name, or volume label syntax is incorrect.

Last edited by chiclete (2007-04-22 23:40:19)

Offline

 

#19 2007-04-23 00:26:56

webdr
Member
Registered: 2007-01-03
Posts: 70

Re: How to make Translations

chiclete wrote:

I'm getting this erros:

Code:

Can't check path 'svn:\\svn.geekisp.com\halite\lang\NewLang.txt': The filename, directory name, or volume label syntax is incorrect.

http://tortoisesvn.net/ another rep. browser

Offline

 

#20 2007-04-23 04:47:08

Eóin
Administrator
From: Ireland
Registered: 2006-08-08
Posts: 473
Website

Re: How to make Translations

Hi chiclete, try it with forward slashes, '/', I think Subversion requires them.

Offline

 

#21 2007-04-23 08:44:01

SledgeDG
New member
Registered: 2007-04-16
Posts: 6

Re: How to make Translations

@webdr: Thank you for the link to TortoiseSVN !!
I just checked it out and I must say I like it  much better than RapidSVN.
It integrates with Explorer, so all the relevant actions are acessible by a simple right-click.
PLUS the changing icons make it very easy to spot which file was changed and which file hasn't been sent to the repository yet.

-DG

Offline

 

#22 2007-04-25 15:48:18

Lost Angel
Member
Registered: 2007-03-20
Posts: 41
Website

Re: How to make Translations

ok, will start with Russian version this week.
--update--
took me longer, but now Russian version is done.

Last edited by Lost Angel (2007-05-06 16:44:46)

Offline

 

#23 2007-06-07 11:50:59

Tw@in 28
Moderator
Registered: 2007-04-03
Posts: 793

Re: How to make Translations

Italian translation is now online. Since the user proposing himself as translator didn't do it, I did.... tongue

Excelsior! big_smile


Tw@in 28
Halite's Official Italian Translator, Super Moderator®

***PLEASE NOTE: When posting new bugs, check the forum if it's really a new one: if not, avoid double posting. It's also higly advisable if you'd post it in the appropriate "Halite v. x.x.x.xxx" topics in the Troubleshoot area: it helps Eóin track it back, and keeps forums clean. ***

Offline

 

#24 2007-06-10 17:38:52

Gorgonvakt
Member
Registered: 2006-12-12
Posts: 24

Re: How to make Translations

Norwegian translation is also online. This is a rough draft and I have to see the result in Halite before I can tune the length of the text and fine tune the words.

Hope Norwegian will be included in the next release :-)

\\gorgonvakt

Offline

 

#25 2008-02-25 08:42:57

Eóin
Administrator
From: Ireland
Registered: 2006-08-08
Posts: 473
Website

Re: How to make Translations

Thanks rugas, I've received your email and will get it online very soon.

Offline

 

Board footer

Powered by PunBB
© Copyright 2002–2008 PunBB