Mimir is a new way to learn online.

Mimir uses Django, a nifty Python based web development framework. So to begin setting up Mimir first install Python.

Now we install Django, first grab the Django source

wget -O django.tar.gz https://www.djangoproject.com/download/1.5.1/tarball/

tar xzvf django.tar.gz

Now install

cd Django-1.5.1/

sudo python setup.py install

Now you can clone this repo and then change some settings. The settings that need changing are in mimir/settings_local.py.default, you should edit this to have the correct settings in, and then save a copy as settings_local.py, while leaving the original unchanged. At present we are using SQLite so the db info that needs changing is just the filename. The settings file should also be changed to include the correct templates (TEMPLATE_DIRS) and static files directory (STATICFILES_DIRS), this path should be absolute. Once that is correct we need to populate your database with mimirs tables, so run

python manage.py syncdb

We also need to install markdown for python, see the instructions there to do so, make sure you install the latest version!

Finally test it out with

python manage.py runserver

If you would like to run the tests on Mimir some set up is required. I will assume you have followed the guide above already.

First of all go to:

https://pypi.python.org/pypi/selenium

and download the Selenium package to run a dumby server for testing. Next install this by going to command line, finding the file you downloaded it to and running

python setup.py install

Next if you haven't already got google Chrome, get it and come into the future.

Now got to:

https://code.google.com/p/chromedriver/downloads/list

download the correct chromedriver for your computer. Here lots of different OS vary slight in the set up of this. If you're a windows guy, you need to put the chromedriver.exe in

\Scripts

if not, I am sorry bud your own your own, lots of advice about this on stack over flow.

To add urls to test whether they view or not as a registered or a unregistered user add the url extension as a new line to the file:

lessons/tests_unregistered - for unregistered user views lessons/tests_registered - for registered user views

So you now should be good to go on testing. There is a couple of test commands (from the Mimir directory), most basic is

python manage.py test

it will run all the tests we have written and alot of inbuilt ones in Django, for the specific ones we have written use

python manage.py test lessons.MySeleniumTests.TESTNAME

with TESTNAME replace by

test_views - to test that all the pages accessible load test_user - to test your able to register log out and in. test_lessons - to test lessons work (under development)

more to follow. Feel free to add to this list if you wish to.