Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Fixed some documentation and comments that were m…

…isleading about the purpose of STATIC_ROOT, and removed an unused import.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 76fb2bb0e246884ce6dc1a48d0db55e0673de8e0 1 parent 9a82eb6
@carljm carljm authored
16 django/conf/project_template/
@@ -52,21 +52,27 @@
# Examples: "", ""
-# Absolute path to the directory that holds static files.
+# Absolute path to the directory static files should be collected to.
+# Don't put anything in this directory yourself; store your static files
+# in apps' "static/" subdirectories and in STATICFILES_DIRS.
# Example: "/home/media/"
-# URL that handles the static files served from STATIC_ROOT.
+# URL prefix for static files.
# Example: ""
STATIC_URL = '/static/'
-# URL prefix for admin media -- CSS, JavaScript and images.
+# URL prefix for admin static files -- CSS, JavaScript and images.
# Make sure to use a trailing slash.
# Examples: "", "/static/admin/".
ADMIN_MEDIA_PREFIX = '/static/admin/'
-# A list of locations of additional static files
+# Additional locations of static files
+ # Put strings here, like "/home/html/static" or "C:/www/django/static".
+ # Always use forward slashes, even on Windows.
+ # Don't forget to use absolute paths, not relative paths.
+ )
# List of finder classes that know how to find static files in
# various locations.
1  django/contrib/staticfiles/
@@ -1,6 +1,5 @@
import os
from django.conf import settings
-from django.db import models
from django.core.exceptions import ImproperlyConfigured
from import default_storage, Storage, FileSystemStorage
from django.utils.datastructures import SortedDict
2  docs/ref/contrib/staticfiles.txt
@@ -26,8 +26,6 @@ Settings
.. note::
The following settings control the behavior of the staticfiles app.
- Configuring the global settings :setting:`STATIC_ROOT` and
- :setting:`STATIC_URL` is **required**.
24 docs/ref/settings.txt
@@ -1628,22 +1628,24 @@ STATIC_ROOT
Default: ``''`` (Empty string)
-The absolute path to the directory that contains static files.
+The absolute path to the directory where :djadmin:`collectstatic` will collect
+static files for deployment.
Example: ``"/home/"``
If the :doc:`staticfiles</ref/contrib/staticfiles>` contrib app is enabled
-(default) this will be used as the directory which the
-:djadmin:`collectstatic` management command collects static files in. See
-the howto on :doc:`managing static files</howto/static-files>` for more
-details about usage.
-.. warning:: This is not a place to store your static files permanently;
- you should do that in directories that will be found by
- :doc:`staticfiles</ref/contrib/staticfiles>`'s
+(default) the :djadmin:`collectstatic` management command will collect static
+files into this directory. See the howto on :doc:`managing static
+files</howto/static-files>` for more details about usage.
+.. warning:: This should be an (initially empty) destination directory for
+ collecting your static files from their permanent locations into one
+ directory for ease of deployment; it is **not** a place to store your
+ static files permanently. You should do that in directories that will be
+ found by :doc:`staticfiles</ref/contrib/staticfiles>`'s
:setting:`finders<STATICFILES_FINDERS>`, which by default, are
- ``'static'`` app sub directories and any directories you include in
- the :setting:`STATICFILES_DIRS`).
+ ``'static/'`` app sub-directories and any directories you include in
+ :setting:`STATICFILES_DIRS`).
See :doc:`staticfiles reference</ref/contrib/staticfiles>` and
Please sign in to comment.
Something went wrong with that request. Please try again.