[Django] #20914: Improve documentation: order in INSTALLED_APPS matters for translations and templates

13 views
Skip to first unread message

Django

unread,
Aug 14, 2013, 5:26:16 AM8/14/13
to django-...@googlegroups.com
#20914: Improve documentation: order in INSTALLED_APPS matters for translations and
templates
----------------------------------+----------------------------
Reporter: stefano.crosta@… | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Keywords: INSTALLED_APPS
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
----------------------------------+----------------------------
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
[https://docs.djangoproject.com/en/dev/ref/templates/api/#django.template.loaders.app_directories.Loader
Templates Documentation] and
[https://docs.djangoproject.com/en/1.5/topics/i18n/translation/#how-
django-discovers-translations 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.

--
Ticket URL: <https://code.djangoproject.com/ticket/20914>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Aug 14, 2013, 10:27:25 AM8/14/13
to django-...@googlegroups.com
#20914: Improve documentation: order in INSTALLED_APPS matters for translations and
templates
----------------------------------+------------------------------------

Reporter: stefano.crosta@… | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: INSTALLED_APPS | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
----------------------------------+------------------------------------
Changes (by timo):

* needs_better_patch: => 0
* stage: Unreviewed => Accepted
* needs_tests: => 0
* needs_docs: => 0


--
Ticket URL: <https://code.djangoproject.com/ticket/20914#comment:1>

Django

unread,
Jan 1, 2014, 10:29:58 AM1/1/14
to django-...@googlegroups.com
#20914: Improve documentation: order in INSTALLED_APPS matters for translations and
templates
----------------------------------+------------------------------------

Reporter: stefano.crosta@… | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: INSTALLED_APPS | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
----------------------------------+------------------------------------

Comment (by aaugustin):

Related to #21018.

--
Ticket URL: <https://code.djangoproject.com/ticket/20914#comment:2>

Django

unread,
Jan 1, 2014, 12:13:48 PM1/1/14
to django-...@googlegroups.com
#20914: Improve documentation: order in INSTALLED_APPS matters for translations and
templates
----------------------------------+------------------------------------

Reporter: stefano.crosta@… | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: INSTALLED_APPS | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
----------------------------------+------------------------------------

Comment (by aaugustin):

See
https://github.com/django/django/commit/0ce945a67151acf2c58bc35a47f4c3d45ff30085
#diff-7432e7141e58a9eede9760904be4b14cR1319 — is it enough to consider
this ticket fixed?

--
Ticket URL: <https://code.djangoproject.com/ticket/20914#comment:3>

Django

unread,
Jan 1, 2014, 2:24:47 PM1/1/14
to django-...@googlegroups.com
#20914: Improve documentation: order in INSTALLED_APPS matters for translations and
templates
----------------------------------+------------------------------------
Reporter: stefano.crosta@… | Owner: nobody
Type: New feature | Status: closed
Component: Documentation | Version: master
Severity: Normal | Resolution: fixed

Keywords: INSTALLED_APPS | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
----------------------------------+------------------------------------
Changes (by timo):

* status: new => closed
* resolution: => fixed


Comment:

Looks good to me.

--
Ticket URL: <https://code.djangoproject.com/ticket/20914#comment:4>

Reply all
Reply to author
Forward
0 new messages