Skip to main content

/<country>/<language>/ URL scheme, like Django's i18n_patterns.

Project description

Use case

Django’s [i18n_patterns][] prefixes URLs with a language code which may contain a variant e.g. /en, /fr, /fr-ca.

o18n_patterns is similar but it prefixes URLs with a country code and a language code e.g. /us, /ca/en, /ca/fr.

This is useful for websites that are mainly segmented by country rather than by language.

[i18n_patterns]: https://docs.djangoproject.com/en/stable/topics/i18n/translation/#django.conf.urls.i18n.i18n_patterns

Features

Some countries have a main language. In that case, the URL for the main language only contains the country e.g. /us. URLs for other languages contain the country and the language e.g. /us/es.

Some countries don’t have a main language — and it may be a sensitive topic! In that case, all URLs contain the country and the language e.g. /ca/en and /ca/fr.

Unlike i18_patterns, o18n_patterns doesn’t attempt to determine the country and language and automatically redirect the user to the appropriate URL.

If an URL doesn’t match a valid country and language combination, it doesn’t resolve with o18n_patterns and no country is activated. Vice-versa, if no country is active, reversing an URL raises an exception.

Project details


Release history Release notifications | RSS feed

This version

1.0

Download files

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

Source Distribution

django-o18n-1.0.tar.gz (9.8 kB view hashes)

Uploaded source

Built Distribution

django_o18n-1.0-py2.py3-none-any.whl (10.0 kB view hashes)

Uploaded 3 4

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