X-Git-Url: http://git.indexdata.com/?p=mkws-moved-to-github.git;a=blobdiff_plain;f=notes%2Fdevelopers.txt;h=02fb7bd82fb152ded537e8d12dd2f1a1edd1137e;hp=82729f2789144ae70b9ad1458b1fdc8a8c66062f;hb=0572b666db4e9d517ee481e18049262e6fe20e63;hpb=f621a60c49e853af775aee72fa8165c4da17aea3 diff --git a/notes/developers.txt b/notes/developers.txt index 82729f2..02fb7bd 100644 --- a/notes/developers.txt +++ b/notes/developers.txt @@ -4,6 +4,26 @@ These notes are collected by Heikki, mostly from skype chats with Wolfram and Mike. I collected them for my own use, but I hope they will turn out to be helpful to anyone who needs to get started with mkws. +Environment +----------- + +apt-get install yui-compressor +get nodejs, sudo make install, ln -s /usr/local/bin/npm ~/bin/npm if needed + +cd .../mkws; make check + + +Apache +------ +You need to set up a local apache. + * add 'mkws' in /etc/hosts to point to 127.0.0.2 + * symlinked .../mkws/tools/apache2/mkws-heikki to /etc/apache/sites-available + * a2ensite mkws-heikki + * a2enmod rewrite + * a2enmod headers + * service apache2 reload + * Check that your browser sees somethig in http://mkws/ and + http://mkws/jasmine-popup.html. If need be, enable javascript etc. Libraries --------- @@ -54,9 +74,18 @@ Most (all?) code work happens in mkws.js. Unit tests ---------- -if you want understand the test than you can look at mkws/test/spec/mkws-config.js +Tests are based on jasmine. a general description of jasmine is on +http://jasmine.github.io/1.3/introduction.html + +If you want understand the test than you can look at mkws/test/spec/mkws-config.js and mkws/test/spec/mkws-pazpar2.js . See also mkws/test/README.txt +The test scripts are included from the test page, for example +mkws/examples/htdocs/jasmine-popup.html has + + + + Structure of mkws.js --------------------