Translating Nitrokey App

Installing Linguist

Ubuntu 17.04

With Apt

1. Install Linguist tool with its dependencies (with Qt Framework; will download about 300 MB)

sudo apt install qttools5-dev-tools
qttools5-dev-tools: /usr/lib/x86_64-linux-gnu/qt5/bin/linguist

2. Run the Linguist tool from Applications menu. If it is not available there here is a path to binary from Ubuntu 17.04 - please paste it into the terminal:

./usr/lib/x86_64-linux-gnu/qt5/bin/linguist

In case the path would be changed by the Ubuntu maintainers please use the following commands to find current package and path:

sudo apt install apt-file
apt-file find bin/linguist

which should result in:

$ apt-file find bin/linguist
qt4-dev-tools: /usr/bin/linguist-qt4
qt4-dev-tools: /usr/lib/x86_64-linux-gnu/qt4/bin/linguist
qtchooser: /usr/bin/linguist
qttools5-dev-tools: /usr/lib/x86_64-linux-gnu/qt5/bin/linguist

3. When finished the translation process one can remove the program with:

sudo apt remove qttools5-dev-tools # to remove Linguist
sudo apt autoremove # to remove unused dependencies from the OS

MacOS Sierra 10.12.6

With Brew.sh

1. Download and extract Nitrokey App: link
2. Open terminal
3. Paste this into the terminal (see brew's main page for detailed instructions):

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3. Install Qt (will download 300MB):

brew install qt

Make a note of the downloaded version, e.g. here it is 5.9.2:

Summary
/usr/local/Cellar/qt/5.9.2: 9,021 files, 279.6MB

4. Run Linguist - a translation support tool for Qt from the directory mentioned earlier (note the path may be different due to other version number of Qt framework):

/usr/local/Cellar/qt/5.9.2/libexec/Linguist.app/Contents/MacOS/Linguist

5. When finished the translation process one can remove the program with:

brew uninstall qt

Other OS / General instructions

It is possible to download the Qt binaries directly from vendor's site. Please download and run Qt's Online installers from Download site (might require to register a free account on Qt's site). In the installer please choose only latest Qt version. If possible please choose only Tools section to avoid downloading too much data.

Translation process

With Linguist application:

1. Open translation file (*.ts) in Nitrokey App directory for given language - eg. i18n/nitrokey_en.ts (here)
2. Translate the strings and mark them as finished
3. Save and send the changed *.ts files in compressed archive to support AT nitrokey DOT com or make a pull request to Github.

Detailed manual for Linguist (and the translation process as a whole) is available at Qt Framework's site and especially here.