Skip to main content

A Django app that provides helper for generating Javascript catalog to static files.

Project description

A Django app that provides helper for generating Javascript catalog to static files.

When dealing with internationalization in Javascript code, Django provides the javascript_catalog view which sends out a JavaScript code library with functions that mimic the gettext interface, plus an array of translation strings.

At first glance, it works well and everything is fine. But, because javascript_catalog view is generating Javascript catalog dynamically on each request, it’s adding an overhead that can be an issue with site growth.

That’s what statici18n is for:

Collecting Javascript catalogs from each of your Django apps (and any other place you specify) into a single location that can easily be served in production.

The main website for django-staticfiles is github.com/zyegfryed/django-statici18n where you can also file tickets.

Installation

  • Use your favorite Python packaging tool to install statici18n from PyPI, e.g.:

    pip install django-statici18n
  • Add 'statici18n' to your INSTALLED_APPS setting:

    INSTALLED_APPS = [
        # ...
        'statici18n',
    ]
  • Once you have translated and compiled your messages, use the compilejsi18n management command:

    python manage.py compilejsi18n

By default, the generated catalogs are stored to static/jsi18n.

(Optionnal)

The following steps assumes you’re using either django.contrib.staticfiles or django-statcifles.

  • Add the django.core.context_processors.i18n context processor to your TEMPLATE_CONTEXT_PROCESSORS setting - already set by Django by default:

    TEMPLATE_CONTEXT_PROCESSORS = (
      # ...
      'django.core.context_processors.i18n',
    )
  • Edit your templates and replace the dynamically generated script by the statically generated script like this:

    <script src="{{ STATIC_URL }}jsi18n/{{ LANGUAGE_CODE }}/djangojs.js"></script>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-statici18n-0.4.1.tar.gz (438.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page