feat: Add gettext for JS translation

JS translations will not be shown fetched without directing (gettext) to the
correct javascript file

Refs: FC-0012 OEP-58

Makefile

@@ -1,8 +1,5 @@
 WORKING_DIR := recommender
-EXTRACT_DIR := $(WORKING_DIR)/conf/locale/en/LC_MESSAGES
-EXTRACTED_DJANGO_PARTIAL := $(EXTRACT_DIR)/django-partial.po
-EXTRACTED_DJANGOJS_PARTIAL := $(EXTRACT_DIR)/djangojs-partial.po
-EXTRACTED_DJANGO := $(EXTRACT_DIR)/django.po
+JS_TARGET := $(WORKING_DIR)/public/js/translations
 
 COMMON_CONSTRAINTS_TXT=requirements/common_constraints.txt
 .PHONY: $(COMMON_CONSTRAINTS_TXT)
@@ -22,12 +19,8 @@ upgrade: $(COMMON_CONSTRAINTS_TXT)  ## update the requirements/*.txt files with
 	pip-compile --upgrade -o requirements/ci.txt requirements/ci.in
 
 extract_translations: ## extract strings to be translated, outputting .po files
-	cd $(WORKING_DIR) && i18n_tool extract
-	mv $(EXTRACTED_DJANGO_PARTIAL) $(EXTRACTED_DJANGO)
-	# Safely concatenate djangojs if it exists
-	if test -f $(EXTRACTED_DJANGOJS_PARTIAL); then \
-	  msgcat $(EXTRACTED_DJANGO) $(EXTRACTED_DJANGOJS_PARTIAL) -o $(EXTRACTED_DJANGO) && \
-	  rm $(EXTRACTED_DJANGOJS_PARTIAL); \
-	fi
-	sed -i'' -e 's/nplurals=INTEGER/nplurals=2/' $(EXTRACTED_DJANGO)
-	sed -i'' -e 's/plural=EXPRESSION/plural=\(n != 1\)/' $(EXTRACTED_DJANGO)
+	cd $(WORKING_DIR) && i18n_tool extract --no-segment --merge-po-files
+
+compile_translations: ## compile translation files, outputting .mo files for each supported language
+	cd $(WORKING_DIR) && i18n_tool generate -v
+	python manage.py compilejsi18n --namespace RecommenderXBlockI18N --output $(JS_TARGET)

dev_settings.py

@@ -0,0 +1,92 @@
+"""
+Django settings for xblock-drag-and-drop-v2 project.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/1.11/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/1.11/ref/settings/
+"""
+
+# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
+from __future__ import absolute_import
+import os
+BASE_DIR = os.path.dirname(os.path.dirname(__file__))
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/1.11/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+# This is just a container for running tests, it's okay to allow it to be
+# defaulted here if not present in environment settings
+SECRET_KEY = os.environ.get('SECRET_KEY', '&=@m=qyqg#l!f99ouuuinpbsv0ah001unk@q^7)bkr^^n5@q1=')
+
+# SECURITY WARNING: don't run with debug turned on in production!
+# This is just a container for running tests
+DEBUG = True
+
+TEMPLATE_DEBUG = True
+
+ALLOWED_HOSTS = []
+
+
+# Application definition
+
+INSTALLED_APPS = (
+    'statici18n',
+    'recommender',
+)
+
+# Internationalization
+# https://docs.djangoproject.com/en/1.11/topics/i18n/
+
+LANGUAGE_CODE = 'en'
+
+TIME_ZONE = 'UTC'
+
+USE_I18N = True
+
+USE_L10N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/1.11/howto/static-files/
+
+STATIC_URL = '/static/'
+
+# statici18n
+# http://django-statici18n.readthedocs.io/en/latest/settings.html
+
+LANGUAGES = [
+    ('ar', 'Arabic'),
+    ('de', 'German'),
+    ('en', 'English - Source Language'),
+    ('eo', 'Esperanto'),
+    ('es_419', 'Spanish (Latin America)'),
+    ('fr', 'French'),
+    ('he', 'Hebrew'),
+    ('hi', 'Hindi'),
+    ('it', 'Italian'),
+    ('ja', 'Japanese'),
+    ('ko', 'Korean (Korea)'),
+    ('nl', 'Dutch'),
+    ('pl', 'Polski'),
+    ('pt_BR', 'Portuguese (Brazil)'),
+    ('pt_PT', 'Portuguese (Portugal)'),
+    ('ru', 'Russian'),
+    ('tr', 'Turkish'),
+    ('zh_CN', 'Chinese (China)'),
+]
+
+LOCALE_PATHS = [os.path.join(BASE_DIR, "locale")]
+
+STATICI18N_DOMAIN = 'text'
+STATICI18N_NAMESPACE = 'RecommenderXBlockI18N'
+STATICI18N_PACKAGES = (
+    'recommender',
+)
+STATICI18N_ROOT = 'recommender/public/js'
+STATICI18N_OUTPUT_DIR = 'translations'

manage.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python
+import os
+import sys
+from django.core.management import execute_from_command_line
+
+if __name__ == "__main__":
+    os.environ.setdefault(
+        "DJANGO_SETTINGS_MODULE",
+        "dev_settings"
+    )
+
+    execute_from_command_line(sys.argv)

recommender/__init__.py

@@ -2,6 +2,8 @@
 This XBlock will show a set of recommended resources which may be helpful to
 students solving a given problem.
 """
-from .recommender import RecommenderXBlock
+# We avoid importing RecommenderXBlock here, because it's importing Filesystem from xblock.reference.plugins
+# which is not loaded when running `manage.py` commands (which is used by `make compile_translations`)
+# from .recommender import RecommenderXBlock
 
 __version__ = '2.1.0'

recommender/conf/locale/config.yaml

@@ -2,3 +2,6 @@
 
 locales:
     - en  # English - Source Language
+
+ignore_dirs:
+    - public