Opened 11 years ago
Closed 11 years ago
#20914 closed New feature (fixed)
Improve documentation: order in INSTALLED_APPS matters for translations and templates
Reported by: | Owned by: | nobody | |
---|---|---|---|
Component: | Documentation | Version: | dev |
Severity: | Normal | Keywords: | INSTALLED_APPS |
Cc: | stefano.crosta@… | Triage Stage: | Accepted |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
The order of applications in INSTALLED_APPS matters for priority/overriding of at least:
- templates: https://docs.djangoproject.com/en/dev/ref/templates/api/#django.template.loaders.app_directories.Loader
- translations: https://docs.djangoproject.com/en/1.5/topics/i18n/translation/#how-django-discovers-translations
Mailing list discussion: https://groups.google.com/forum/#!topic/django-developers/r37clRaXgf4
My proposal is to add a box in https://docs.djangoproject.com/en/dev/ref/settings/#installed-apps saying something like:
The order of INSTALLED_APPS is significant! Translations and Templates in Django can be overridden; the first app found will have priority. Please also see Templates Documentation and Translations Documentation
An alternative method is to use https://pypi.python.org/pypi/django-apptemplates/ that allows to override (and inherit) the template of a specific app.
Change History (4)
comment:1 by , 11 years ago
Triage Stage: | Unreviewed → Accepted |
---|
comment:2 by , 11 years ago
comment:3 by , 11 years ago
See https://github.com/django/django/commit/0ce945a67151acf2c58bc35a47f4c3d45ff30085#diff-7432e7141e58a9eede9760904be4b14cR1319 — is it enough to consider this ticket fixed?
Related to #21018.