<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Frepple / Translating the user interface </title>
<link rel='stylesheet' href='../styles.css' type='text/css' />
<!--PageHeaderFmt-->
</head>
<body>
<div id="container">
<div id="menubar">
<div id="logo" align="center">
<br/><img src='../frepple.bmp' alt="frepple" /><br/>
<a href='http://www.frepple.com/'>
<strong>a Free<br/>Production Planning<br/>Library</strong>
</a></div>
<div id="menu">
<br/>
<h3><a href='../Main/HomePage.html'>Main</a></h3>
<h3><a href='../UI/Main.html'>User Manual</a></h3>
<h3><a href='../Tutorial/Main.html'>Tutorial</a></h3>
<h3><a href='Main.html'>Reference Manual</a></h3>
<h3><a href='../Main/FAQ.html'>FAQ</a></h3>
<h3><a href='../reference/index.html'>C++ API</a></h3>
<br/><div>
</div>
</div>
</div>
<div id="content">
<br/>
<!--PageText-->
<div id='wikitext'>
<p><a class='wikilink' href='../Main/HomePage.html'>Main</a> > <span class='wikitrail'><a class='wikilink' href='Main.html'>Reference Manual</a> > <a class='wikilink' href='Developer.html'>Information for developers</a> > <a class='selflink' href='DeveloperTranslate.html'>Translating the user interface</a></span>
</p>
<p class='vspace'>This section provides step by step instructions on how to translate the user interface to your favorite language.
</p>
<div class='vspace'></div><ol><li>Edit the file contrib\django\freppledb\settings.py (or bin\settings.py in binary Windows installation).<br /> Add the language code and description to the variable LANGUAGES:
<pre> LANGUAGES = (
('nl', ugettext('Dutch')),
('en', ugettext('English')),
('it', ugettext('Italian')),
('zh-tw', ugettext('Traditional Chinese')),
)
</pre><div class='vspace'></div></li><li>You'll need to install a gettext catalogs (.po files) editor.<br /> Highly recommended is the poedit tool, which can be downloaded from <a target='_blank' class='urllink' href='http://www.poedit.net/' rel='nofollow'>http://www.poedit.net/</a>
<div class='vspace'></div></li><li>Copy the directory contrib\django\freppledb\locale\nl to a new subdirectory with the name of your language code.<br /> The possible language codes can be found on <a target='_blank' class='urllink' href='http://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes' rel='nofollow'>http://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes</a>
<div class='vspace'></div></li><li>Use poedit to open the files django.po and djangojs.po in the directories you just copied.<br /> Translating the strings in the file will take a while.<br /> Some words already have been translated by the Django project. A comment marks those and you can skip translating those.<br /> Make sure you keep the HTML in your translations valid.
<div class='vspace'></div></li><li>You can now test the translations, after a restart of the web server.<br /> FrePPLe will detect the language setting of your browser, so you need to configure your browser to have the new language as the preferred one.
<div class='vspace'></div></li><li>The installer also needs updating to recognize the new language.<br /> The files contrib\installer\parameters.ini and contrib\installer\frepple.nsi need straightforward editing.
</li></ol><p class='vspace'>The frePPle team is very keen on supporting additional languages. If you have questions or problems with any of the above we'll be glad to help you forward.
</p>
</div>
<!--PageFooterFmt-->
<!--HTMLFooter-->
</div></div>
</body>
</html>
