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