README

   1 The contents of this module:
   2
   3 ==================== 1st level subdirs
   4 * myslice:
   5   this is the sjango project', where to look for
   6   . settings
   7   . urls
   8   . common static files
   9
  10 * insert_above:
  11   a third-party django app for adding on-the-fly mentions to css or js files that need to go in the header
  12   much like our past drupal_set_html_head()
  13
  14 * auth:
  15   a django 'app' that deals with authentication
  16
  17 * slice:
  18   a django app for dealing with slice views
  19
  20 * devel:
  21   only for various notes and other utiliy scripts
  22
  23 * all-static: (generated, no need to source-control)
  24   this is where 'manage.py collectstatic' will gather all your static contents if you run a local server
  25   make has convenience targets to refresh this area
  26   $ make clean-static
  27   $ make static
  28 ==================== conventions
  29
  30 * templates:
  31   we store this under templates/ within the corresponding app, e.g.
  32   auth/templates/login.html
  33   for now this is only about html, but the engine can be used for rendering anything including json or whatever..
  34
  35 * static files:
  36   we chose to have all static files (images, but also javascript and stylesheets) in the various
  37   proj or app where they belong, under a static/ subdir that has this structure:
  38   where-it-belongs/
  39     static/
  40       img/
  41       css/
  42       js/
  43   the stuff I have so far is in myslice/ because it looks common to all apps..
  44
  45
  46