Merge pull request ceph#63285 from afreen23/wip-71293-tentacle

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

Reviewed-by: Afreen Misbah <[email protected]>
Reviewed-by: Anthony D Atri <[email protected]>

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:tentacle]
+file_filter            = src/locale/messages.<lang>.xlf
+source_file            = src/locale/messages.xlf
+type                   = XLIFF
+minimum_perc           = 0
+resource_name          = Tentacle
+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"

src/pybind/mgr/dashboard/frontend/package-lock.json

@@ -310,7 +310,7 @@
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.html</context>
-          <context context-type="linenumber">38</context>
+          <context context-type="linenumber">39</context>
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/smb/smb-tabs/smb-tabs.component.html</context>
@@ -2113,7 +2113,7 @@
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.html</context>
-          <context context-type="linenumber">32</context>
+          <context context-type="linenumber">33</context>
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-tabs/nvmeof-tabs.component.html</context>
@@ -2498,7 +2498,7 @@
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.ts</context>
-          <context context-type="linenumber">71</context>
+          <context context-type="linenumber">69</context>
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/cluster/hosts/hosts.component.ts</context>
@@ -2965,23 +2965,23 @@
           <context context-type="linenumber">152</context>
         </context-group>
       </trans-unit>
-      <trans-unit id="f5ff2607cf2fd0645a263371d6f93f063d07e33a" datatype="html">
-        <source>Enter group</source>
+      <trans-unit id="cf378a96424886fda41c2c758e3996513692cd54" datatype="html">
+        <source>Selected Gateway Group</source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.html</context>
-          <context context-type="linenumber">10</context>
+          <context context-type="linenumber">8</context>
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-subsystems/nvmeof-subsystems.component.html</context>
-          <context context-type="linenumber">10</context>
+          <context context-type="linenumber">8</context>
         </context-group>
       </trans-unit>
       <trans-unit id="3cc9c2ae277393b3946b38c088dabff671b1ee1b" datatype="html">
         <source>Performance</source>
         <target>Výkonnost</target>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.html</context>
-          <context context-type="linenumber">44</context>
+          <context context-type="linenumber">45</context>
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/rbd-details/rbd-details.component.html</context>
@@ -2996,36 +2996,47 @@
         <source> Gateways <x id="START_TAG_CD_HELP_TEXT" ctype="x-cd_help_text" equiv-text="&lt;cd-help-text&gt;"/> Ceph NVMe-oF gateways provide Ceph Block Device storage through NVMe/TCP. For VMware clients the NVMe/TCP volumes display as VMFS Datastores. For Linux clients the NVMe/TCP volumes display as as block devices. <x id="CLOSE_TAG_CD_HELP_TEXT" ctype="x-cd_help_text" equiv-text="&lt;/cd-help-text&gt;"/></source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.html</context>
-          <context context-type="linenumber">53,57</context>
+          <context context-type="linenumber">54,58</context>
         </context-group>
       </trans-unit>
       <trans-unit id="88d52a108e372081c5e122c5b369aac3ec904146" datatype="html">
         <source>Gateway overview</source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.html</context>
-          <context context-type="linenumber">69</context>
+          <context context-type="linenumber">70</context>
         </context-group>
       </trans-unit>
       <trans-unit id="9517e7f935e73e6889dda20c0fa0408465c18f2e" datatype="html">
         <source>Gateway performance</source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.html</context>
-          <context context-type="linenumber">79</context>
+          <context context-type="linenumber">80</context>
+        </context-group>
+      </trans-unit>
+      <trans-unit id="5032690935748986815" datatype="html">
+        <source>Enter group name</source>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.ts</context>
+          <context context-type="linenumber">25</context>
+        </context-group>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/ceph/block/nvmeof-subsystems/nvmeof-subsystems.component.ts</context>
+          <context context-type="linenumber">20</context>
         </context-group>
       </trans-unit>
       <trans-unit id="7974613004081450726" datatype="html">
         <source>Gateway ID</source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.ts</context>
