<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="../../style.css">
<title>
Gambas Documentation - How To Translate A Gambas Project
</title>
</head>
<table class="none" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr><td align="left">
<font size="-1">
<a href="../../help+en"><img class="flag" alt="Home" border="0" src="../../img/lang/en.png" align="center"></a>&nbsp;
<a href="../howto+en">Up</a>&nbsp;
<a href="parport+en">Previous</a>&nbsp;
<a href="translate-ide+en">Next</a>&nbsp;
</td></tr></table>
<div class="notab">
<h1>
How To Translate A Gambas Project
</h1>
To <a href="../def/translate+en">translate</a> a project into your own language, open it in the IDE, and click on <i><a href="../def/translate+en">translate</a>...</i> in the <i>Project</i> menu. (If the IDE complains about msgmerge, make sure you have GNU gettext on your computer)
<p>
<img src="../../image/howto/translate/+translate.png+en" alt="Translation Dialog">
<p>
Then, select your translation language in the combo-box.
<p>
<img src="../../image/howto/translate/+combo.png+en" alt="Language Combo-Box">
<p>
<b>Note:</b> If you need translating into a language that does not exist in the list, write me and I will add it.
<p>
Select a untranslated string in the table.
<p>
<img src="../../image/howto/translate/+select.png+en" alt="Select A String To Translate">
<p>
Then enter its translation into the text field on the bottom of the dialog.
<p>
<img src="../../image/howto/translate/+enter.png+en" alt="String Translation">
<p>
Repeat this process until every string is translated. When you have finished, click on the <i>Close</i> button.
<p>
<b>Note:</b> You can <a href="../def/translate+en">translate</a> the project in several shots.
<p>
You can play with toolbar icons.
<p>
<img src="../../image/howto/translate/+toolbar.png+en" alt="Toolbar">
<p>
From left to right, these icons allow you to:
<ul>
<li>Save the current translation.
<li>Reload the current translation. All your changes are lost.
<li>Delete the current translation.
<li>Duplicate an already existing translation.
<li>Export the current translation to a file.
<li>Merge a translation file into the current one.
<li>Verify the current translation, by checking that every symbol character is preserved.
<li>Search a text inside the strings to <a href="../def/translate+en">translate</a>, or the translated strings.
<p>
</ul>

<b>Note:</b> You can indicate that a string must not be translated by entering a single minus character as translated string.
<p>
The result of your translation is stored in a <tt>*.po</tt> file stored in the .lang directory of the project. The name of this file depends on the language. For example, the french translation is named <tt>fr.po</tt>.
<p>
<b>Note:</b> Each time you make a new version of your project, untranslated strings may change. But don't worry, your translated strings are preserved.
<p>
<ul>
<li>If an untranslated string disappears, the translation disappears with it.
<li>If a new untranslated string is added, it gets a void translation.
<li>All other untranslated strings keep their translation.
</ul>

</div>
</body>
</html>

