Opened 17 years ago

Closed 16 years ago

#4783 closed (fixed)

documentation changes for serving static media

Reported by: klok001@… Owned by: nobody
Component: Documentation Version: 0.96
Severity: Keywords: media static ADMIN_MEDIA_PREFIX
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

http://www.djangoproject.com/documentation/static_files/

In the above documentation it does not mention that for your own project you should choose a url different from ADMIN_MEDIA_PREFIX for serving static files.

Also based on the settings file and website http://www.djangoproject.com/documentation/settings/, it seemed that MEDIA_URL was related to serving static media. Perhaps changing the default comments in settings.py to better explain when MEDIA_URL is actually used, and even perhaps mentioning that static files need to be dealt with another way.

Also, ADMIN_MEDIA_PREFIX would be better explained as the "URL prefix for media in the admin project". As it stands in the settings and online documentation http://www.djangoproject.com/documentation/settings/, it is the "URL prefix for admin media". To me admin media sounds like media owned by the administrator, which could mean all media.

Finally, there are a few tricks to getting CSS files to work within a template (you might tell where I tripped up). Adding a simple explanation to the tutorial I think would save many people some time.

Thanks!

Change History (3)

comment:1 by anonymous, 17 years ago

Summary: documentation should say /media is a reserved URLdocumentation changes for serving static media

comment:2 by Simon G. <dev@…>, 17 years ago

Triage Stage: UnreviewedAccepted

Yes - please feel free to write up a first-take at this.

comment:3 by James Bennett, 16 years ago

Resolution: fixed
Status: newclosed

(In [7312]) Fixed #4783: Added a note that "admin media" means "media used by the admin app", and that ADMIN_MEDIA_PREFIX and MEDIA_URL should not be the same value.

Note: See TracTickets for help on using tickets.
Back to Top