-          <context context-type="linenumber">67</context>
+          <context context-type="linenumber">65</context>
         </context-group>
       </trans-unit>
       <trans-unit id="5611592591303869712" datatype="html">
         <source>Status</source>
         <target>Stav</target>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.ts</context>
-          <context context-type="linenumber">75</context>
+          <context context-type="linenumber">73</context>
         </context-group>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/rbd-trash-list/rbd-trash-list.component.ts</context>
@@ -3060,6 +3071,17 @@
           <context context-type="linenumber">71</context>
         </context-group>
       </trans-unit>
+      <trans-unit id="3107044384926915007" datatype="html">
+        <source>No groups available</source>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/ceph/block/nvmeof-gateway/nvmeof-gateway.component.ts</context>
+          <context context-type="linenumber">134</context>
+        </context-group>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/ceph/block/nvmeof-subsystems/nvmeof-subsystems.component.ts</context>
+          <context context-type="linenumber">148</context>
+        </context-group>
+      </trans-unit>
       <trans-unit id="4f7cdf99e53b74c843abea60b5ca07a6842c9135" datatype="html">
         <source>Hosts </source>
         <context-group purpose="location">
@@ -3316,6 +3338,10 @@
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-listeners-form/nvmeof-listeners-form.component.ts</context>
           <context context-type="linenumber">50</context>
         </context-group>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/ceph/block/nvmeof-listeners-list/nvmeof-listeners-list.component.ts</context>
+          <context context-type="linenumber">103</context>
+        </context-group>
       </trans-unit>
       <trans-unit id="6641024648411549335" datatype="html">
         <source>Host</source>
@@ -3356,6 +3382,13 @@
           <context context-type="linenumber">81</context>
         </context-group>
       </trans-unit>
+      <trans-unit id="5236029444167617860" datatype="html">
+        <source>listener</source>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/ceph/block/nvmeof-listeners-list/nvmeof-listeners-list.component.ts</context>
+          <context context-type="linenumber">106</context>
+        </context-group>
+      </trans-unit>
       <trans-unit id="e70fcca5a99575cffef3ff8cbd5e69f06ffd0f1c" datatype="html">
         <source>Pool</source>
         <target>Fond</target>
@@ -3800,28 +3833,28 @@
         <source> Subsystems <x id="START_TAG_CD_HELP_TEXT" ctype="x-cd_help_text" equiv-text="&lt;cd-help-text&gt;"/> A subsystem provides access control to which hosts can access the namespaces within the subsystem. <x id="CLOSE_TAG_CD_HELP_TEXT" ctype="x-cd_help_text" equiv-text="&lt;/cd-help-text&gt;"/></source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-subsystems/nvmeof-subsystems.component.html</context>
-          <context context-type="linenumber">18,22</context>
+          <context context-type="linenumber">19,23</context>
         </context-group>
       </trans-unit>
       <trans-unit id="7707701592702091951" datatype="html">
         <source>NQN</source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-subsystems/nvmeof-subsystems.component.ts</context>
-          <context context-type="linenumber">61</context>
+          <context context-type="linenumber">59</context>
         </context-group>
       </trans-unit>
       <trans-unit id="4249456376242514671" datatype="html">
         <source># Namespaces</source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-subsystems/nvmeof-subsystems.component.ts</context>
-          <context context-type="linenumber">65</context>
+          <context context-type="linenumber">63</context>
         </context-group>
       </trans-unit>
       <trans-unit id="8636681982233006716" datatype="html">
         <source># Maximum Allowed Namespaces</source>
         <context-group purpose="location">
           <context context-type="sourcefile">src/app/ceph/block/nvmeof-subsystems/nvmeof-subsystems.component.ts</context>
-          <context context-type="linenumber">69</context>
+          <context context-type="linenumber">67</context>
         </context-group>
       </trans-unit>
       <trans-unit id="409b6a23ac5c8302cbe2868c58d14eb425d72ddd" datatype="html">