Translation HowTo

[SupuS]

Hi all ..

I translated ispconfig to czech language .. and here is small guide how you can translate ispconfig to your language too .. sorry for my english .. :rolleyes:

I hope it somebody helps ..

I wanted use utf-8 but it was not work properly .. so I used my national charset encoding .. I translated to czech language so I used cz as my lang and iso-8859-2 charset encoding.

1. copy english language files

you can use this to locate *.lng and *.hlp english files:


# locate en.lng


if you want translate help files too ..


# locate *.hlp |grep en


You can copy /root/ispconfig/isp/standard_index.html_en too if you want have localize standard index

copy these files to new one .. in my case I copied its to cz.lng, cz*.hlp and standard_index.html_cz

2. change setting in config.inc.php
edit /home/admispconfig/ispconfig/lib/config.inc.php from

$go_info["server"]["lang"] = "en";
$go_info["theme"]["charset"] = "iso-8859-1";

to your language setting .. in my case to

$go_info["server"]["lang"] = "cz";
$go_info["theme"]["charset"] = "iso-8859-2";


3. first testing if everything is ok ..
reload your ispconfig .. if you don't see any changes all is ok :)

4. Now translate text in new created files to your language ..
remember that you have to use right charset encoding .. same as you will use on ispconfig pages. It will be a lot of work .. you will translate a lot of sentenses more than once .. so be patient .. sometimes check your work by reloading ispconfig .. it should be partialy translated ..

Done? Now you have to change charset encoding in some files.

5. changing and adding meta tags

For properly working encoding you have to change or insert meta tags to some files .. here is list of its ..

change from

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">

to (change to your needs)

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-2">


or simply insert new line with (change to your needs)


<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-2">


in

/home/admispconfig/ispconfig/web/index.html (you can change title to your needs too ..)

menu files (put meta tag after <title></title> tag):
/home/admispconfig/ispconfig/web/admin/inhalt_tree.php
/home/admispconfig/ispconfig/web/help/inhalt_tree.php
/home/admispconfig/ispconfig/web/isp_dns/inhalt_tree.php
/home/admispconfig/ispconfig/web/isp_fakt/inhalt_tree.php
/home/admispconfig/ispconfig/web/isp_file/inhalt_tree.php
/home/admispconfig/ispconfig/web/isp_kunde/inhalt_tree.php
/home/admispconfig/ispconfig/web/isp_manager/inhalt_tree.php
/home/admispconfig/ispconfig/web/multidoc/inhalt_tree.php
/home/admispconfig/ispconfig/web/tools/inhalt_tree.php

"loading folders" files (put meta tag after <title></title> tag):
-- in these files change english text to your language too if you don't like "loading folders"

/home/admispconfig/ispconfig/web/admin/vorladen.php
/home/admispconfig/ispconfig/web/help/vorladen.php
/home/admispconfig/ispconfig/web/isp_dns/vorladen.php
/home/admispconfig/ispconfig/web/isp_fakt/vorladen.php
/home/admispconfig/ispconfig/web/isp_file/vorladen.php
/home/admispconfig/ispconfig/web/isp_kunde/vorladen.php
/home/admispconfig/ispconfig/web/isp_manager/vorladen.php
/home/admispconfig/ispconfig/web/multidoc/vorladen.php
/home/admispconfig/ispconfig/web/tools/options/vorladen.php
/home/admispconfig/ispconfig/web/tools/vorladen.php

6. Translating of error pages

Go to /root/ispconfig/isp/ and copy error_en to error_XX (in my case error_cz) and edit *.html files in created directory.

And it is all .. that was quite easy .. wasn't that? :)

Little suggestion for Falco and Till .. if it is possible it would be nice to have meta tags in files listed here with charset encoding variable from config.inc.php file .. translation will be more easy ..

SupuS

[falko]

Nice guide. I think we can refer to this if anyone else is asking for translation guidelines. :)


Little suggestion for Falco and Till .. if it is possible it would be nice to have meta tags in files listed here with charset encoding variable from config.inc.php file .. translation will be more easy ..

SupuSWe'll check if/how this can be done. :)

[SupuS]

Nice guide. I think we can refer to this if anyone else is asking for translation guidelines. :)

We'll check if/how this can be done. :)

Thank you Falko .. for great peace of software :) Maybe I can create a little howto for template changing if somebody wants ..

[falko]

Maybe I can create a little howto for template changing if somebody wants ..
I think there are lots of people who'd want this. :) Some have already asked in the forum... ;)

[VMartins]

congratulations SupuS,

I will follow this guide and build the Brazilian Portuguese version of ISPConfig.

