modules/translations/README.md

   1 # gitter-translations
   2
   3 Translations of Gitter to other languages. Please submit pull-requests if you would like to add or change anything!
   4
   5 [![Gitter](https://badges.gitter.im/gitter/gitter.svg)](https://gitter.im/gitter/gitter-translations?utm_source=badge&utm_medium=badge&utm_campaign=share-badge)
   6
   7 ## How this works
   8
   9 At the moment we are busy externalising all of our strings, so the only two areas that currently work are:
  10
  11 1.  Timestamps in chat
  12 2.  Homepage
  13
  14 ## Homepage instructions
  15
  16 The homepage strings are kept in the homepage directory
  17
  18 ## Additional areas of the application
  19
  20 We will continue to expand on the entire application over time. Please watch this repository for updates
  21
  22 ## Testing
  23
  24 It possible to visit the site with the lang query parameter, ex. https://gitter.im/?redirect=no&lang=ko.
  25
  26 Or you can change the browser main language in Chrome in [Language Settings](chrome://settings/languages) by putting tested language [at the top of the list](https://stackoverflow.com/a/36074203/606571).
  27
  28 ## Generating keys and placeholders
  29
  30 Generation and formatting happens automatically when linking this package to `webapp`
  31
  32 - `npm link` in this package
  33 - `npm link '@gitterhq/translations'` in `webapp`
  34
  35 and then starting the `webapp` and going to:
  36
  37 <details>
  38 <summary> Generated translation links </summary>
  39
  40 - http://localhost:5000/?&redirect=no&lang=ar
  41 - http://localhost:5000/?redirect=no&lang=bg
  42 - http://localhost:5000/?redirect=no&lang=cs
  43 - http://localhost:5000/?redirect=no&lang=de
  44 - http://localhost:5000/?redirect=no&lang=en
  45 - http://localhost:5000/?redirect=no&lang=es
  46 - http://localhost:5000/?redirect=no&lang=fr
  47 - http://localhost:5000/?redirect=no&lang=id
  48 - http://localhost:5000/?redirect=no&lang=it
  49 - http://localhost:5000/?redirect=no&lang=ja
  50 - http://localhost:5000/?redirect=no&lang=ka
  51 - http://localhost:5000/?redirect=no&lang=ko
  52 - http://localhost:5000/?redirect=no&lang=pl
  53 - http://localhost:5000/?redirect=no&lang=pt
  54 - http://localhost:5000/?redirect=no&lang=ru
  55 - http://localhost:5000/?redirect=no&lang=sk
  56 - http://localhost:5000/?redirect=no&lang=sv
  57 - http://localhost:5000/?redirect=no&lang=tr
  58 - http://localhost:5000/?redirect=no&lang=uk
  59 - http://localhost:5000/?redirect=no&lang=zh-TW
  60 - http://localhost:5000/?redirect=no&lang=zh
  61
  62 </details>
  63
  64 This adds all the missing keys to the homepage translation files.