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


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, it seemed that MEDIA_URL was related to serving static media. Perhaps changing the default comments in 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, 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.


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