Installation de la version de développement d'AMC sous macOS¶

Cette installation - AMC version 1.3.0, révision 1968:8a1ee4d93e39 du 28/11/2016 - a été testée sous :

• macOS 10.12.1 (Xcode 8.2, MacPorts 2.3.5).

Le logiciel Auto Multiple Choice (AMC) est un logiciel de gestion de questionnaires. Il permet, à partir de la définition des questions (question à choix unique/question à choix multiple, bonnes/mauvaises réponses…) de générer des feuilles de questionnaires. Une fois ces questionnaires remplis et numérisés, AMC permet de corriger automatiquement les questionnaires. Ce logiciel fonctionne dans un environnement graphique X Window System sous Linux et macOS.

Dans les versions précédentes de cette note, le code source de tous les fichiers nécessaires étaient affiché. Comme ces sources sont fournis dans l'archive associée et pour ne pas alourdir les instructions, les codes sources n'apparaissent plus dans la note.

Il est possible d'installer la dernière version stable d'AMC, mais pour pouvoir bénéfier des améliorations apportées à Auto Multiple Choice au cours de son développement, il est aussi possible d'installer AMC à partir du code source.

L'installation décrite ici est assez technique. Elle nécessite quelques connaissances sur les outils Unix, l'utilisation de lignes de commandes, une compréhension de l'architecture des ports MacPorts, une petite compréhension des dépendances entre différents outils (Subversion, MacPorts, PERL, X11, ports…) et de l'architecture macOS. Il faut aussi disposer des droits d'administration sur l'ordinateur. Elle n'est donc malheureusement pas destinée à tout le monde.

Pour cette installation il va falloir créer un dépot local MacPort. Dans ce dépot, sera mis le fichier de description de port pour AMC et éventuellement les fichiers de ports complémentaires. Une fois ces fichiers de port installés, l'installation d'AMC pourra être lancée.

Prérequis¶

Les prérequis sont identiques à ceux de l'installation de la version stable d'AMC. Pour fonctionner avec son interface, AMC nécessite un environnement graphique X Window System ou X11, la police de caractères Linux Libertine, la famille de polices de caractères DejaVu et le système d'installation MacPorts.

L'environnement X Window System¶

macOS ne contient pas en standard l'environnement graphique X11. Il est possible de combler cette lacune en installant XQuartz, un environnement X Windows System fonctionnant sous macOS. On peut télécharger l'application sur le site XQuartz.

La police Linux Libertine¶

