Opened 17 years ago
Closed 17 years ago
#4783 closed (fixed)
documentation changes for serving static media
Reported by: | 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 , 17 years ago
Summary: | documentation should say /media is a reserved URL → documentation changes for serving static media |
---|
comment:2 by , 17 years ago
Triage Stage: | Unreviewed → Accepted |
---|
comment:3 by , 17 years ago
Resolution: | → fixed |
---|---|
Status: | new → closed |
Yes - please feel free to write up a first-take at this.