What I have to do after this translation to publish to anothers users?

Regards

Vinicius

[Hans]

Contact Till. He can provide you an account for the SVN repository, so you can tranfer your work into it. If you do so, your work will be integrated in a near future release of ISPConfig.

[psaingtong]

Hi,
I have Thai version of ISPconfig .Tell me about publish to your team.

[till]

Hi,
I have Thai version of ISPconfig .Tell me about publish to your team.

Thanks for translating ISPConfig to Thai. Please send the languages files to dev [at] ispconfig [dot] org

[nenad]

Nice guide. I think we can refer to this if anyone else is asking for translation guidelines. :)

We'll check if/how this can be done. :)

just an idea...:

in osCommerce they put this lines in some english.php file located under /languages:

------------------------------------------------------------------
// look in your $PATH_LOCALE/locale directory for available locales..
// on RedHat6.0 I used 'en_US'
// on FreeBSD 4.0 I use 'en_US.ISO_8859-1'
// this may not work under win32 environments..
setlocale(LC_TIME, 'en_US.ISO_8859-1');
define('DATE_FORMAT_SHORT', '%m/%d/%Y'); // this is used for strftime()
define('DATE_FORMAT_LONG', '%A %d %B, %Y'); // this is used for strftime()
define('DATE_FORMAT', 'm/d/Y'); // this is used for date()
define('PHP_DATE_TIME_FORMAT', 'm/d/Y H:i:s'); // this is used for date()
define('DATE_TIME_FORMAT', DATE_FORMAT_SHORT . ' %H:%M:%S');
....
....
and these lines too:

// Global entries for the <html> tag
define('HTML_PARAMS','dir="ltr" lang="en"');

// charset for web pages and emails
define('CHARSET', 'iso-8859-1');
.....
.....

---------------------------------------------------


and somewhere in some file...

...
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN">
<html <?php echo HTML_PARAMS; ?>>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=<?php echo CHARSET; ?>">
<title><?php echo TITLE; ?></title>
<link rel="stylesheet" type="text/css" href="includes/stylesheet.css">
<script language="javascript" src="includes/general.js"></script>
</head>
....

[till]

A setting for the chraset is already in the config.inc.php file. Are the global entries for the HTML tag nescessray? Then we will add them too.

[SupuS]

A setting for the chraset is already in the config.inc.php file. Are the global entries for the HTML tag nescessray? Then we will add them too.

Yes charset HTML tags are necessary for right show national charsets :) .. you will safe a lot of work if you will add them ;)

[till]

Yes charset HTML tags are necessary for right show national charsets :) .. you will safe a lot of work if you will add them ;)

Charsets can already be set in config.inc.php, my question was if:

dir="ltr" lang="en"

in the tad <html dir="ltr" lang="en"> is really nescessary or just nice to have :)

[SupuS]

Charsets can already be set in config.inc.php, my question was if:

dir="ltr" lang="en"

in the tad <html dir="ltr" lang="en"> is really nescessary or just nice to have :)

I saw bold text only ;) .. this tag elements are relevant for xhtml only .. so I think it isn't necessary for ispconfig now .. because it is in html. Change ispconfig to xhtml valid will be hard work .. because it use xhtml invalid elements in code .. adding dir="ltr" lang="en" elements and changing DTD is not sufficient to valid xhtml code

[Blackknight]

Has anybody started a Spanish translation? I'm not a native speaker but I could make one.

[falko]

Spanish is available in ISPConfig but I think the translation isn't complete. :(

[sinjab]

Thanks for the great ISPConfig.

Yes till, <html dir="rtl"> is really necessary for Arabic and other right-to-left languages.

[TomTom80]

Hello,

I had to add following line (under <head> tag) in all inhalt_tree.php files under /home/admispconfig/web because FireFox do charset enconding according to each frame.

<meta http-equiv="Content-Type" content="text/html; charset=<?php echo $go_info["theme"]["charset"]; ?>">

Tom

[zapperen]

Nice guide!
ISPConfig in norwegian is almost finished. Have to edit standard index files first.

[SCelik]

I'm translating ispconfig to Turkish. Language & html files ok but how about database backend? When sorting in Turkish, some letters must be placed between c and d, h and j.. etc. So to do this, in db backend you have to use utf8 or latin5. i think utf8 fits all of us?

why don't you code pages in utf8 charset and also set db charset..?

[digicon]

