diff doc/developers.txt @ 7759:a46675399a05

fix: make running from code tree translate strings Have Roundup's i18n add working_directorylocale/locale to the list of places searched for translation .mo files. This means: LANG=de python3 roundup/scripts/roundup_admin.py -i ... will be translated to German. Also document setting up locale/locale using 'make -C locale local_install' in developer doc.
author John Rouillard <rouilj@ieee.org>
date Sat, 02 Mar 2024 00:47:19 -0500
parents 67438e439da8
children a9bac0cb4019
line wrap: on
line diff
--- a/doc/developers.txt	Fri Mar 01 16:22:15 2024 -0500
+++ b/doc/developers.txt	Sat Mar 02 00:47:19 2024 -0500
@@ -119,6 +119,20 @@
 the server using the ``sqlite`` backend. The code is in the
 ``roundup`` subdirectory.
 
+To test internationalization in your environment, you have to
+process the locale sub-directory into a form that roundup's
+i18n code will recognize. To do this use:
+
+  make -C locale local_install
+
+which will compile the ``.po`` source files into binary
+``.mo`` files and install them under
+``locale/locale/<LANGUAGE_CODE>/LC_MESSAGES/roundup.mo``. For
+German this will be
+``locale/locale/de/LC_MESSAGES/roundup.mo``.  You will need
+``msgfmt`` from the the GNU gettext tools to be installed on
+your system.
+
 Submitting Changes
 ------------------
 

Roundup Issue Tracker: http://roundup-tracker.org/