wiki/src/contribute/l10n_tricks.mdwn

   1 [[!toc]]
   2
   3 Compare the content of two PO files
   4 ===================================
   5
   6 Here is how to check out the differences between two PO files without
   7 caring about strings order, line breaks or comments.
   8
   9     diff -u <(msgfmt -o - translation/es/es.po | msgunfmt) \
  10             <(msgfmt -o - persistence-setup/po/es.po | msgunfmt)
  11
  12 The syntax is bash specific. Replace the paths to the two PO files you
  13 are interested in comparing.
  14
  15 Calculate statistics on the translations
  16 ========================================
  17
  18 Run the [[language statistics.sh]] script.
  19
  20 Build the wiki offline
  21 ======================
  22
  23 To check your translations before you send them, you may want to browse the
  24 wiki offline. See the [[corresponding documentation|contribute/build/website]].
  25
  26 Search for fuzzy strings with Vim
  27 =================================
  28
  29 Ran inside Vim, the following command will search recursively for *fuzzy*
  30 inside *.fr.po* files
  31
  32     :vimgrep /fuzzy/ **/*.fr.po |:copen
  33
  34 To switch easily between the file list and the editor, using Alt + Arrow
  35 up/down, you can add those lines in .vimrc:
  36
  37     nmap <silent> <A-Up> :wincmd k<CR>
  38     nmap <silent> <A-Down> :wincmd j<CR>
  39
  40 Check the validity of PO files
  41 ==============================
  42
  43 Use the tool [i18nspector](http://jwilk.net/software/i18nspector).
  44
  45 To copy, install and run it issue the following commands in the folder where
  46 you want to download it:
  47
  48     apt-get install i18nspector/unstable
  49     i18nspector <PO file>
  50
  51 Run i18nspector on the whole wiki
  52 =================================
  53
  54     cd wiki/src
  55     contribute/l10n_tricks/check_po.sh
  56
  57 Rewrap files
  58 ============
  59
  60 To rewrap one .po file:
  61
  62     msgcat --width=80 -o your_output_file.po your_input_file.po
  63
  64 To rewrap several .po files:
  65
  66     for f in $(find . -type f -name .po) ; do msgcat --width=80 -o \
  67          "${f}.new" "$f" ; mv -f "${f}.new" "$f" ; done
  68
  69 To rewrap a .mdwn file:
  70
  71     fold -s -w 80 translate.mdwn > translate.mdwn.out
  72
  73 Quickly update several repositories
  74 ===================================
  75
  76 Tails is split in [[several git repositories|contribute/git]]: tails-greeter,
  77 whisperback, persistence-setup, *etc*.
  78
  79 If you cloned those differents repositories in the same folder, you can pull them all
  80 in a row with the following bash script:
  81
  82     #!/bin/sh
  83         for d in $(find . -type d -name ".git" | sed 's/\/.git\+$//' ); do
  84            echo "Current repository: $d";
  85            cd $d && git pull && cd - || exit 1
  86     done
  87
  88 This will basically check in all subfolders if there is an existing `.git` folder,
  89 and run `git pull` if appropriate.