chore: upgrate transifex cli to new version

.github/workflows/build.yml

@@ -19,6 +19,8 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements_prod.txt
+    - name: Get translations
+      run: make pulllang
     - name: Flush errors
       run: make allerr
     - name: Build docs

.gitignore

@@ -20,3 +20,6 @@ Thumbs.db
 .*.swp
 *.sublime-project
 *.sublime-workspace
+
+source/locale/*
+!source/locale/README.md

Makefile

@@ -39,7 +39,7 @@ pushlang:
 
 # push translated strings from Transifex
 pulllang:
-	tx pull --language "cs,es,fil,fr,id,sw,te,zh"
+	tx pull --languages "cs,es,fil,fr,id,sw,te,zh"
 
 build:
 	@$(SPHINXBUILD) -b dirhtml "$(SOURCEDIR)" "$(BUILDDIR)/html" -nW

README.md

@@ -216,12 +216,26 @@ Code snippets need to have a space before, then a double backtick or grave accen
 
 ## Managing the translation process
 
-This project uses [Transifex](https://www.transifex.com/) and the [`transifex-client`](https://docs.transifex.com/client/introduction) tool to help people contribute translations. The `transifex-client` tool is included in the requirements.txt file and should be installed on your system during setup when you run `pip install -r requirements.txt`.
+This project uses [Transifex](https://www.transifex.com/) and the [`Transifex Client`](https://developers.transifex.com/docs/cli) tool to help people contribute translations. The `transifex-client` tool is included in the requirements.txt file and should be installed on your system during setup when you run `pip install -r requirements.txt`.
 
-You need to configure your account. For this, you need to create an API Token for your user to access this service through the command line. This can be done under your Transifex [User’s Settings](https://www.transifex.com/user/settings/api/). Set it up to use the token:
+::warning
+The APIv2 of Transifex is getting deprecated. We have to migrate to [**new version of Transifex Client**](https://developers.transifex.com/docs/cli).
+
+refer: https://developers.transifex.com/docs/cli#differences-with-the-previous-version
+::
+
+You need to configure your account. For this, you need to create an API Token for your user to access this service through the command line. This can be done under your Transifex [User’s Settings](https://app.transifex.com/user/settings/api/). Set it up to use the token. The available environment variables for the CLI:
+
+```
+TX_TOKEN: The API token
+TX_HOSTNAME: The API hostname
+TX_CACERT: Path to CA certificate bundle file
+```
+
+You can either add these variables in your CI settings, your profile file, or when executing the commands like this: 
 
 ```
-tx init --token $TOKEN --skipsetup
+TX_TOKEN=myapitoken tx pull
 ```
 
 If there are **new** English `.rst` source files, you can map them by updating the `./.tx/config` file.

requirements.txt

@@ -2,5 +2,4 @@ sphinx==5.3.0
 sphinx-autobuild==2021.3.14
 sphinx-intl==2.0.1
 sphinx-rtd-theme==1.1.1
-transifex-client==0.12.5
 sphinxcontrib-mermaid==0.9.2

source/installation.rst

@@ -429,7 +429,7 @@ The ``init.sql``:
 
 And finally the ``compose.yml``:
 
-.. code:: yml
+.. code:: yaml
 
 	services:
 	  webodm-node-odm-1:

source/large.rst

@@ -41,7 +41,7 @@ ODM can also automatically distribute the processing of each submodel to multipl
    :align: center
 
 Getting Started with Distributed Split-Merge
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The first step is start ClusterODM
 

source/locale/README.md

@@ -0,0 +1 @@
+Use `make pulllang` to pull the latest supported translations from Transifex or refer to [`Transifex Client`](https://developers.transifex.com/docs/cli) to pull the other language.