Changes between Version 20 and Version 21 of DosAndDontsForApplicationWriters

Timestamp:

Aug 5, 2011, 7:10:41 AM (13 years ago)

Author:

Dan Poirier

Comment:

References to media appear to be meant to refer to static files. Correct that, and add links to current doc on using static files.

DosAndDontsForApplicationWriters

@@ -54 +54 @@
      (e.g., a {{{<style>}}} or {{{<link>}}}s)
    * {{{content}}}; the main content of the document
- * You should refer to media-files with a configurable prefix,
-   in the example a good setting would be {{{MNEMOSYNE_MEDIA_ROOT}}}.
+ * You should refer to static files relative to the setting STATIC_URL, per https://docs.djangoproject.com/en/1.3/howto/static-files/#referring-to-static-files-in-templates.
    For example:
    {{{
-<link rel='stylesheet' href='{{ MNEMOSYNE_MEDIA_ROOT }}/my.css' />
+<link rel='stylesheet' href='{{ STATIC_URL }}/my.css' />
    }}}
  * You should refer to pages in your application with either relative links,
@@ -73 +72 @@
    own views.
 
-== Media files ==
+== Static files ==
  
- * Your media-files should go into {{{mnemosyne/media/}}}.
-   ''Should that be ''{{{mnemosyne/media/mnemosyne/}}}''? It would mirror
-   the templates, and probably looks better in ''{{{Alias}}}''-directives
-   in Apache-configurations ;)''
+ * Your static files should go into {{{static}}} subdirectories of your app directories.  See https://docs.djangoproject.com/en/1.3/howto/static-files/#basic-usage. Or if they're not specific to one app, create a {{{static}}} directory at the top of your project, put them there, and add that directory to STATICFILES_DIRS.
 
 == Settings ==
@@ -135 +131 @@
       package_dir = {'': 'src'},
       package_data = {'ibofobi.apps.mnemosyne': ['templates/mnemosyne/*.html',
-                                                 'media/*',],},
+                                                 'static/*',],},
       # distutils complain about these, anyone know an easy way to silence it?
       namespace_packages = ['ibofobi.apps'],