git.sesse.net Git - vlc/blob - 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
  26 Testing your localization on Mac OS X
  27 =====================================
  28 If you do not have GNU gettext installed (you'd probably know if you had
  29 it :), you must download its binaries from our website :
  30   http://download.videolan.org/pub/videolan/devtools/gettext-macosx.tar.gz
  31 and extract them into the current directory :
  32   tar xvzf gettext-macosx.tar.gz
  33
  34 Use the convert-po.sh script attached :
  35   setenv PATH gettext-macosx:$PATH
  36   setenv DYLD_LIBRARY_PATH=gettext-macosx
  37   ./convert-po.sh <LANG>.po
  38 [*]
  39
  40 Copy the resulting vlc.mo file to
  41   VLC.app/Contents/MacOS/locale/<LANG>/LC_MESSAGES
  42
  43
  44 "fuzzy" translations
  45 ====================
  46 A fuzzy translation is an untranslated string for which gettext did an
  47 automatic suggestion, but needs your confirmation. They are marked with
  48 the "#, fuzzy" comment. If you think the suggestion is OK, or if you
  49 fixed the suggestion, do not forget to remove the "#, fuzzy" comment.
  50
  51
  52 [*] Step by step process to localize under Mac OS X (excerpt from a mail) :
  53 cd ~/Desktop
  54 curl -O http://www.videolan.org/pub/videolan/devtools/vlc-po-files.tar.gz
  55 tar xzf vlc-po-files.tar.gz
  56 cd vlc-po-files
  57 curl -O http://www.videolan.org/pub/videolan/devtools/gettext-macosx.tar.gz
  58 tar xzf gettext-macosx.tar.gz
  59 setenv PATH ./gettext-macosx:$PATH
  60 setenv DYLD_LIBRARY_PATH ./gettext-macosx
  61 [here you copy your it.po file to the vlc-po-files folder on your Desktop]
  62 ./convert-po.sh it.po
  63 [here you copy the vlc.mo file to your
  64 VLC.app/Contents/MacOS/locale/it/LC_MESSAGES]
  65
  66 --
  67 Christophe Massiot <massiot@via.ecp.fr>
  68 Derk-Jan Hartman <hartman at videolan dot org>
  69 $Id$