doxygen warnings and formatting fixes

[wxWidgets.git] / docs / doxygen / mainpages / translations.h

/////////////////////////////////////////////////////////////////////////////\r
// Name:        translations.h\r
// Purpose:     List of wxWidgets available translations\r
// Author:      wxWidgets team\r
// RCS-ID:      $Id$\r
// Licence:     wxWindows license\r
/////////////////////////////////////////////////////////////////////////////\r
\r
\r
/**\r
\r
@page page_translations Translations\r
\r
wxWidgets uses a certain number of user-readable strings such as\r
<tt>"help"</tt> or <tt>"Load file"</tt> which should be translated to the\r
users language if it is different from English. wxWidgets has built in support\r
for internationalization (@e i18n from now on) which allows for this to happen\r
automatically if the translations to the current language are available.\r
\r
You may find here the list of all existing translations with the addresses of\r
the official translators whom you should contact if you would like to submit\r
any corrections to the translations for your language. \r
\r
Also, please see @ref page_translations_howtohelp if you would like to translate \r
wxWidgets to your language if it is not mentioned here (or to help with one which \r
already is - it is quite helpful to have several translators for one language at\r
least for proof reading).\r
\r
@li @ref page_translations_avail\r
@li @ref page_translations_howtohelp\r
\r
<hr> \r
\r
\r
@section page_translations_avail Available translations\r
\r
Below is the table containing the list of languages supported by wxWidgets.\r
The columns of this table have the obvious meaning: in each row you will see\r
the language, the official translator (if any) for it and the status of the\r
translations.\r
\r
Please note that email addresses in the table below are intentionally invalid\r
to foil spam robots, remove one <tt>\@</tt> from them.\r
\r
<table>\r
<tr>\r
    <td colspan="3">Languages supported by wxWidgets</td>\r
</tr>\r
\r
<tr>\r
    <td>Language</td>\r
    <td>Status</td>\r
    <td>Translator(s)</td>\r
</tr>\r
\r
<tr>\r
    <td>Afrikaans</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:rkwjpj@@puk.ac.za">Petri Jooste</a></td>\r
</tr>\r
\r
<tr>\r
    <td>Catalan</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:paubcrespo@@hotmail.com">Pau Bosch i Crespo</a></td>\r
</tr>\r
\r
<tr>\r
    <td>Chinese (simplified)</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:mrfx@@fm365.com">mrfx</a></td>\r
</tr>\r
\r
<tr>\r
    <td>Chinese (traditional)</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:pal.tw@@yahoo.com.tw">pal.tw</a></td>\r
</tr>\r
\r
<tr>\r
    <td>Czech</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:v.slavik@@volny.cz">Vaclav Slavik</a></td>\r
</tr>\r
\r
<tr>\r
    <td>Danish</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:leif@@danmos.dk">Leif Jensen</a>,\r
        <a href="mailto:Henrik@@fangorn.dk">Henrik Ræder Clausen</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Dutch</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:phubers@@solve-i-t.com">Patrick Hubers</a></td>\r
</tr>\r
\r
<tr>\r
    <td>English (UK)</td>\r
    <td>@image html yes.gif</td>\r
    <td>Not required</td>\r
</tr>\r
\r
<tr>\r
    <td>Finnish</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:kgb@@compart.fi">Kaj G Backas</a></td>\r
</tr>\r
\r
<tr>\r
    <td>French (standard)</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:Stephane.Junique@@optics.kth.se">Stephane Junique</a>,\r
        <a href="mailto:lionel.allorge@@lunerouge.com">Lionel Allorge</a>,\r
        <a href="mailto:Gilles.Guyot@@Krypton.be">Gilles Guyot</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>German</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:DanR@@gmx.de">Daniel Reith</a>,\r
        <a href="mailto:sparhawk@@aon.at">Gerhard Gruber</a>,\r
        <a href="mailto:stefan@@hedemann.de">Stefan Hedemann</a>,\r
        <a href="mailto:D.Reymann@@geisenheim.mnd.fh-wiesbaden.de">Dr. Detlev Reymann</a>,\r
        <a href="mailto:NA">Mark Johnson</a>,\r
        <a href="mailto:martinnost@@users.sf.net">Martin Jost</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Greek</td>\r
    <td>@image html no.gif</td>\r
    <td>\r
        <a href="mailto:tsolako1@@otenet.gr">Tsolakos Stavros</a>,\r
        <a href="mailto:nassosy@@compulink.gr">Nassos Yiannopoulos</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Hungarian</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:Janos_Vegh@@users.sourceforge.net">Végh János Dr.</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Indonesian</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:bambang@@3wsi.com">Bambang Purnomosidi D. P.</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Italian</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:m.cavallini@@koansoftware.com">Marco Cavallini</a>\r
        (<a href="http://www.koansoftware.com">Koan Software</a>)\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Japanese</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:james.bishop1@@tiscali.co.uk">James Bishop</a>,\r
        <a href="mailto:saito@@inetrt.skcapi.co.jp">Hiroshi Saito</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Latvian</td>\r
    <td>@image html somewhat.gif</td>\r
    <td>\r
        <a href="mailto:lauris@@nix.lv">Lauris Buk&#353;is</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Polish</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:matiso@@hoga.pl">Piotr Mackowiak</a>,\r
        <a href="mailto:jpiw@@go2.pl">Janusz Piwowarski</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Portuguese</td>\r
    <td>@image html no.gif</td>\r
    <td><a href="mailto:bernardosw@@terra.com.br">Bernardo Santos Wernesback</a></td>\r
</tr>\r
\r
<tr>\r
    <td>Russian</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:rolinsky@@mema.ucl.ac.be">Roman Rolinsky</a>,\r
        <a href="mailto:vadim@@wxwidgets.org">Vadim Zeitlin</a>\r
        <a href="mailto:kai@@cmail.ru">Andrew V. Samoilov</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Serbian</td>\r
    <td>@image html no.gif</td>\r
    <td><a href="mailto:zlatkor@@eunet.yu">Zlatko Rosandic</a></td>\r
</tr>\r
\r
<tr>\r
    <td>Spanish</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:guille@@iies.es">Guillermo Rodriguez Garcia</a>,\r
        <a href="mailto:jsj666@@hotmail.com">JSJ</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Swedish</td>\r
    <td>@image html yes.gif</td>\r
    <td>\r
        <a href="mailto:jor@@mindless.com">Jonas Rydberg</a>,\r
        <a href="mailto:kgb@@compart.fi">Kaj G Backas</a>\r
    </td>\r
</tr>\r
\r
<tr>\r
    <td>Turkish</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:dogusanh@@dynaset.org">Hakki Dogusan</a></td>\r
</tr>\r
\r
<tr>\r
    <td>Ukrainian</td>\r
    <td>@image html yes.gif</td>\r
    <td><a href="mailto:manko@@salingshot.co.nz">Eugene Manko</a></td>\r
</tr>\r
</table>\r
<br><br>\r
\r
\r
@section page_translations_howtohelp How to help\r
\r
wxWidgets uses the standard GNU gettext tools for i18n so if you are already\r
familiar with them you shouldn't have any problems with working on wxWidgets\r
translations. \r
\r
Here are the the steps you should follow:\r
\r
-# Get the latest version of the file <tt>locale/wxstd.pot</tt> from the\r
   wxWidgets source tree: if you're using \r
   <a href="http://www.wxwidgets.org/develop/svn.htm">Subversion</a>\r
   or the <a href="http://wxwindows.sourceforge.net/snapshots/">daily snapshots</a>\r
   you should already have it. \r
   Otherwise you can always retrieve it directly from the cvs repository via the \r
   <a href="http://svn.wxwidgets.org/viewvc/wx/wxWidgets/trunk/locale/wxstd.pot?view=co">Web interface</a>.\r
-# Rename it to <tt>XY.po</tt> where <tt>"XY"</tt> is the 2 letter \r
   <a href="http://lcweb.loc.gov/standards/iso639-2/englangn.html">ISO 639-1 language code</a>\r
   for your language.\r
-# Translate the strings in this file using either your favourite text\r
   editor or a specialized tool such as Vaclav Slavik's excellent\r
   <a href="http://poedit.sourceforge.net/" target=_top>poEdit</a> utility.\r
-# Verify that your translations can at least be compiled (even if they\r
   are yet incomplete) by running <tt>msgfmt -v XY.po</tt> command:\r
   please note that you <i>must</i> use the <tt>-v</tt> option. In\r
   particular, please fill the header fields because msgfmt doesn't\r
   accept the default values for them.\r
-# Send the finished translation to <a href="mailto:vadim@wxwidgets.org">Vadim Zeitlin</a> \r
   and it will be added to the next wxWidgets release or snapshot.\r
\r
In addition, please consider subscribing to the very low volume\r
<a href="http://lists.wxwidgets.org/mailman/listinfo/wx-translators">\r
wxWidgets translators</a> mailing list on which the news especially important\r
for the translators are announced.\r
\r
Thank you in advance for your help!\r
\r
*/\r