path: root/doc/language.doc

/******************************************************************************
 * Warning: this file was generated from the language.tpl template
 *          and the maintainers.txt files by the translator.pl script.  
 *
 *          Do not edit this file.  Edit the above mentioned files!
 * 
 *
 * Copyright (C) 1997-2001 by Dimitri van Heesch.
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation under the terms of the GNU General Public License is hereby 
 * granted. No representations are made about the suitability of this software 
 * for any purpose. It is provided "as is" without express or implied warranty.
 * See the GNU General Public License for more details.
 *
 * Documents produced by Doxygen are derivative works derived from the
 * input used in their production; they are not affected by this license.
 *
 */
/*! \page langhowto Internationalization

<h3>Support for multiple languages</h3>

Doxygen has support for multiple languages. This means 
that the text fragments that doxygen generates can changed into languages 
other than English (the default) at configuration time.
<p>
Currently (version unknown), 23 languages 
are supported (sorted alphabetically): 
Brazilian Portuguese, Chinese, Croatian, Czech, Danish, 
Dutch, English, Finnish, French, German, 
Hungarian, Italian, Japanese, Korean, Norwegian, 
Polish, Portuguese, Romanian, Russian, Slovak, 
Slovene, Spanish, and Swedish.

The table of information related to the supported languages follows.
It is sorted by language alphabetically.  The <B>Status</B> column
was generated from sources and shows approximately the last version
when the translator was updated.
<p>

\htmlonly
<TABLE ALIGN=center CELLSPACING=0 CELLPADDING=0 BORDER=0>
<TR BGCOLOR="#000000">
<TD>
  <TABLE CELLSPACING=1 CELLPADDING=2 BORDER=0>
  <TR BGCOLOR="#4040c0">
  <TD ><b><font size=+1 color="#ffffff"> Language </font></b></TD>
  <TD ><b><font size=+1 color="#ffffff"> Maintainer </font></b></TD>
  <TD ><b><font size=+1 color="#ffffff"> Contact address </font>
          <font size=-2 color="#ffffff">(remove the NOSPAM.)</font></b></TD>
  <TD ><b><font size=+1 color="#ffffff"> Status </font></b></TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Brazilian</TD>  
      <TD>Fabio "FJTC" Jun Takada Chino</TD>
      <TD>chino@NOSPAM.grad.icmc.sc.usp.br</TD>
      <TD>up-to-date</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Chinese</TD>  
      <TD>Wang Weihan</TD>
      <TD>wangweihan@NOSPAM.capinfo.com.cn</TD>
      <TD>1.2.1</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Croatian</TD>  
      <TD>Boris Bralo</TD>
      <TD>boris.bralo@NOSPAM.zg.tel.hr</TD>
      <TD>up-to-date</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Czech</TD>  
      <TD>Petr P&#x0159;ikryl<br>Vlastimil Havran</TD>
      <TD>prikrylp@NOSPAM.skil.cz<br>havran@NOSPAM.fel.cvut.cz</TD>
      <TD>up-to-date</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Danish</TD>  
      <TD>Erik S&oslash;e S&oslash;rensen</TD>
      <TD>erik@NOSPAM.mail.nu</TD>
      <TD>1.2.7</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Dutch</TD>  
      <TD>Dimitri van Heesch</TD>
      <TD>dimitri@NOSPAM.stack.nl</TD>
      <TD>up-to-date</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>English</TD>  
      <TD>Dimitri van Heesch</TD>
      <TD>dimitri@NOSPAM.stack.nl</TD>
      <TD>up-to-date</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Finnish</TD>  
      <TD>Olli Korhonen</TD>
      <TD>Olli.Korhonen@NOSPAM.ccc.fi</TD>
      <TD>1.0.0</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>French</TD>  
      <TD>Xavier Outhier</TD>
      <TD>xavier.outhier@NOSPAM.anfdata.cz</TD>
      <TD>1.2.0</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>German</TD>  
      <TD>Jens Seidel<br>Jens Breitenstein</TD>
      <TD>jensseidel@NOSPAM.users.sourceforge.net<br>Jens.Breitenstein@NOSPAM.tlc.de</TD>
      <TD>up-to-date</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Hungarian</TD>  
      <TD>F&ouml;ldv&aacute;ri Gy&ouml;rgy</TD>
      <TD>foldvari@NOSPAM.diatronltd.com</TD>
      <TD>1.2.1</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Italian</TD>  
      <TD>Ahmed Aldo Faisal<br>Alessandro Falappa</TD>
      <TD>aaf23@NOSPAM.cam.ac.uk<br>a.falappa@NOSPAM.flashnet.it</TD>
      <TD>1.2.7</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Japanese</TD>  
      <TD>Kenji Nagamatsu</TD>
      <TD>naga@NOSPAM.joyful.club.ne.jp</TD>
      <TD>1.2.5</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Korean</TD>  
      <TD>Richard Kim</TD>
      <TD>ryk@NOSPAM.dspwiz.com</TD>
      <TD>1.1.0</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Norwegian</TD>  
      <TD>Lars Erik Jordet</TD>
      <TD>larsej@NOSPAM.stud.ifd.hibu.no</TD>
      <TD>1.2.2</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Polish</TD>  
      <TD>Grzegorz Kowal</TD>
      <TD>g_kowal@NOSPAM.poczta.onet.pl</TD>
      <TD>1.2.1</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Portuguese</TD>  
      <TD>Rui Godinho Lopes</TD>
      <TD>ruiglopes@NOSPAM.yahoo.com</TD>
      <TD>1.1.5</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Romanian</TD>  
      <TD>Alexandru Iosup</TD>
      <TD>aiosup@NOSPAM.yahoo.com</TD>
      <TD>1.2.1</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Russian</TD>  
      <TD>Alexandr Chelpanov</TD>
      <TD>cav@NOSPAM.cryptopro.ru</TD>
      <TD>up-to-date</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Slovak</TD>  
      <TD>Stanislav Kudlac</TD>
      <TD>qwerty1@NOSPAM.pobox.sk</TD>
      <TD>1.2.7</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Slovene</TD>  
      <TD>Matjaz Ostroversnik</TD>
      <TD>matjaz.ostroversnik@NOSPAM.zrs-tk.si</TD>
      <TD>1.1.5</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Spanish</TD>  
      <TD>Francisco Oltra Thennet</TD>
      <TD>foltra@NOSPAM.puc.cl</TD>
      <TD>1.2.7</TD>
  </TR>
  <TR BGCOLOR="#ffffff">
      <TD>Swedish</TD>  
      <TD>Samuel H&auml;agglund<br>XeT Erixon</TD>
      <TD>sahag96@NOSPAM.nts.mh.se<br>xet@NOSPAM.hem.passagen.se</TD>
      <TD>1.0.0</TD>
  </TR>
  </TABLE>
</TD>
</TR>
</TABLE>
\endhtmlonly
\latexonly
\begin{tabular}{|l|l|l|l|}
  \hline 
  {\bf Language} & {\bf Maintainer} & {\bf Contact address} & {\bf Status} \\
  \hline
  \hline
  Brazilian & Fabio "FJTC" Jun Takada Chino & {\tt chino@grad.icmc.sc.usp.br} & up-to-date \\
  \hline
  Chinese & Wang Weihan & {\tt wangweihan@capinfo.com.cn} & 1.2.1 \\
  \hline
  Croatian & Boris Bralo & {\tt boris.bralo@zg.tel.hr} & up-to-date \\
  \hline
  Czech & Petr P\v{r}ikryl & {\tt prikrylp@skil.cz} & up-to-date \\
   & Vlastimil Havran & {\tt havran@fel.cvut.cz} &  \\
  \hline
  Danish & Erik S\o{}e S\o{}rensen & {\tt erik@mail.nu} & 1.2.7 \\
  \hline
  Dutch & Dimitri van Heesch & {\tt dimitri@stack.nl} & up-to-date \\
  \hline
  English & Dimitri van Heesch & {\tt dimitri@stack.nl} & up-to-date \\
  \hline
  Finnish & Olli Korhonen & {\tt Olli.Korhonen@ccc.fi} & 1.0.0 \\
  \hline
  French & Xavier Outhier & {\tt xavier.outhier@anfdata.cz} & 1.2.0 \\
  \hline
  German & Jens Seidel & {\tt jensseidel@users.sourceforge.net} & up-to-date \\
   & Jens Breitenstein & {\tt Jens.Breitenstein@tlc.de} &  \\
  \hline
  Hungarian & F\"{o}ldv\'{a}ri Gy\"{o}rgy & {\tt foldvari@diatronltd.com} & 1.2.1 \\
  \hline
  Italian & Ahmed Aldo Faisal & {\tt aaf23@cam.ac.uk} & 1.2.7 \\
   & Alessandro Falappa & {\tt a.falappa@flashnet.it} &  \\
  \hline
  Japanese & Kenji Nagamatsu & {\tt naga@joyful.club.ne.jp} & 1.2.5 \\
  \hline
  Korean & Richard Kim & {\tt ryk@dspwiz.com} & 1.1.0 \\
  \hline
  Norwegian & Lars Erik Jordet & {\tt larsej@stud.ifd.hibu.no} & 1.2.2 \\
  \hline
  Polish & Grzegorz Kowal & {\tt g\_kowal@poczta.onet.pl} & 1.2.1 \\
  \hline
  Portuguese & Rui Godinho Lopes & {\tt ruiglopes@yahoo.com} & 1.1.5 \\
  \hline
  Romanian & Alexandru Iosup & {\tt aiosup@yahoo.com} & 1.2.1 \\
  \hline
  Russian & Alexandr Chelpanov & {\tt cav@cryptopro.ru} & up-to-date \\
  \hline
  Slovak & Stanislav Kudlac & {\tt qwerty1@pobox.sk} & 1.2.7 \\
  \hline
  Slovene & Matjaz Ostroversnik & {\tt matjaz.ostroversnik@zrs-tk.si} & 1.1.5 \\
  \hline
  Spanish & Francisco Oltra Thennet & {\tt foltra@puc.cl} & 1.2.7 \\
  \hline
  Swedish & Samuel H\"{a}agglund & {\tt sahag96@nts.mh.se} & 1.0.0 \\
   & XeT Erixon & {\tt xet@hem.passagen.se} &  \\
  \hline
\end{tabular}
\endlatexonly

Have a look at <a href="../doc/translator_report.txt"
><code>doxygen/doc/translator_report.txt</code></a> for more details.
<p>

Most people on the list have indicated that they were also busy
doing other things, so if you want to help to speed things up please 
let them (or me) know.

If you want to add support for a language that is not yet listed 
please see the next section.

<h3>Adding a new language to doxygen</h3>

This short HOWTO explains how to add support for a new language to Doxygen:

Just follow these steps:
<ol>
<li>Tell me for which language you want to add support. If no one else
    is already working on support for that language, you will be 
    assigned as the maintainer for the language. 
<li>Create a copy of translator_en.h and name it 
    translator_<your_2_letter_counter_code>.h
    I'll use xx in the rest of this document.
<li>Edit language.cpp:
    Add a 
\verbatim
#include<translator_xx.h>
\endverbatim
    in <code>setTranslator()</code> add
\verbatim
    else if (L_EQUAL("your_language_name"))
    {
      theTranslator = new TranslatorYourLanguage;
    }
\endverbatim
    after the <code>if { ... }</code>
<li>Edit libdoxygen.pro.in and add \c translator_xx.h to 
    the \c HEADERS line in the file doxygen.pro.
<li>Edit <code>translator_xx.h</code>:
   <ul>
   <li>Rename <code>TRANSLATOR_EN_H</code> to <code>TRANSLATOR_XX_H</code> twice.
   <li>Rename TranslatorEnglish to TranslatorYourLanguage 
   <li>In the member <code>idLanguage()</code> change "english" into the 
     name of the your language (use lower case characters only). Depending
     on the language you may also wish to change the member functions 
     latexLanguageSupportCommand() and idLanguageCharset().
   <li>Edit all the strings that are returned by the member functions that 
     start with tr. 
     Try to match punctuation and capitals!
     To enter special characters (with accents) you can:
     <ul>
     <li>  Enter them directly if your keyboard supports that and you are 
           using a Latin-1 font.
           Doxygen will translate the characters to proper Latex and
           leave the Html and man output for what it is (which is fine, if
           idLanguageCharset() is set correctly).
     <li>  Use html codes like \&auml; for an a with an umlaut (i.e. &auml;).
           See the HTML specification for the codes.
     </ul>
   </ul>
<li>Run configure and make again from the root of the distribution, 
    in order to regenerated the Makefiles.
<li>Now you can use <code>OUTPUT_LANGUAGE = your_language_name</code> 
    in the config file to generate output in your language.
<li>Send <code>translator_xx.h</code> to me so I can add it to doxygen.
</ol>

<h3>Maintaining a language</h3>

As new versions of doxygen appear, new sentences will be
added to the Translator interface class. Of course these need to be translated
as well (otherwise doxygen wouldn't even compile!). 

Waiting until all language maintainers have translated these new sentences
and sent the results would not be very practical for me.

Instead, a new class TranslatorAdapter_x_y_z will be added to 
translator_adapter.h (here x,y, and z correspond to the current
version of doxygen). And all translators that previous derived from 
Translator will now derive from this adapter class.

The Adapter class contains the new sentences with
default translations using the English translator (which is always up to date). 
Instead of deriving your TranslatorXX class directly from Translator it will 
derive from the intermediate class TranslatorAdapter_x_y_z. 

Thus, if a translator class inherits from a adapter class 
maintenance is needed. By looking at the adapter class itself (and its base
classes) you can easily see which methods need to be updated.

To update a language simply make your translator class derive from
the abstract class Translator and provide translations for the methods that
were previously provided by the adapter class (and its base classes).

*/