Set up a local Transifex repository HOWTO

About this document

This document is intended to all translators and release masters who will be deal with translations for Midnight Commander (also applicable for all other projects who use services of ​Transifex project).

About Transifex

​Transifex is a modern, open-source localization platform. It’s a web system which automates the translation workflow for complex international projects. Transifex seamlessly integrates with existing content infrastructure, such as a software development repository or content management system, using a rich API. Translation is "crowd-sourced" to a global network of human translators using smart and agile translation techniques adopted from the open source ecosystem.

Getting Transifex client

New client is available in binary form from GitHub (download, unpack and copy to ~/bin):

• ​https://github.com/transifex/cli/releases

Or check the links to set up Docker and use Docker image

• ​https://docs.docker.com/engine/install/fedora/
• ​https://docs.docker.com/engine/install/linux-postinstall/

with the following:

$ cat >~/bin/tx

#!/bin/sh

touch ~/.transifexrc

export XUID=$(id -u)
export XGID=$(id -g)

docker run \
    --rm -i \
    --user $XUID:$XGID \
    --volume="/etc/group:/etc/group:ro" \
    --volume="/etc/passwd:/etc/passwd:ro" \
    --volume="/etc/shadow:/etc/shadow:ro" \
    --volume $(pwd):/app \
    --volume ~/.transifexrc:/.transifexrc \
    --volume /etc/ssl/certs/ca-certificates.crt:/etc/ssl/certs/ca-certificates.crt \
    transifex/txcli \
    --root-config /.transifexrc \
    "$@"

CTRL+D

$ chmod +x ~/bin/tx

$ cat >~/.transifexrc
[https://www.transifex.com]
rest_hostname = https://rest.api.transifex.com
token         = 1/***

CTRL+D

Old client

As of 2024, Fedora 40 is unfortunately still shipping only the old client.

sudo yum install transifex-client

Using Transifex client

To make sure that transifex-client was installed correctly, try running it with the following command:

tx --help

If everything is okay, then you should see a help message and basic instructions. To get more information for each command of tool you can use

tx help <command>