hello everyone!
i am new at ispconfig, now i have translate Isp config in japanese from english, i have already change all en.lng files by the direction from this forums, (i make jp.lng files )
but the problem now i am facing is ,
1. after completing translation including changing the charshet of config.inc.php(i changed it to UTF-8) , when i add client and login to that client management by browser, then nothing can be seen in browser.
2.if i login by using Internet Explorer, the management tools doesnt reloaded,
its give a massege like
Ordner werden geladen....
Loading folders....
is that anything probelm of my setting over tranlating? or the charshet i have choosed for ispconfig (UTF-8) is not appropiate for the translation of ispconfig.
on the other hand, the distribution is centos 5.1 ,and running over the kernel
2.6.18-53.1.14.el5xen.
please give me some suggegsotion.

[digicon]

am new at ispconfig, now i have translate Isp config in japanese from english, i have already change all en.lng files by the direction from this forums, (i make jp.lng files )
but the problem now i am facing is ,
1. after completing translation including changing the charshet of config.inc.php(i changed it to UTF-8) , when i add client and login to that client management by browser, then nothing can be seen in browser. (firefox)
2.if i login by using Internet Explorer, the management tools doesnt reloaded,
its give a massege like
Ordner werden geladen....
Loading folders....
is that anything probelm of my setting over tranlating? or the charshet i have choosed for ispconfig (UTF-8) is not appropiate for the translation of ispconfig.
on the other hand, the distribution is centos 5.1 ,and running over the kernel
2.6.18-53.1.14.el5xen.
please give me some suggegsotion.

[SupuS]

I'm translating ispconfig to Turkish. Language & html files ok but how about database backend? When sorting in Turkish, some letters must be placed between c and d, h and j.. etc. So to do this, in db backend you have to use utf8 or latin5. i think utf8 fits all of us?

why don't you code pages in utf8 charset and also set db charset..?

Hi SCelik

I tried set db to utf8 when installing on gentoo but ISPConfig seems to be incompatible with it so I have to use iso88591 with czech too (I didn't try iso88592). Czech special letters are on the end of the list.

[SCelik]

Hi SCelik

I tried set db to utf8 when installing on gentoo but ISPConfig seems to be incompatible with it so I have to use iso88591 with czech too (I didn't try iso88592). Czech special letters are on the end of the list.
But utf8 is neccesary for a software that has many languages :( Well, maybe in 3.x ? And it's good for a standard meta line for all languages? So we don't need to work on html files..

[Mike.G]

Hi, everyone,
I had translated those languages files to Chinese Version.
and I had changed the configuration files, and I used the UTF-8 as the encoding code, and
when I open the browser access the login page, it show the Chinese version web page, I think it it successed, but when I login in the system, I found the whole system is english version stiill, why ? what's that happen?
will i changed some options in control panel? but I had tried to found out what's that option, but i am failed, who can help me?
and I had sent email to Till, and sent those language files to him,
pls help me take a look.

thanks very much, everyone.


Mike.G

[Mike.G]

hello, guys,

I am use UTF-8 TOO.
after you login , you can see the correct menu(I mean after translate menu)?

Mike.G


am new at ispconfig, now i have translate Isp config in japanese from english, i have already change all en.lng files by the direction from this forums, (i make jp.lng files )
but the problem now i am facing is ,
1. after completing translation including changing the charshet of config.inc.php(i changed it to UTF-8) , when i add client and login to that client management by browser, then nothing can be seen in browser. (firefox)
2.if i login by using Internet Explorer, the management tools doesnt reloaded,
its give a massege like
Ordner werden geladen....
Loading folders....
is that anything probelm of my setting over tranlating? or the charshet i have choosed for ispconfig (UTF-8) is not appropiate for the translation of ispconfig.
on the other hand, the distribution is centos 5.1 ,and running over the kernel
2.6.18-53.1.14.el5xen.
please give me some suggegsotion.

[till]

Hello Mike,

please make sure that your files are named cn.lng, the part before the .lng must be 2 chars long, not longer. If this does not help, you will have to change the files to a specific locale, utf-8 is not tested with ISPConfig and I guess it might cause troubles.

[Mike.G]

Hi, Till,
I had changed all files name from zh-cn to cn.but can't work too.

I am not sure what's happen.

but I think it may be not encoding issue.

let me try to debug .

thanks

Mike.G

[altaibskt]

Hi there!

i am new here, and i would love to trans ISPConfig to Arabic, but i do not have any plase to test and i would realy need to test it online because i have to change it from left to right and i need to do some staff with the encoding to fitt the arabic... so how can we fix this

i have free time about one week from today... may be we can do it...

[Leszek]

You'd have to install ISPConfig somewhere and edit the hosts file to use a local domain name (/etc/hosts file for Linux).