mgr/dashboard: deprecate transifex-i18ntool and support transifex cli

- transifex-i18ntool is no longer maintained
- transifex officialy supports now a tool https://github.com/transifex/cli
- doc update

Fixes https://tracker.ceph.com/issues/71127

Signed-off-by: Afreen Misbah <[email protected]>
(cherry picked from commit 25fa421)

Author: afreen23

doc/dev/developer_guide/dash-devel.rst

@@ -1083,56 +1083,56 @@ All translations will then be reviewed and later pushed upstream.
 Updating translated messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Any time there are new messages translated and reviewed in a specific language
-we should update the translation file upstream.
+1. Download the `transifex CLI tool <https://github.com/transifex/cli>`_
 
-To do that, check the settings in the i18n config file
-``src/pybind/mgr/dashboard/frontend/i18n.config.json``:: and make sure that the
-organization is *ceph*, the project is *ceph-dashboard* and the resource is
-the one you want to pull from and push to e.g. *Master:master*. To find a list
-of available resources visit `<https://www.transifex.com/ceph/ceph-dashboard/content/>`_.
+2. Create an `API token <https://www.transifex.com/user/settings/api/>`_.
 
-After you checked the config go to the directory ``src/pybind/mgr/dashboard/frontend`` and run::
+3. Pushing translation:
 
-  $ npm run i18n
+  $ tx push -s
 
-This command will extract all marked messages from the HTML templates and
-TypeScript files. Once the source file has been created it will push it to
-transifex and pull the latest translations. It will also fill all the
-untranslated strings with the source string.
-The tool will ask you for an api token, unless you added it by running:
+  This will push the source file in transifex.
 
-  $ npm run i18n:token
+4. Pulling translation:
 
-To create a transifex api token visit `<https://www.transifex.com/user/settings/api/>`_.
+  $ tx pull -r ceph-dashboard.<resource_slug> -f
 
-After the command ran successfully, build the UI and check if everything is
-working as expected. You also might want to run the frontend tests.
+  e.g `tx pull -r ceph-dashboard.main`
+
+  This will pull all translations of the resource. 
 
 Add a new release resource to transifex
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In order to organize the translations, we create a
 `transifex resource <https://www.transifex.com/ceph/ceph-dashboard/content/>`_
 for every Ceph release. This means, once a new version has been released, the
-``src/pybind/mgr/dashboard/frontend/i18n.config.json`` needs to be updated on
+``src/pybind/mgr/dashboard/frontend/.tx/config`` needs to be updated on
 the release branch.
 
 Please replace::
-
-"resource": "Master:master"
+`resource_name          = Main`
 
 by::
+`resource_name          = <Release-name>`
+
+E.g. the resource definition for the Tentacle release::
+`resource_name          = Tentacle`
 
-"resource": "<Release-name>:<release-name>"
+And replace::
+`[o:ceph:p:ceph-dashboard:r:main]`
+
+by::
+`[o:ceph:p:ceph-dashboard:r:<release-name>]`
 
-E.g. the resource definition for the pacific release::
+E.g. the resource definition for the Tentacle release::
+`[o:ceph:p:ceph-dashboard:r:tentacle]`
 
-"resource": "Pacific:pacific"
+Once done push the translations::
+  $ tx push -s
 
 Note:
-  The first part of the resource definition (before the colon) needs to be
-  written with a capital letter.
+  Only the <Release-name> is capitalized.
 
 Suggestions
 ~~~~~~~~~~~

src/pybind/mgr/dashboard/frontend/.tx/config

@@ -0,0 +1,12 @@
+[main]
+host = https://app.transifex.com
+
+[o:ceph:p:ceph-dashboard:r:main]
+file_filter            = src/locale/messages.<lang>.xlf
+source_file            = src/locale/messages.xlf
+type                   = XLIFF
+minimum_perc           = 0
+resource_name          = Main
+replace_edited_strings = false
+keep_translations      = false
+lang_map               = de_DE: de-DE, es_ES: es-ES, fr_FR: fr-FR, id_ID: id-ID, it_IT: it-IT, ja_JP: ja-JP, ko_KR: ko-KR, pl_PL: pl-PL, pt_BR: pt-BR, zh_CN: zh-CN, zh_TW: zh-TW

src/pybind/mgr/dashboard/frontend/i18n.config.json

@@ -138,7 +138,6 @@
     "stylelint-config-sass-guidelines": "7.1.0",
     "stylelint-declaration-use-variable": "1.7.3",
     "table": "6.8.0",
-    "transifex-i18ntool": "1.1.0",
     "ts-node": "9.0.0",
     "typescript": "5.4.5",
     "validator": "13.12.0"