La police Linux Libertine est une police libre qui couvre les pages de code pour les langues latines, le grec, les langues cyrilliques, l'hébreu, l'alphabet phonétique international (et d'autres). Il faut télécharger le paquet "OTF" sur le site LinuxLibertine.org.

Attention : La version actuelle de XQuartz (2.7.11) ne reconnait pas les polices installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant dans le dossier "/Library/Fonts".

La famille de polices DejaVu¶

Ces polices sont utilisées pour la génération des documentations en japonais. Il faut télécharger la dernière version sur le site dejavu-fonts.org.

Attention : La version actuelle de XQuartz (2.7.11) ne reconnait pas les polices installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant dans le dossier "/Library/Fonts".

MacPorts¶

MacPorts est un système qui permet de compiler, installer et gérer des logiciels source libre. Il faut télécharger le paquet d'installation macOS 10.10 Yosemite sur le site MacPorts et installer MacPorts.

MacPorts et les fichiers de port¶

Un fichier de port MacPorts contient les informations qui permettent d'installer un programme dans le système MacPorts. Il indique quels sont les outils nécessaires à l'installation et au fonctionnement du programme et comment faire pour installer le programme. MacPorts contient de nombreux ports, mais il ne contient pas de port décrivant l'installation d'AMC à partir du code source du programme. Il va donc falloir créer le fichier de port pour la version de développement d'AMC.

Pour éviter les conflits avec les ports déjà décrits de MacPorts, les nouveaux fichiers de ports seront installés dans le dossier de l'utilisateur qui fait l'installation, au lieu d'être installés dans les dossiers directements gérés par MacPorts.

Dépot local MacPorts¶

Pour que MacPorts puisse utiliser un dossier local, il faut créer ce dossier local.

mkdir -p ~/nix

Il faut ensuite indiquer à MacPorts de prendre en compte le dossier local et ceci, avant la prise en compte de la hiérarchie standard de MacPorts. Pour cela il faut éditer le fichier "/opt/local/etc/macports/sources.conf" et ajouter un URL pointant vers le dossier local avant l'URL rsync du dépot MacPorts.

file:///Users/julesvernes/nix/macports
rsync://rsync.macports.org/release/tarballs/ports.tar [default]

Fichiers de ports¶

Deux archives sont disponibles au téléchargement :

• pour l'installation sous macOS 10.9 et 10.10 attachment:macports-10.10.zip.
• pour l'installation sous macOS 10.11 et 10.12 attachment:macports-10.12.zip.

La première archive ne contient que la description du port AMC. L'archive pour macOS 10.11 et 10.12 comprend une adaptation des ports gcc5 et pdftk permettant leur fonctionnement sous ces versions de macOS.

Téléchargez et décompressez cette archive puis déplacer le dossier "macports" à l'intérieur du dossier créé précédemment.

Les ports sont regroupés par catégories et l'organisation des fichiers de port reflète ce groupement. Chaque port fait partie d'une catégorie principale et dispose de son propre dossier. La catégorie principale de AMC dans MacPorts est X11, aussi le dossier du port pour AMC se trouvera à l'intérieur d'un dossier x11.

Chacun des dossiers de port doit contenir un document nommé Portfile. Ce document est un document texte contenant une description permettant l'installation par MacPorts d'AMC.

Extrait du fichier 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$

PortSystem              1.0
PortGroup               bitbucket 1.0
PortGroup               perl5 1.0

set bitbucket_commit    "8a1ee4d93e39" 
set amc_revision        "1968" 
#1968:8a1ee4d93e39
bitbucket.setup         auto-multiple-choice auto-multiple-choice ${bitbucket_commit}
name                    auto-multiple-choice-devel
version                 1.3.${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.

homepage                http://home.gna.org/auto-qcm

checksums               rmd160  ee0cad1b92745f0bd4e8c13ade0cd867dd6e5558 \
                        sha256  12bdca73bc7b15253f5eabe61ac69131bb3f1bbd174a581ec1c2bec54d426dbe

depends_build-append    \
                        port:dblatex \
                        port:p${perl5.major}-xml-libxml

Installation de AMC¶

Une fois le fichier de port mis en place, il faut générer l'index du nouveau port.

cd ~/nix/macports
portindex

Attention : les versions standard et développement d'AMC ne peuvent être installées simultanément. Si une version standard était précédemment installée, il faut la désinstaller avant l'installation de la version de développement.

sudo port uninstall auto-multiple-choice

Enfin, l'installation de la version de développement d'AMC peut être lancée. AMC dépend de nombreux autres ports. Le calcul et la vérification de toutes les dépendances génère l'ouverture d'un grand nombre de fichiers ce qui peut provoquer l'échec de l'installation. Pour éviter cet échec, il vaut mieux procéder en plusieurs étapes. D'abord l'installation du port pdftk.

sudo port install pdftk

Puis l'installation du port pdflatex.

sudo port install pdflatex

Et enfin l'installation d'AMC.

sudo port install auto-multiple-choice-devel

AMC est prêt à être utilisé.

Utilisation de AMC¶

Vous pouvez lancer AMC à partir du terminal ou à partir de XQuartz.

Dans Terminal¶

auto-multiple-choice

Cette commande lancera l'application XQuartz puis AMC.

Dans XQuartz¶

Lancer l'application XQuartz.

On peut tout de suite configurer XQuartz pour faciliter le lancement de AMC. Ouvrir le menu Applications > Personnaliser….

Dans la fenêtre de personnalisation, cliquer le bouton Ajouter un élément.

Mettre "Auto Multiple Choice" dans la colonne Nom et "auto-multiple-choice" dans la colonne Commande du nouvel item de menu.

Fermer la fenêtre de personnalisation puis choisir le menu Applications > Auto Multiple Choice.

La fenêtre de AMC doit apparaître.

Auto-multiple-choice est maintenant prêt à l'emploi.

Liens¶

• Auto Multiple Choice, http://home.gna.org/auto-qcm/.
• Auto Multiple Choice, Installation sous macOS.
• MacPorts, http://www.macports.org.
• MacPorts, Local Portfile Repositories.
• MacPorts, How to create portfiles for CPAN Perl modules.
• XQuartz, http://xquartz.macosforge.org</a>.