feat(translations): ExApps on Python support Transifex translations sync

developer_manual/basics/translations.rst

@@ -119,6 +119,18 @@ They differ a bit in terms of usage compared to php:
     t('myapp', '{name} is available. Get {linkstart}more information{linkend}', {name: 'Nextcloud 16', linkstart: '<a href="...">', linkend: '</a>'});
     n('myapp', 'Import %n calendar into {collection}', 'Import %n calendars into {collection}', selectionLength, {collection: 'Nextcloud'});
 
+
+ExApps (Python)
+---------------
+
+For ExApps, Python is currently only supported for automated Transifex translations.
+
+Alongside the usual ``l10n/*.json`` and ``l10n/*.js`` files, translation source files located in ``translationfiles/<lang>/*.po`` are also included in the Transifex sync.
+These ``.po`` files can be compiled into ``.mo`` files, which are typically used by the ExApp backend for runtime translations.
+
+For more details, see :ref:`ex_app_translations`.
+
+
 Guidelines
 ----------
 

developer_manual/exapp_development/tech_details/Translations.rst

@@ -1,3 +1,5 @@
+.. _ex_app_translations:
+
 Translations
 ============
 
@@ -19,9 +21,18 @@ For the front-end part, AppAPI will inject the current user's locale ``l10n/<lan
 Back-end
 ********
 
-For the back-end part of ExApp, which can be written in different programming languages, it is **up to the developer to decide** how to handle and translations files.
+For the back-end part of ExApp, which can be written in different programming languages, it is **up to the developer to decide** how to handle translations files.
 There is an example repository with translations: `UI example with translations <https://github.com/nextcloud/ui_example>`_.
 
+There are two Python functions used by `translationtool <https://github.com/nextcloud/docker-ci/tree/master/translations/translationtool>`_ to extract translation string: ``_('singular string')`` and ``_n('singular string', 'plural string', count)``.
+
+
+Transifex sync
+--------------
+
+For automated Transifex sync there are only ``.po`` files included.
+You can then compile them to ``.mo`` files using `ui_example's <https://github.com/nextcloud/ui_example/tree/main/scripts/compile_po_to_mo.sh>`_ ``scripts/compile_po_to_mo.sh`` script.
+
 
 Manual install
 **************