Update tools and docs on translations

gpodder · Sep 12, 2019 · 0ddf842 · 0ddf842
1 parent 44faaf4
commit 0ddf842
Show file tree

Hide file tree

Showing 4 changed files with 36 additions and 1 deletion.
diff --git a/.tx/config b/.tx/config
@@ -1,7 +1,7 @@
 [main]
 host = https://transifex.com
 
-[mygpo.website-api]
+[gpoddernet.gpoddernet]
 file_filter = mygpo/locale/<lang>/LC_MESSAGES/django.po
 source_file = mygpo/locale/en/LC_MESSAGES/django.po
 source_lang = en

diff --git a/doc/dev/index.rst b/doc/dev/index.rst
@@ -31,3 +31,4 @@ Contents
     libraries
     configuration
     jupyter-notebook
+    translate
diff --git a/doc/dev/translate.rst b/doc/dev/translate.rst
@@ -0,0 +1,31 @@
+Translations
+============
+
+Translations for gpodder.net are managed on Transifex, in the
+`gpodder.net project <https://www.transifex.com/gpoddernet/>`_.
+
+
+
+Importing translations
+----------------------
+
+To import translations from transifex run the following
+
+.. code-block:: bash
+
+    tx pull -a
+    make update
+
+
+Upload new source strings
+-------------------------
+
+When changing the source code so that there are new internationalized strings
+that need to be translated run the following commands to upload these to
+Transifex.
+
+.. code-block:: bash
+
+    make update-po
+    tx push -s
+
diff --git a/makefile b/makefile
@@ -24,6 +24,9 @@ update-po:
 		--ignore=res/* --ignore=tools/* --ignore=mygpo/*/migrations/* \
 		--ignore=static/*
 
+compilemessages:
+	envdir envs/dev/ python manage.py compilemessages
+
 notebook:
 	envdir envs/dev/ python manage.py shell_plus --notebook