Implement i18n support in frontend using Angular + Transifex + NGINX

Browse Source

This PR adds basic i18n support into the mempool frontend, together with
a smooth workflow for developers and translators to collaborate:

* Using the existing @angular/localize module, developers add i18n
metadata to any frontend strings their new features or changes modify

* Using the new npm script `i18n-extract-from-source`, developers
extract the i18n data from source code into `src/locale/messages.xlf`

* After pushing the updated `src/locale/messages.xlf` to GitHub, the
Transifex service will update its database from the new source data

* Using the Transifex website UI, translators can work together to
translate all the mempool frontend strings into their native languages

* Using the new npm script `i18n-pull-from-transifex`, developers can
pull in completed translations from Transifex, and commit them into git.

This flow requires an API key from Transifex, which can be obtained at
https://www.transifex.com/user/settings/api/ to be used with the python
script installed by `pip install transifex-client` - after preparing
these, run the npm script which will ask you for the API key the first
time. When downloading is complete, you can test building the frontend,
and if successful, commit the new strings files into git.

This PR implements a new locale selector in the footer of the homepage
dashboard, and includes WIP translations for the following languages:

* Czech (cs)
* German (de)
* Japanese (ja)
* Norwegian (nn)
* Spanish (es)
* Swedish (sv)
* Ukrainian (uk)
* Persian (fa)
* Portugese (pt)
* Turkish (tr)
* Dutch (nl)
* French (fr)
* Chinese (zh)
* Slovenian (sl)
* Korean (ko)
* Polish (pl)

The user-agent's `Accept-Language` header is used to automatically
detect their preferred language, which can be manually overriden by the
pull-down selector, which saves their preference to a cookie, which is
used by nginx to serve the correct HTML bundle to the user.

Remaining tasks include adding i18n metadata for strings in the Bisq and
Liquid frontend code, mouseover hover tooltip strings, hard-coded og
metadata inside HTML templates, and many other places. This will be done
in a separate PR.

When upgrading to add i18n support, mempool instance operators must take
care to install the new nginx.conf and nginx-mempool.conf files, and
tweak for their specific site configuration.

Fixes #81

...

This commit is contained in:

wiz

2020-12-02 04:19:33 +09:00

parent f151eb81c8

commit 4658b47007

60 changed files with 41826 additions and 451 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

2224

frontend/src/locale/messages.cs.xlf Normal file

File diff suppressed because it is too large Load Diff

2224

frontend/src/locale/messages.de.xlf Normal file

File diff suppressed because it is too large Load Diff

2016

frontend/src/locale/messages.en_US.xlf Normal file

File diff suppressed because it is too large Load Diff

2224

frontend/src/locale/messages.es.xlf Normal file

File diff suppressed because it is too large Load Diff

2217

frontend/src/locale/messages.fa.xlf Normal file

File diff suppressed because it is too large Load Diff

2134

frontend/src/locale/messages.fr.xlf Normal file

File diff suppressed because it is too large Load Diff

2224

frontend/src/locale/messages.ja.xlf Normal file

File diff suppressed because it is too large Load Diff

2067

frontend/src/locale/messages.ko.xlf Normal file

File diff suppressed because it is too large Load Diff

2154

frontend/src/locale/messages.nl.xlf Normal file

File diff suppressed because it is too large Load Diff

2224

frontend/src/locale/messages.nn.xlf Normal file

File diff suppressed because it is too large Load Diff

2046

frontend/src/locale/messages.pl.xlf Normal file

File diff suppressed because it is too large Load Diff

2187

frontend/src/locale/messages.pt.xlf Normal file

File diff suppressed because it is too large Load Diff

2203

frontend/src/locale/messages.pt_BR.xlf Normal file

File diff suppressed because it is too large Load Diff

2113

frontend/src/locale/messages.sl.xlf Normal file

File diff suppressed because it is too large Load Diff

2226

frontend/src/locale/messages.sv.xlf Normal file

File diff suppressed because it is too large Load Diff

2167

frontend/src/locale/messages.tr.xlf Normal file

File diff suppressed because it is too large Load Diff

2224

frontend/src/locale/messages.uk.xlf Normal file

File diff suppressed because it is too large Load Diff

2017

frontend/src/locale/messages.xlf Normal file

File diff suppressed because it is too large Load Diff

2116

frontend/src/locale/messages.zh.xlf Normal file

File diff suppressed because it is too large Load Diff