diff --git a/docs/howto/static-files.txt b/docs/howto/static-files.txt index 77e07141e3..5657e24516 100644 --- a/docs/howto/static-files.txt +++ b/docs/howto/static-files.txt @@ -48,16 +48,24 @@ Here's the basic usage in a nutshell: See the documentation for the :setting:`STATICFILES_FINDERS` setting for details on how ``staticfiles`` finds your files. - 2. Make sure that ``django.contrib.staticfiles`` is in your + 2. Set the :setting:`STATIC_URL` setting to the URL you want to use + for pointing to your static files, e.g.:: + + STATIC_URL = '/static/' + + In projects freshly created with the :djadmin:`startproject` + management command this will be preset to ``'/static/'``. + + 3. Make sure that ``django.contrib.staticfiles`` is in your :setting:`INSTALLED_APPS`. For :ref:`local development`, if you are using :ref:`runserver` or adding :ref:`staticfiles_urlpatterns` to your URLconf, you're done! Your static files will automatically be served at the - default :setting:`STATIC_URL` of ``/static/``. + :setting:`STATIC_URL` you specified in step 2. - 3. You'll probably need to refer to these files in your templates. The + 4. You'll probably need to refer to these files in your templates. The easiest method is to use the included context processor which will allow template code like: @@ -70,24 +78,20 @@ Here's the basic usage in a nutshell: When you're ready to move out of local development and deploy your project: - 1. Set the :setting:`STATIC_URL` setting to the public URL for your static - files (in some cases, the default value of ``/static/`` may still be - fine). - - 2. Set the :setting:`STATIC_ROOT` setting to point to where you'd like your + 1. Set the :setting:`STATIC_ROOT` setting to point to where you'd like your static files collected to when you use the :djadmin:`collectstatic` management command. For example:: STATIC_ROOT = "/home/jacob/projects/mysite.com/sitestatic" - 3. Run the :djadmin:`collectstatic` management command:: + 2. Run the :djadmin:`collectstatic` management command:: ./manage.py collectstatic This'll churn through your static file storage and copy them into the directory given by :setting:`STATIC_ROOT`. - 4. Deploy those files by configuring your webserver of choice to serve the + 3. Deploy those files by configuring your webserver of choice to serve the files in :setting:`STATIC_ROOT` at :setting:`STATIC_URL`. :ref:`staticfiles-production` covers some common deployment strategies