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 ..

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.

Originally Posted by SupuS

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

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

[SupuS]

Originally Posted by falko

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]

Originally Posted by SupuS

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]

Originally Posted by psaingtong

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]

Originally Posted by falko

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.