Scrolliris Website Translation

Code Name: Uttigen /uttigen/

 _
(_|    |        o
  |    | _|__|_     __,  _   _  _
  |    |  |  |  |  /  | |/  / |/ |
   \__/\_/|_/|_/|_/\_/|/|__/  |  |_/
                     /|
                     \|

Uttigen; gnU geTText translatIon packaGE, it's called uttigeN

This is translation project for the Scrolliris Website which called as Thun (code name).

Repository

https://gitlab.com/scrolliris/scrolliris-website-translation.git

Requirements

• Git >= 2.11.0
• GNU gettext >= 0.19.8.1

Setup

OpenBSD

;)

GNU/Linux

;)

: e.g. Gentoo Linux
% sudo emerge -av dev-vcs/git
% sudo emerge -av sys-devel/gettext

macOS

Try following package managers to install gettext (tools)

• https://www.macports.org/
• http://brew.sh/

: MacPorts
% sudo port install git gettext

: Homebrew
% brew install git gettext
% brew link --force git
% brew link --force gettext

Windows

TODO

Compile

See Makefile.

% make

Note

How to apply your changes

Open your terminal application, follow these steps, normally.

: 0. Fetch and apply new changes from upstream repository
% git pull origin master

: 1. Create a topic branch
% git checkout -b <what-do-you-do>

: 2. Change *.po file at here
% $EDITOR en/LC_MESSAGES/message.po

: 3. Compile as a check of validity (use `make` command described above)
% make

: 4. Commit your changes (Don\'t add `*.mo` files, add only `*.po`)
% git add .
% git commit

: 5. Push your topic branch
% git push origin <what-do-you-do>

And then, create a merge request on this repository.

How to generate new *.po file

Use ./bin/linguine-lite utility command.

% ./bin/linguine-lite generate message de

What's linguine-lite command

This is a shell script command for translation files.

% ./bin/linguine-lite --help

Usage: linguine-lite <action> <domain> <locale>

The cli command to compile/generate/update gettext catalog files.
...<snip>

Options:
  -h, --help   display this help and exit

Positional arguments:
  <action>   {compile|c},{generate|g},{update|u}
  <domain>   message
  <locale>   en

Actions:
  compile    compile *.po to *.mo for application
  generate   create new *.po file with latest *.pot
  update     update *.po using *.pot (template)

Examples:
  % linguine-lite update message en
  % linguine-lite c message en

How to compile catalog same condition with CI on local machine

Run gitlab-ci localy using gitlab-ci-multi-runner. If you do this, you need docker on linux.

Setup

Prepare gitlab-ci-multi-runner in your local machine.

: use setup script
% ./bin/setup-gitlab-ci-multi-runner

: or install runner (gitlab-ci-multi-runner) into somewhere, manually
% curl -sL https://gitlab-ci-multi-runner-downloads.s3.amazonaws.com\
  /latest/binaries/gitlab-ci-multi-runner-linux-amd64 \
  -o bin/gitlab-ci-multi-runner
% chmod +x bin/gitlab-ci-multi-runner
: run runner container
% docker run -d --name gitlab-runner --restart always \
  -v /srv/gitlab-runner/config:/etc/gitlab-runner \
  gitlab/gitlab-runner:latest

Run

Start docker as service, then run ci-runner.

: run docker service
% sudo service docker start

: run compile job in docker (via gitlab-ci-multi-runner)
% ./bin/ci-runner compile

: this is equivalent as above command
% ./bin/gitlab-ci-multi-runner exec docker \
  --cache-dir /cache \
  --docker-volumes `pwd`/tmp/_cache:/cache \
  --env <ENVVAR>=... \
  ...
  <JOB>

links

See documents.

• https://gitlab.com/gitlab-org/gitlab-ci-multi-runner/issues/312
• https://docs.gitlab.com/runner/install/linux-manually.html

Support

If you have any question, email us feedback@lupine-software.com, or contact @scrolliris on Twitter.

License

This project is distributed as multiple licenses by parts.

Scrolliris Website Translation
Copyright (c) 2017 Lupine Software LLC

Software (program)

GPL-3.0

The cli command linguine-lite and Makefile are distributed as GNU General Public License. (version 3)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

Text (translation)

GFDL-1.3

This work is distributed as GNU Free Documentation License. (version 1.3)

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License".

See LICENSE.