Commit 56ba9f95 authored by Albert's avatar Albert
Browse files

Adjust internationalization part to current situation

parent 50a0860a

doc/language.doc

+29 −11
Original line number Original line Diff line number Diff line
@@ -31,7 +31,7 @@ Chinese Traditional, Croatian, Czech, Danish, Dutch, English, 
Esperanto, Finnish, French, German, Greek, Hungarian, Indonesian,

Esperanto, Finnish, French, German, Greek, Hungarian, Indonesian,

Italian, Japanese (+En), Korean (+En), Latvian, Lithuanian,

Italian, Japanese (+En), Korean (+En), Latvian, Lithuanian,

Macedonian, Norwegian, Persian, Polish, Portuguese, Romanian, Russian,

Macedonian, Norwegian, Persian, Polish, Portuguese, Romanian, Russian,

Serbian, SerbianCyrilic, Slovak, Slovene, Spanish, Swedish, Turkish,

Serbian, SerbianCyrillic, Slovak, Slovene, Spanish, Swedish, Turkish,

Ukrainian, and Vietnamese..

Ukrainian, and Vietnamese..





The table of information related to the supported languages follows.

The table of information related to the supported languages follows.
@@ -258,7 +258,7 @@ when the translator was updated. 
    <td bgcolor="#ffcccc">1.6.0</td>

    <td bgcolor="#ffcccc">1.6.0</td>

  </tr>

  </tr>

  <tr bgcolor="#ffffff">

  <tr bgcolor="#ffffff">

    <td bgcolor="#ffffff">SerbianCyrilic</td>

    <td bgcolor="#ffffff">SerbianCyrillic</td>

    <td>Nedeljko Stefanovic</td>

    <td>Nedeljko Stefanovic</td>

    <td>stenedjo at yahoo dot com</td>

    <td>stenedjo at yahoo dot com</td>

    <td bgcolor="#ffcccc">1.6.0</td>

    <td bgcolor="#ffcccc">1.6.0</td>
@@ -414,7 +414,7 @@ when the translator was updated. 
  \hline

  \hline

  Serbian & Dejan Milosavljevic & {\tt\tiny [unreachable] dmilos at email dot com} & 1.6.0 \\

  Serbian & Dejan Milosavljevic & {\tt\tiny [unreachable] dmilos at email dot com} & 1.6.0 \\

  \hline

  \hline

  SerbianCyrilic & Nedeljko Stefanovic & {\tt\tiny stenedjo at yahoo dot com} & 1.6.0 \\

  SerbianCyrillic & Nedeljko Stefanovic & {\tt\tiny stenedjo at yahoo dot com} & 1.6.0 \\

  \hline

  \hline

  Slovak & Kali+Laco Švec & {\tt\tiny [the Slovak language advisors]} & up-to-date \\

  Slovak & Kali+Laco Švec & {\tt\tiny [the Slovak language advisors]} & up-to-date \\

  ~ & Petr Přikryl & {\tt\tiny prikryl at atlas dot cz} & ~ \\

  ~ & Petr Přikryl & {\tt\tiny prikryl at atlas dot cz} & ~ \\
@@ -457,10 +457,8 @@ Just follow the following steps: 
    is already working on support for that language, you will be

    is already working on support for that language, you will be

    assigned as the maintainer for the language.

    assigned as the maintainer for the language.

<li>Create a copy of `doxygen/src/translator_en.h` and name it

<li>Create a copy of `doxygen/src/translator_en.h` and name it

    `doxygen/src/translator_\<your_2_letter_country_code\>.h`

    `doxygen/src/translator_<your_2_letter_country_code>.h`

    I'll use `xx` in the rest of this document (add `XX` for the uppercase version).

    I'll use `xx` in the rest of this document (and `XX` for the uppercase version).

<li> Rerun the `configure` script such that it generates `doxygen/src/lang_cfg.h`.

This file should now contain a  \c \#define for your language code.

<li>Edit `doxygen/src/language.cpp`:

<li>Edit `doxygen/src/language.cpp`:

    Add the following code:

    Add the following code:

\verbatim

\verbatim
@@ -503,12 +501,32 @@ This file should now contain a \c \#define for your language code. 
           the text is expected to be saved using the UTF-8 encoding. Doxygen

           the text is expected to be saved using the UTF-8 encoding. Doxygen

           will translate the characters to proper \f$\mbox{\LaTeX}\f$ and

           will translate the characters to proper \f$\mbox{\LaTeX}\f$ and

           leaves the HTML and man output in UTF-8.

           leaves the HTML and man output in UTF-8.

     <li>  Use HTML codes like `\&auml;` for an \c a with an \c umlaut (i.e. &auml;).

     <li>  Use HTML codes like \c \&auml; for an \c a with an \c umlaut (i.e. \c &auml;).

           See the HTML specification for the codes.

           See the HTML specification for the codes.

     </ul>

     </ul>

   </ul>

   </ul>

