WikiStart back

Steps to Translate OSGeo4W-setup.exe into another Language

• checkout local copy of setup files from Subversion, for example:

    svn co https://svn.osgeo.org/osgeo4w/trunk/setup/ setup --username yourname
  

• copy res_en.rc and rename the file for your new language in the form res_[lang].rc, such as:

    res_ja.rc
  

• open your new res_[lang].rc file in a text editor and edit:
  • modify line#1 and #2 for your new language
    • use appropriate code identifier for your international characters (​microsoft documentation)
    • note that it is safer to use UTF-8 encoding for multilanguage support, so you can always use:

         #pragma code_page(65001)
      

      and also make sure that your text editor saves the file as UTF-8 encoded
  • replace English installer text in all CONTROL, CAPTION, LTEXT, RTEXT objects, such as:

      CAPTION "OSGeo4W Setup - Choose Installation Type"
    
      translated to:
    
      CAPTION "OSGeo4Wセットアップ－インストールタイプの選択"
    

    • be careful of making sure that the interface accelerators are kept, such as "(&D)":

         CONTROL "&Download Without Installing",
      
         translated to:
      
         CONTROL "インストールせずにダウンロード(&D)",
      

      • (background on menu resource accelerators: ​microsoft documentation)
  • you might have to modify the size/spacing of your new strings in the objects, if you notice that your new text is cutoff in the installer. For example, the values below for "60,85,88,10" mean: x,y,width,height - you might have to change the width value for longer translated strings

      CONTROL "Use HTTP/FTP &Proxy:",IDC_NET_PROXY,"Button",
               BS_AUTORADIOBUTTON | WS_TABSTOP,60,85,88,10
    
      translated to:
    
      CONTROL "HTTP/FTPプロキシを利用する(&P):",IDC_NET_PROXY,"Button",
               BS_AUTORADIOBUTTON | WS_TABSTOP,60,85,188,10
    

• open res.rc in a text editor
  • include your new res_[lang].rc file at the bottom of the file res.rc such as:

      #include "res_en.rc"
      ...
      #include "res_ja.rc"
    

• compile your new setup.exe, by following the steps in SetupDevelopment
• test your new translated setup.exe
• commit your changes to Subversion
• inform the mailing list of your new translation
  • you might need assistance to publish the live osgeo4w-setup.exe to the download server (inform mailing list)

Current Issues

• some installer text is hardcoded (see ticket:130)
• packages' setup.hint text is also only in English (see ticket:131)

Documentation Translation

• create a new wiki page for your language at the top of WikiStart
  • name the page "OSGeo4W_[lang]"
  • use a country flag from the MapServer site, and follow the steps outlined in ticket:132