locale/README

   1 Localizations for StatusNet are being maintained through TranslateWiki:
   2 http://translatewiki.net/wiki/Translating:StatusNet
   3
   4 Ongoing translation work should be done there to ensure updates are
   5 integrated into future versions of StatusNet.
   6
   7
   8 == Building runtime translations ==
   9
  10 If you are working with a direct git checkout or have customized any
  11 message files, you will need to build binary .mo files from the .po
  12 source files for translations to work in the web app.
  13
  14 If gettext and GNU make are installed, you can simply run 'make' in the
  15 main StatusNet directory, and all core and plugin localizations will be
  16 recompiled.
  17
  18
  19 == Customization ==
  20
  21 User interface texts in any language can be customized by editing the
  22 texts in the .po source files, then rebuilding the binary .mo files
  23 used at runtime.
  24
  25 The default/US English texts can be overridden by adding "translations"
  26 to en/LC_MESSAGES/statusnet.po.
  27
  28 Note that texts you change in one language will not affect other
  29 languages, which are selected based on visitors' browser preferences.
  30 If you customizations include important information or links,
  31 you may wish to disable languages that you haven't customized so that
  32 visitors always get your text.
  33
  34 To disable all non-English languages add this to your config.php (you
  35 will need to edit both the en and en_GB files):
  36
  37 $config['site']['languages'] = array(
  38         'en-us'   => array('q' => 1, 'lang' => 'en', 'name' => 'English (US)', 'direction' => 'ltr'),
  39         'en-gb'   => array('q' => 1, 'lang' => 'en_GB', 'name' => 'English (British)', 'direction' => 'ltr'),
  40         'en'      => array('q' => 1, 'lang' => 'en',    'name' => 'English (US)', 'direction' => 'ltr'),
  41 );
  42
  43
  44 To disable everything including British English variant:
  45
  46 $config['site']['languages'] = array(
  47         'en'      => array('q' => 1, 'lang' => 'en',    'name' => 'English', 'direction' => 'ltr'),
  48 );
  49
  50
  51 == Plugins ==
  52
  53 This locale directory contains translations for the core StatusNet
  54 software only. Plugins may have their own locale subdirectories and
  55 their own .po and .mo files as well, so if customizing you may need
  56 to poke at those as well.