X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=README;h=2b129de620debcd64dde441b45167960d7d1519c;hb=69d4ef6baf273e93270de07261a32ccceee50464;hp=619473b85c148368612e170d2cff15c16a48b1dc;hpb=e5ff99987b62d202bc453cddb8e7dc4a218ac64f;p=myslice.git diff --git a/README b/README index 619473b8..2b129de6 100644 --- a/README +++ b/README @@ -6,7 +6,7 @@ See the devel/ subdir for more devel-oriented doc. ==================== 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 @@ -17,13 +17,19 @@ See the devel/ subdir for more devel-oriented doc. * 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: @@ -129,13 +135,10 @@ package is published) ========== 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 @@ -150,10 +153,10 @@ package is published) .. 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 @@ -236,11 +239,15 @@ $./manage.py migrate if it fails: -sqlite> DROP TABLE my_table [from your DB] - -then +1. go to myslice directory +2. do sqlite3 myslice.sqlite3 [if sqlite3: command not found, do $apt-get install sqlite3] +3. check the list of tables with sqlite> .tables +4. if you find those tables that was mentioned in the failure message while running $./manage.py migrate + do sqlite> DROP TABLE mentioned_table + [mentioned_table = the tables that was explicity mentioned in the failure message of $./manage.py migrate] +5. sqlite> .quit +6. $./manage.py migrate -$./manage.py migrate