mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-07-20 01:29:11 +00:00
Code Issues 32 Releases Wiki Activity

[1.9.x] Fixed #25748 -- Added clarification on projects vs. applications.

Browse Source 
Thanks Thomas Güttler for motivating this addition.

Backport of e0519301238b43633bab64054772f9a62634a05f from master
This commit is contained in:
Tim Graham 2015-12-24 09:47:45 -05:00
parent 8202ce45a5
commit 406acd66e3
1 changed files with 15 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/ref/applications.txt
View File

@ -18,15 +18,19 @@ This registry is simply called :attr:`~django.apps.apps` and it's available in
Projects and applications Projects and applications
========================= =========================
Django has historically used the term **project** to describe an installation The term **project** describes a Django web application. The project Python
of Django. A project is defined primarily by a settings module. package is defined primarily by a settings module, but it usually contains
other things. For example, when you run ``django-admin startproject mysite``
you'll get a ``mysite`` project directory that contains a ``mysite`` Python
package with ``settings.py``, ``urls.py``, and ``wsgi.py``. The project package
is often extended to include things like fixtures, CSS, and templates which
aren't tied to a particular application.
The term **application** describes a Python package that provides some set of The term **application** describes a Python package that provides some set of
features. Applications may be reused in various projects. features. Applications :doc:`may be reused </intro/reusable-apps/>` in various
projects. A project's root directory (the one that contains ``manage.py``) is
.. note:: usually the container for all of a project's applications which aren't
This terminology is somewhat confusing these days as it became common to installed separately.
use the phrase "web app" to describe what equates to a Django project.
Applications include some combination of models, views, templates, template Applications include some combination of models, views, templates, template
tags, static files, URLs, middleware, etc. They're generally wired into tags, static files, URLs, middleware, etc. They're generally wired into
@ -41,6 +45,10 @@ interact with installed applications, mainly for configuration and also for
introspection. That's why the application registry maintains metadata in an introspection. That's why the application registry maintains metadata in an
:class:`~django.apps.AppConfig` instance for each installed application. :class:`~django.apps.AppConfig` instance for each installed application.
There's no restriction that a project package can't also be considered an
application and have models, etc. (which would require adding it to
:setting:`INSTALLED_APPS`).
.. _configuring-applications-ref: .. _configuring-applications-ref:
Configuring applications Configuring applications