Building AMC from mercurial repository

This how to assumes a debian/ubuntu system and has been tested on all stable versions of Ubuntu.

The steps to execute are:

1) Install mercurial

$ sudo apt-get install mercurial

2) Clone the repository¶

$ hg clone https://bitbucket.org/auto-multiple-choice/auto-multiple-choice

3) Build¶

$ cd auto-multiple-choice
$ make deb

This might show some unfulfilled dependencies and therefore might fail.
The dependencies may include libnetpbm10-dev libcv-dev libhighgui-dev dblatex docbook-xsl librsvg2-bin libxml-libxml-perl g++

4) Install dependencies¶

$ sudo apt-get install libnetpbm10-dev libcv-dev libhighgui-dev dblatex docbook-xsl librsvg2-bin libxml-libxml-perl g++
$ make deb

This should produce four .deb package in the /tmp directory, which can be checked.
The package will be named:

• auto-multiple-choice_x.y.z.u-v_w.deb
• auto-multiple-choice-common_x.y.z.u-v_all.deb
• auto-multiple-choice-doc_x.y.z.u-v_all.deb
• auto-multiple-choice-doc-pdf_x.y.z.u-v_all.deb,
  where x, y, z, u, v and w depend on your processor architecture and the revision at the moment of your checkout.

5) Install AMC¶

1. First install the platform independent files
   

   $ sudo dpkg -i /tmp/auto-multiple-choice-common_x.y.z.u-v_all.deb
   

2. Then install the documentation
   

   $ sudo dpkg -i /tmp/auto-multiple-choice-doc_x.y.z.u-v_all.deb
   $ sudo dpkg -i /tmp/auto-multiple-choice-doc-pdf_x.y.z.u-v_all.deb
   

3. Now install the platform dependent files
   

   $ sudo dpkg -i /tmp/auto-multiple-choice_x.y.z.u-v_w.deb
   

dpkg might complain that some dependencies are not fulfilled. You can install them using sudo apt-get install as above.
You should also consider installing the recommended packages (see the Recommends: line in source:debian/control) with apt-get, as dpkg does not tell you if they are missing!

6) Update AMC¶

If you want to stay on the bleeding edge, update the cloned repository and then rerun the package making and installation process.

$ cd .../auto-multiple-choice
$ hg pull
$ hg update
$ make deb