Added 'Serving the admin files' section in docs/modpython.txt

git-svn-id: http://code.djangoproject.com/svn/django/trunk@1124 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2005-11-07 14:47:29 +00:00
parent 54c3367a63
commit c7b28cf7e6
1 changed files with 26 additions and 8 deletions

View File

@ -2,7 +2,7 @@
How to use Django with mod_python How to use Django with mod_python
================================= =================================
`Apache`_ with `mod_python`_ currently is the preferred setup for using Django Apache_ with `mod_python`_ currently is the preferred setup for using Django
on a production server. on a production server.
mod_python is similar to `mod_perl`_ : It embeds Python within Apache and loads mod_python is similar to `mod_perl`_ : It embeds Python within Apache and loads
@ -112,12 +112,11 @@ revoke your Django privileges.
Serving media files Serving media files
=================== ===================
Django doesn't serve media files itself. It'd be inefficient to flow media Django doesn't serve media files itself; it leaves that job to whichever Web
files through a (relatively) complex framework when much, much more well-tuned server you choose.
solutions are better.
We recommend using a separate Web server for serving media. Here are some good We recommend using a separate Web server -- i.e., one that's not also running
choices: Django -- for serving media. Here are some good choices:
* lighttpd_ * lighttpd_
* TUX_ * TUX_
@ -152,9 +151,28 @@ the ``media`` subdirectory and any URL that ends with ``.jpg``, ``.gif`` or
SetHandler None SetHandler None
</Location> </Location>
Note that the Django development server automagically serves admin media files,
but this is not the case when you use any other server arrangement.
.. _lighttpd: http://www.lighttpd.net/ .. _lighttpd: http://www.lighttpd.net/
.. _TUX: http://en.wikipedia.org/wiki/TUX_web_server .. _TUX: http://en.wikipedia.org/wiki/TUX_web_server
.. _Apache: http://httpd.apache.org/ .. _Apache: http://httpd.apache.org/
Serving the admin files
=======================
Note that the Django development server automagically serves admin media files,
but this is not the case when you use any other server arrangement. You're
responsible for setting up Apache, or whichever media server you're using, to
serve the admin files.
The admin files live in (``django/contrib/admin/media``) of the Django
distribution.
Here are two recommended approaches:
1. Create a symbolic link to the admin media files from within your
document root. This way, all of your Django-related files -- code
**and** templates -- stay in one place, and you'll still be able to
``svn update`` your code to get the latest admin templates, if they
change.
2. Or, copy the admin media files so that they live within your document
root.