[[TOC]] = 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 [http://www.transifex.com Transifex] project). == About Transifex == [http://www.transifex.com 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 == {{{ sudo dnf 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 }}} === tx-repository initialization === Transifex client uses mapping to local files as one directory per tx-resource, but git-repository provide several branches in one directory therefore I suggest to separate TX-repo and GIT-repo in different directories. We'll mark these directories as $TX_REPO and $GIT_REPO. Run follow commands: {{{ $ mkdir $TX_REPO $ cd $TX_REPO $ tx init Creating .tx folder... Transifex instance [https://www.transifex.net]: Creating skeleton... Creating config file... $ }}} Add local mapping for pot-resources: {{{ cat >>$TX_REPO/.tx/config <.po source_file = master/mc.pot source_lang = en [mc.mc_hint] file_filter = mc.mc_hint/.po source_file = mc.mc_hint/mc.pot source_lang = en EOF }}} Fetch all translations by command: {{{ tx pull --all }}} Now you are ready to fetch translations before any release (as this described on ReleaseGuidelines page).