Use Weblate to host translations

Refs: #179

NEWS.rst

@@ -17,6 +17,9 @@ Added
 Changed
 -------
 
+- Weblate is used to host translations `#179
+  <https://github.com/orontee/argos/issues/179>`_
+
 - Support playlists without date of last modification `#177
   <https://github.com/orontee/argos/issues/177>`_
 

README.rst

@@ -10,6 +10,10 @@ Argos
     :target: https://mypy-lang.org/
     :alt: Type check: mypy
 
+.. image:: https://hosted.weblate.org/widget/argos/argos/svg-badge.svg
+    :target: https://hosted.weblate.org/engage/argos/
+    :alt: Translations: Weblate
+
 .. image:: https://github.com/orontee/argos/actions/workflows/build.yaml/badge.svg
     :target: https://github.com/orontee/argos/actions/workflows/build.yaml
     :alt: CI build status
@@ -235,5 +239,10 @@ the library::
 Contributing
 ============
 
+No developer skills are required to contribute to translations or add
+support for new languages, thanks to the `Weblate platform
+<https://hosted.weblate.org/projects/argos/argos/>`_. More on this
+topic in the `translations documentation </po/README.rst>`_.
+
 Instructions to install an unreleased version, debug, etc. can be found
 in the `CONTRIBUTING file </CONTRIBUTING.rst>`_.

po/README.rst

@@ -0,0 +1,41 @@
+============
+Translations
+============
+
+Contributions welcome!
+
+Howto
+=====
+
+People interested in contributing to translations should use the
+corresponding `Weblate project
+<https://hosted.weblate.org/projects/argos/argos/>`_.
+
+Translations will be pushed by Weblate bot to Github source code
+repository, on the ``translations`` branch.
+
+This branch is manually merged in ``main`` branch periodically.
+
+Technical considerations
+========================
+
+Translations are stored in `PO files </>`_ which are textual,
+editable files.
+
+To update translation files to match current source code, one must
+run::
+
+  $ rm -rf builddir
+  $ meson setup builddir .
+  $ meson compile -C builddir io.github.orontee.Argos-update-po
+
+💡 A oneliner is available: ``poetry run
+./scripts/update-translations``.
+
+Credits
+=======
+
+The list of contributors to translations is extracted from the Weblate
+project. It doesn't reflect the heavy contributions made by Heimen
+Stoffels <[email protected]>, André Dokis
+<[email protected]> and JonyIvy <[email protected]>.