<li>Run \c configure and \c make again from the root (i.e. in the \c doxygen

<li>

    <ul>

      <li>On *nix systems:<br>

    <ul>

        <li>Rerun the `configure` script from the root (i.e. in the \c doxygen  directory) so

        that it generates `doxygen/src/lang_cfg.h`.

        This file should now contain a  \c \#define for your language code.<br>

        <li>Run \c make again from the root (i.e. in the \c doxygen

        directory) of the distribution, in order to regenerate the `Makefile`s.

        directory) of the distribution, in order to regenerate the `Makefile`s.

    </ul>

      <li> On Windows:<br>

    <ul>

       <li>stop Visual Stdio<br>

       <li>open a command window<br>

       <li>goto the directory `doxygen\src`<br>

       <li>give the command `python languages.py > ..\winbuild\Languages.rules`<br>

       <li>close the command window<br>

       <li>start Visual Studio again<br>

       <li>Your language should now be selectable in the `General` part of the `Settings` of the `Properties`

       window of `lang_cfg.py`, by default Your language will be `on`. Rebuild `doxygen` (and `doxywizard`) now.

    </ul>

    </ul>

<li>Now you can use <code>OUTPUT_LANGUAGE = your_language_name</code>

<li>Now you can use <code>OUTPUT_LANGUAGE = your_language_name</code>

    in the config file to generate output in your language.

    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.

<li>Send <code>translator_xx.h</code> to me so I can add it to doxygen.

doc/language.tpl

+26 −8
Original line number Original line Diff line number Diff line
@@ -56,10 +56,8 @@ Just follow the following steps: 
    is already working on support for that language, you will be

    is already working on support for that language, you will be

    assigned as the maintainer for the language.

    assigned as the maintainer for the language.

<li>Create a copy of `doxygen/src/translator_en.h` and name it

<li>Create a copy of `doxygen/src/translator_en.h` and name it

    `doxygen/src/translator_\<your_2_letter_country_code\>.h`

    `doxygen/src/translator_<your_2_letter_country_code>.h`

    I'll use `xx` in the rest of this document (add `XX` for the uppercase version).

    I'll use `xx` in the rest of this document (and `XX` for the uppercase version).

<li> Rerun the `configure` script such that it generates `doxygen/src/lang_cfg.h`.

This file should now contain a  \c \#define for your language code.

<li>Edit `doxygen/src/language.cpp`:

<li>Edit `doxygen/src/language.cpp`:

    Add the following code:

    Add the following code:

\verbatim

\verbatim
@@ -102,12 +100,32 @@ This file should now contain a \c \#define for your language code. 
           the text is expected to be saved using the UTF-8 encoding. Doxygen

           the text is expected to be saved using the UTF-8 encoding. Doxygen

           will translate the characters to proper \f$\mbox{\LaTeX}\f$ and

           will translate the characters to proper \f$\mbox{\LaTeX}\f$ and

           leaves the HTML and man output in UTF-8.

           leaves the HTML and man output in UTF-8.

     <li>  Use HTML codes like `\&auml;` for an \c a with an \c umlaut (i.e. &auml;).

     <li>  Use HTML codes like \c \&auml; for an \c a with an \c umlaut (i.e. \c &auml;).

           See the HTML specification for the codes.

           See the HTML specification for the codes.

     </ul>

     </ul>

   </ul>

   </ul>

<li>Run \c configure and \c make again from the root (i.e. in the \c doxygen

<li>

    <ul>

      <li>On *nix systems:<br>

    <ul>

        <li>Rerun the `configure` script from the root (i.e. in the \c doxygen  directory) so

        that it generates `doxygen/src/lang_cfg.h`.

        This file should now contain a  \c \#define for your language code.<br>

        <li>Run \c make again from the root (i.e. in the \c doxygen

        directory) of the distribution, in order to regenerate the `Makefile`s.

        directory) of the distribution, in order to regenerate the `Makefile`s.

    </ul>

      <li> On Windows:<br>

    <ul>

       <li>stop Visual Stdio<br>

       <li>open a command window<br>

       <li>goto the directory `doxygen\src`<br>

       <li>give the command `python languages.py > ..\winbuild\Languages.rules`<br>

       <li>close the command window<br>

       <li>start Visual Studio again<br>

       <li>Your language should now be selectable in the `General` part of the `Settings` of the `Properties`

       window of `lang_cfg.py`, by default Your language will be `on`. Rebuild `doxygen` (and `doxywizard`) now.

    </ul>

    </ul>

<li>Now you can use <code>OUTPUT_LANGUAGE = your_language_name</code>

<li>Now you can use <code>OUTPUT_LANGUAGE = your_language_name</code>

    in the config file to generate output in your language.

    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.

<li>Send <code>translator_xx.h</code> to me so I can add it to doxygen.