Merge pull request #959 from opengisch/transidoc

Translation (Transifex) Guide in Documentation

.github/workflows/continuous_integration.yml

@@ -30,7 +30,7 @@ jobs:
         run: |
           sudo ./scripts/package_pip_packages.sh
       - name: Test on QGIS
-        run: docker-compose -f .docker/docker-compose.gh.yml run qgis /usr/src/.docker/run-docker-tests.sh
+        run: docker compose -f .docker/docker-compose.gh.yml run qgis /usr/src/.docker/run-docker-tests.sh
 
   release:
     runs-on: ubuntu-22.04

docs/docs/about/translation.md

@@ -0,0 +1,31 @@
+This project (Plugin and documentation) can be translated into any language.
+
+Your language is missing? Feel free to contribute!
+
+# How to get started
+
+1. Log in to https://app.transifex.com/
+
+    Then go to *Join another organization*
+
+2. In the search mask, enter “qgis model baker”. You will be taken to this page https://explore.transifex.com/search/?q=model%20baker
+
+    ![search-mask](../assets/transifex-search-mask.png)
+
+3. Select the project you want to translate and select *Join this project*, you will be taken back to your dashboard:
+
+    ![join-requested](../assets/transifex-join-requested.png)
+
+    Now someone from OPENGIS.ch must accept. If nothing happens, it's best to write an e-mail.
+
+4. If your request has been accepted, the projects are available to you:
+
+    ![projects](../assets/transifex-projects.png)
+
+5. You are ready to go. Select *Translate*
+
+    ![translate](../assets/transifex-translate.png)
+
+6. And now you can translate.
+
+    ![translating](../assets/transifex-translating.png)

docs/mkdocs.yml

@@ -58,7 +58,9 @@ nav:
       - Migrate from ili2db 3 to 4: background_info/upgrade_3_to_4.md
     #- Relations in QGIS: maybe from here https://github.com/signedav/interlis_relations_in_qgis
     #- INTERLIS Syntax in 10 Minutes: maybe stuff from here https://github.com/signedav/talk_iliuniverse
-  - Development: development.md
+  - About:
+      - Development: about/development.md
+      - Translation: about/translation.md
     #- Library: Info about the upcoming python package
 
 markdown_extensions:

scripts/run-tests.sh

@@ -15,5 +15,5 @@ fi
 cd $(dirname $0)/..
 export GITHUB_WORKSPACE=$PWD # only for local execution
 
-docker-compose -f .docker/docker-compose.gh.yml run qgis /usr/src/.docker/run-docker-tests.sh $@
-docker-compose -f .docker/docker-compose.gh.yml rm -s -f
+docker compose -f .docker/docker-compose.gh.yml run qgis /usr/src/.docker/run-docker-tests.sh $@
+docker compose -f .docker/docker-compose.gh.yml rm -s -f