==================== 1 minute howto
-* REQUIREMENTS is to have python + django installed django
+* REQUIREMENTS is to have python + django (1.5.2) installed django
** should be straightforward
** see devel/django-install.txt in case of trouble
* edit myslice/config.py and enter the details of your manifold backend
* init django
-$ manage.py syncdb
+$ ./manage.py syncdb
+$ ./manage.py migrate
* gather static files
$ ./manage.py collectstatic (formerly, we used make static, which is deprecated)
-- or --
$ ./manage.py collectstatic --noinput
+* gather templates files
+ for now we still seem to rely on a make-based templates-collection process
+ that creates all-templates/
+$ make templates
+
* run a local server:
$ manage.py runserver 0.0.0.0:8000
-- or -- my advice:
========== automatically generated
-* all-static: (generated, no need to source-control)
- this is where 'make static' will gather all your static contents if you run a local server
- make has convenience targets to refresh this area
- $ make static
- $ make clean-static
+* static/: (generated by collectstatic, see above, do not source-control)
+ $ manage.py [ --noinput ] collectstatic
-* django-static
+* all-templates/
* myslice.sqlite3
this is where django stores its own stuff, as per settings.py
.. the recommended layout for the various files and pieces (py, html, js and css) with django is
IMHO really painful; we *SHOULD* use e.g.
- plugins/simplelist.py,
- plugins/templates/plugins.html,
- plugins/static/js/simplelist.js
- plugins/static/css/simplelist.css
+ plugins/quickfilter/quickfilter.py,
+ plugins/quickfilter/templates/quickfilter.html,
+ plugins/quickfilter/static/js/quickfilter.js
+ plugins/quickfilter/static/css/quickfilter.css
which I have tried doing for a while but I found myself just hopping around in the file tree all
day long, wasting cycles big time