documentation/i18n.sgml

   1   <chapter id="i18n">
   2     <title>Internationalization</title>
   3
   4     <sect1 id="adding-languages">
   5       <title>Adding New Languages</title>
   6
   7       <para>
   8         This file documents the necessary procedure for adding a new
   9         language to the list of languages that Wine can display system
  10         menus and forms in. Adding new translations is not hard as
  11         it requires no programming knowledge or special skills.
  12       </para>
  13
  14       <para>
  15         Language dependent resources reside in files
  16         named <filename>somefile_Xx.rc</filename> or
  17         <filename>Xx.rc</filename>, where <literal>Xx</literal>
  18         is your language  abbreviation (look for it in
  19         <filename>include/winnls.h</filename>). These are included
  20         in a master file named <filename>somefile.rc</filename> or
  21         <filename>rsrc.rc</filename>, located in the same
  22         directory as the language files.
  23       </para>
  24
  25       <para>
  26         To add a new language to one of these resources you
  27         need to make a copy of the English resource (located
  28         in the <filename>somefile_En.rc</filename> file) over to
  29         your <filename>somefile_Xx.rc</filename> file, include this
  30         file in the master <filename>somefile.rc</filename> file,
  31         and edit the new file to translate the English text.
  32         You may also need to rearrange some of the controls
  33         to better fit the newly translated strings. Test your changes
  34         to make sure they properly layout on the screen.
  35       </para>
  36
  37       <para>
  38         In menus, the character "&amp;" means that the next
  39         character will be highlighted and that pressing that
  40         letter will select the item. You should place these
  41         "&amp;" characters suitably for your language, not just
  42         copy the positions from English.  In particular,
  43         items within one menu should have different highlighted
  44         letters.
  45       </para>
  46
  47       <para>
  48          To get a list of the files that need translating,
  49          run the following command in the root of your Wine tree:
  50          <command>find -name "*En.rc"</command>.
  51       </para>
  52
  53       <para>
  54          When adding a new language, also make sure the parameters
  55          defined in  <filename>./dlls/kernel/nls/*.nls</filename>
  56          fit your local habits and language.
  57       </para>
  58     </sect1>
  59   </chapter>
  60
  61 <!-- Keep this comment at the end of the file
  62 Local variables:
  63 mode: sgml
  64 sgml-parent-document:("wine-devel.sgml" "set" "book" "part" "chapter" "")
  65 End:
  66 -->