« Previous -
Version 8/46
(diff) -
Next » -
Current version
Joël Brogniart, 03/23/2024 09:13 am
Installing AMC development version on OS X¶
This is a translation of the French entry wiki. First translation was done by Pieter Van den Hombergh.
(This installation - revision 1728 b36f9124e727 4/29/2015 - was tested with OS X 10.9.5, Xcode 6.1, MacPorts 2.3.3 and OS X 10.10.3, Xcode 6.3.2, MacPorts 2.3.3)
Auto Multiple Choice (AMC) is a software to manage questionnaires and multiple choice exams. It allows, from the definition of the multiple choice questions to generate sheets of questionnaires. The question types can be one only choice, multiple choices, question, right/wrong answers etc. Once the completed questionnaires are digitized, AMC automatically corrects the questionnaires. This software runs in a graphical environment X Window System on Linux and OS X. Linux is used as the develop environment, so it probably runs best there. Your mileage may vary.
It is possible to install the pre-compiled version 1.1.2 , but you would miss the newest developments happening in this active project. You can also install from the source, directly from the development repository. This will give you the bleeding edge version.
For the moment, this installation guide is quite technical and has only been tested on OS X 10.10.3 and 10.9.5 with the latest version of XCode. You will need MacPorts, a little understanding of the dependencies between different tools (Subversion, MacPorts, PERL, X11, port ...) and the OS X architecture. You should also have administrative rights on the computer. This manual is therefore unfortunately not for everyone.
For this installation you will create a local MacPort repository. In this repository you will add macports description for AMC. Once this file is installed, the installation of AMC can be started.
Prerequisites¶
The requirements are the same as the installation of version 1.1.2 AMC. To work with the interface, AMC requires the graphical environment X Window System and X11, font Linux Libertine characters and the MacPorts installation system.
OS X does not contain the standard X11 graphical environment. It is possible to fill this gap by installing XQuartz, an X Windows System environment running OS X. You can download the application on the XQuartz site. XQuartz.
MacPorts¶
MacPorts is a system to build, install and manage open source software. You need to download the OS X Yosemite installation package on the site MacPorts and install MacPorts.
Linux Libertine font¶
Linux Libertine font is a free font that covers code pages for Latin languagesââ, Greek, Cyrillic languagesââ, Hebrew, the International Phonetic Alphabet (and other). You need to download the package "OTF" on LinuxLibertine.org site. LinuxLibertine.org.
Caution : The current version of XQuartz (2.7.7) does not recognize the fonts installed in the user's folder. You must install the fonts by moving them in the "/Library/Fonts" folder.
MacPorts installation (port) files¶
The MacPorts port file contains information that allows a program to be installed into the MacPorts system. It shows what tools are needed for installation and operation of the program and how to install the program.
MacPorts contains many ports but it does not contain a port describing the AMC installation from the source code of the program. So we have to create the file port for the development version of AMC.
To avoid conflicts with ports already described in MacPorts, new ports will be installed in the folders of the user who installs, instead of being installed in folders directly managed by MacPorts.
Local MacPorts repository¶
For MacPorts to use a local folder, you must create that local folder.
mkdir -p ~/nix/macports
You should then tell MacPorts to take the local folder into account, before considering the standard hierarchy MacPorts. To do this you must edit the file "/opt/local/etc/macports/sources.conf" and add a URL to the local file before the URL of the repository rsync MacPorts.
file:///Users/julesvernes/nix/macports rsync://rsync.macports.org/release/tarballs/ports.tar [default]
Port Files¶
An archive containing the file port described here is available for download: attachment:macports.zip.
Ports are grouped into categories and file organization reflects this port group. Each port is part of a main category and has its own folder. The main category of AMC in MacPorts is X11, and so the AMC port folder will be located within a folder X11.
Here is a command to create the hierarchy.
cd ~/nix/macports mkdir -p x11/auto-multiple-choice-devel
This should produce:
Each directory must contain a port document named Portfile. This document is a text document containing a description for the MacPorts installation tool.
x11/auto-multiple-choice-devel/Portfile
# -*- coding: utf-8; mode: tcl; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- vim:fenc=utf-8:ft=tcl:et:sw=4:ts=4:sts=4
# $Id: Portfile 96038 2012-07-30 02:14:11Z dports@macports.org $
PortSystem 1.0
PortGroup bitbucket 1.0
set bitbucket_commit "b36f912"
set amc_revision "1728"
bitbucket.setup auto-multiple-choice auto-multiple-choice ${bitbucket_commit}
name auto-multiple-choice-devel
version 1.2.1.${amc_revision}
categories x11 tex education
platforms darwin
license GPL-2+
maintainers laposte.fr:joel.brogniart,openmaintainer
description Auto Multiple Choice - Multiple Choice Papers Management
long_description Utility to manage multiple choice questionnaires, \
with optionally mixed questions and answers. \
AMC provides automatic marking from papers' scans. \
Annotated papers are produced. Marks can be exported \
as an OpenOffice.org sheet file. \
\
This version can't print directly with CUPS. User should set \
"Printing method" to "file" or "command" in preferences. \
"file" method produce PDF files that could be printed from OS X.
homepage http://home.gna.org/auto-qcm
checksums rmd160 871847a2102c01401a0204e86968f0f43357209a \
sha256 521d6134fb5869bdf9d105c32be2884dd583d0da01e53f742447056c0e4b1b63
set amc_perl_version "5.16"
depends_build-append \
port:dblatex \
port:p${amc_perl_version}-xml-libxml
depends_lib port:opencv
depends_run \
port:gdk-pixbuf2 \
port:libnotify \
port:librsvg \
port:netpbm \
port:p${amc_perl_version}-archive-zip \
port:p${amc_perl_version}-dbd-sqlite \
port:p${amc_perl_version}-digest-md5 \
port:p${amc_perl_version}-email-mime \
port:p${amc_perl_version}-email-sender \
port:p${amc_perl_version}-file-basedir \
port:p${amc_perl_version}-file-mimeinfo \
port:p${amc_perl_version}-glib-object-introspection \
port:p${amc_perl_version}-gtk2 \
port:p${amc_perl_version}-locale-gettext \
port:p${amc_perl_version}-module-load-conditional \
port:p${amc_perl_version}-openoffice-oodoc \
port:p${amc_perl_version}-perlmagick \
port:p${amc_perl_version}-text-csv \
port:p${amc_perl_version}-xml-simple \
port:p${amc_perl_version}-xml-writer \
port:pdftk \
port:poppler \
port:sqlite3
use_configure no
use_parallel_build no
build.args AMCCONF=macports \
BASEPATH=${prefix} \
LATEX_FREE=1 \
GCC_PP="${configure.cc} ${configure.cc_archflags}"
# When building from source, some files should be configured before.
# This pre-configuration use the make tool, not the configure tool.
pre-build {
system -W ${worksrcpath} "${build.cmd} version_files AMCCONF=macports BASEPATH=${prefix}"
}
destroot.args AMCCONF=macports \
BASEPATH=${prefix}
variant latex description "Add LaTeX support" {
depends_run-append \
port:texlive-fonts-recommended \
port:texlive-lang-french \
port:texlive-latex-extra \
port:texlive-latex-recommended \
port:texlive-xetex
build.args-delete LATEX_FREE=1
post-activate {
system "${prefix}/bin/mktexlsr 2>&1"
}
post-deactivate {
system "${prefix}/bin/mktexlsr 2>&1"
}
}
default_variants +latex
Installing AMC¶
Once the file port set up, generate the index of the new port.
cd ~/nix/macports portindex
Warning: standard and development of AMC versions can be installed simultaneously. If a standard version was previously installed, you must uninstall it before installing the development version.
sudo port uninstall auto-multiple-choice
Finally, installation of the development version of AMC can be launched.
sudo port install auto-multiple-choice-devel
The installation may take a while. When it is complete and if there is no error, AMC is ready to be used.
Using AMC¶
You can start from the terminal or from XQuartz.
In the Terminal¶
auto-multiple-choice
This command will launch XQuartz and AMC application.
In XQuartz¶
Start XQuartz application.
We can immediately set XQuartz to facilitate the launch of AMC. Open the Applications > Customize... menu.
In the Personalization window, click the button Add an entry.
Set "Auto Multiple Choice" in the Name column and "auto-multiple-choice" in the Command column of the new menu item.
Close the Customize window, then select the Applications > Auto Multiple Choice menu.
AMC window should appear.
Auto-multiple-choice is now ready to work.
Links¶
- Auto Multiple Choice, http://home.gna.org/auto-qcm/.
- Auto Multiple Choice, Installation sous OS X.
- MacPorts, http://www.macports.org.
- MacPorts, Local Portfile Repositories.
- MacPorts, How to create portfiles for CPAN Perl modules.
- XQuartz, http://xquartz.macosforge.org</a>.
