Fish Fillets - Next Generation

Localization

This document describes how to add new language to Fish Fillets NG. To run game with specific language set system locale or use parameter lang (man 6 fillets) or select language in game menu.

Follow these steps and send your translated files to fillets-devel or ask for CVS access.

1. Use unicode encoding

   Use UTF-8 for all text you translate.

2. Add new language to game menu

   Select 2-letter language code from ISO 639 Language Codes to identify your language. Your country flag icon can be obtained from Sodipodi clipart page. Icon should be scaled to 30x20 and saved as PNG image.
   Change 2-letter_code and flag in script/select_lang.lua

       -- select_addFlag(2-letter_code, flag)
       select_addFlag("en", "images/menu/flags/en.png")
           

3. Translate world map

   Translate level names in script/worlddesc.lua
   Change lang, translate level_name and branch.

       -- worldmap_addDesc(codename, lang, level_name, branch)
       worldmap_addDesc("start", "en", "How It All Started", "Fish House")
           

4. Translate menu labels

   Translate labels in script/labels.lua
   Change lang, translate text.

       -- label_text(label_id, lang, text)
       label_text("menu_sound", "en", "Sound volume")
           

5. Translate level dialogs

   Translate level dialogs in script/*/dialogs_"$lang".lua
   Add dialogStr() with translated text.

       -- dialogId(dialog_id, actor_font, default_text)
       -- dialogStr(translated_text)
       dialogId("kos-m-uklid2", "font_small", "I knew we’d have to clean this room up.")
       dialogStr("Ich wusste, dass wir hier aufräumen müssen.")
           

6. Translate other dialogs

   Translate other dialogs which are used during the game.
   Change lang, translate text.

   • briefcase demo
     script/briefcase/brief_dialogs_"$lang".lua

   • jokes about death
     script/share/black_dialogs_"$lang".lua

   • jokes about boredom
     script/share/bore_dialogs_"$lang".lua

   • info in final levels
     script/share/border_dialogs_"$lang".lua

   • final level posters
     script/*/demo_dialogs_"$lang".lua

   • intro poster
     script/share/intro_dialogs_"$lang".lua

7. Translate How to Play manual

   Translate game manual in doc/html/manual.html