Opened 8 years ago

Closed 8 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: UI/UX:


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 Changed 8 years ago by anonymous

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Summary changed from documentation should say /media is a reserved URL to documentation changes for serving static media

comment:2 Changed 8 years ago by Simon G. <dev@…>

  • Triage Stage changed from Unreviewed to Accepted

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

comment:3 Changed 8 years ago by ubernostrum

  • Resolution set to fixed
  • Status changed from new to closed

(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