Hot-keys on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
1"""
2Abstract
3--------
5Web sites and Web applications may need to deal with language in a variety of ways:
7- Content negotiation for the `Accept Language header`_.
8- Manual selection of an available language.
9- Translation of site or application content.
11`Navigating this can be difficult`_. The generally accepted `approach to authoritative language codes`_ is using the
12`IANA Language Subtag Registry page`_. As this data is provided in record-jar format, SuperDjango sources this as JSON
13from `mattcg's repo`_ (specifically the ``registry.json`` and ``variant.json`` files) to generate choices and constants.
15.. _Accept Language header: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
16.. _approach to authoritative language codes: http://www.w3.org/International/techniques/server-setup#multiviews
17.. _IANA Language Subtag Registry page: http://www.iana.org/assignments/language-subtag-registry
18.. _mattcg's repo`: https://github.com/mattcg/language-subtag-registry
19.. _Navigating this can be difficult: https://stackoverflow.com/a/13899628/241720
21Install
22-------
24No special installation steps are required, but you are referred to the Django docs for setting up language detection:
26https://docs.djangoproject.com/en/stable/topics/i18n/translation/#how-django-discovers-language-preference
28"""
29__author__ = "Shawn Davis <shawn@superdjango.com>"
30__maintainer__ = "Shawn Davis <shawn@superdjango.com>"
31__version__ = "0.6.0-x"
33from .choices import *
34from .constants import *
35from .descriptors import *