README.translators

   1 WhisperBack - Send feedback via encrypted e-mail
   2 ################################################
   3
   4 Copyright (C) 2009-2018 Tails developers <amnesia@boum.org>
   5
   6 This file explains how to translate WhisperBack. See README for generic
   7 informations
   8
   9 CONTENTS
  10 ========
  11
  12 - Before you begin
  13 - Create a new translation
  14 - Update an existing translation
  15 - Man page translation
  16
  17
  18 BEFORE YOU BEGIN
  19 ================
  20
  21 Make sure you have the required packages on your system: you'll need
  22 the build-depends of the Debian package that are listed in the line
  23 that starts with "Build-Depends" in the debian/control file.
  24
  25
  26 CREATE A NEW TRANSLATION
  27 ========================
  28
  29 1. Generate an uptodate template of translatable strings
  30
  31 In sources root, execute:
  32
  33     ./setup.py build
  34
  35 which will (re)generate the template `po/whisperback.pot`
  36
  37 2. Create the translations file for your language
  38
  39 In the `po/` directory, execute:
  40
  41     msginit --locale=<yourlocale>
  42
  43 For example to create a french translation file:
  44
  45     msginit --locale=fr_FR
  46
  47 3. Edit the translation file as usually
  48
  49 4. Send the result to Tails developers to include it in a next release
  50
  51
  52 UPDATE AN EXISTING TRANSLATION
  53 ==============================
  54
  55 1. Generate an uptodate template of translatable strings
  56
  57 In sources root, execute:
  58
  59     ./setup.py build
  60
  61 which will (re)generate the template `po/whisperback.pot`
  62
  63 2. Update the translations file for your language
  64
  65 In the `po/` directory, execute:
  66
  67     msgmerge --update <yourlocale>.po whisperback.pot
  68
  69 For example to update a french translation file:
  70
  71     msgmerge --update fr.po whisperback.pot
  72
  73 3. Edit the translation file as usually
  74
  75 4. Send the result to Tails developers to include it in a next release
  76
  77
  78 MAN PAGE TRANSLATION
  79 ====================
  80
  81 The man page source located in `doc/whisperback.t2t` is not currently
  82 translatable. Any help is welcome.