doc/translations.txt

   1 Create translations for VLC media player
   2 ==============
   3 The translation files are located in the "po" directory of the vlc sources.
   4 Edit the appropriate file (for instance fr.po for French translation).
   5 Write the translation of "msgid" strings into the "msgstr" field.
   6 You can always ask vlc-devel@videolan.org for assistance.
   7
   8
   9 Writing a new localization
  10 ==========================
  11 If there is no localization file for your language, send a mail to
  12 vlc-devel@videolan.org. In return we will send you a localization file,
  13 along with a special VLC binary for your tests.
  14
  15
  16 Testing your localization on UNIX
  17 =================================
  18 You must install the gettext package. See your UNIX distribution, or
  19   http://www.gnu.org/software/gettext
  20 Use the convert-po.sh script attached :
  21   ./convert-po.sh <LANG>.po
  22 Copy the resulting vlc.mo file to
  23   /usr/local/share/locale/<LANG>/LC_MESSAGES
  24
  25 Launch VLC with --language <LANG>
  26 Where <LANG> is the international shortcode for your language.
  27
  28
  29 Testing your localization on Mac OS X
  30 =====================================
  31 If you do not have GNU gettext installed (you'd probably know if you had
  32 it :), you must download its binaries from our website :
  33   http://download.videolan.org/pub/videolan/devtools/gettext-macosx.tar.gz
  34 and extract them into the current directory :
  35   tar xvzf gettext-macosx.tar.gz
  36
  37 Use the convert-po.sh script attached :
  38   setenv PATH gettext-macosx:$PATH
  39   setenv DYLD_LIBRARY_PATH=gettext-macosx
  40   ./convert-po.sh <LANG>.po
  41 [*]
  42
  43 Copy the resulting vlc.mo file to
  44   VLC.app/Contents/MacOS/locale/<LANG>/LC_MESSAGES
  45
  46 Launch VLC with --language <LANG>
  47 Where <LANG> is the international shortcode for your language.
  48
  49
  50 "fuzzy" translations
  51 ====================
  52 A fuzzy translation is an untranslated string for which gettext did an
  53 automatic suggestion, but needs your confirmation. They are marked with
  54 the "#, fuzzy" comment. If you think the suggestion is OK, or if you
  55 fixed the suggestion, do not forget to remove the "#, fuzzy" comment.
  56
  57
  58 Adding a language to VLC
  59 ========================
  60 When the language is added to the VLC sourcecode, remember to also edit
  61 src/libvlc.h for the preference option, and src/misc/darwin_specific.m
  62
  63
  64 [*] Step by step process to localize under Mac OS X (excerpt from a mail) :
  65 cd ~/Desktop
  66 curl -O http://www.videolan.org/pub/videolan/devtools/vlc-po-files.tar.gz
  67 tar xzf vlc-po-files.tar.gz
  68 cd vlc-po-files
  69 curl -O http://www.videolan.org/pub/videolan/devtools/gettext-macosx.tar.gz
  70 tar xzf gettext-macosx.tar.gz
  71 setenv PATH ./gettext-macosx:$PATH
  72 setenv DYLD_LIBRARY_PATH ./gettext-macosx
  73 [here you copy your it.po file to the vlc-po-files folder on your Desktop]
  74 ./convert-po.sh it.po
  75 [here you copy the vlc.mo file to your
  76 VLC.app/Contents/MacOS/locale/it/LC_MESSAGES]
  77
  78 --
  79 Christophe Massiot <massiot@via.ecp.fr>
  80 Derk-Jan Hartman <hartman at videolan dot org>
  81 $Id$