Opened 8 years ago

Closed 7 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:

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 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 7 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