h1. Installation de la version de développement d'AMC sous OS X

_(Cette installation a été testée sous OS X 10.9.4, XCode 5.1.1, MacPorts 2.3.1)_

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 OS X.

Il est possible d'installer la dernière "version stable d'AMC":http://project.auto-multiple-choice.net/projects/auto-multiple-choice/wiki/Installation_d'AMC_sous_OS_X, 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":http://www.macports.org, une petite compréhension des dépendances entre différents outils (Subversion, MacPorts, PERL, X11, ports…) et de l'architecture OS X. Il faut aussi disposer des droits d'administration sur l'ordinateur. Elle n'est donc malheureusement pas destinée à tout le monde. Il y a un petit soucis avec le module Net::CUPS et la version installée ne pourra pas imprimer avec ce module. Il faudra choisir une autre méthode d'impression.

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. Une fois le fichier de port installé, l'installation d'AMC pourra être lancée.

h2. 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 et le système d'installation MacPorts.

h3. L'environnement X Window System

OS X 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 OS X. On peut télécharger l'application sur le site "XQuartz":http://xquartz.macosforge.org.

h3. 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 OS X 10.9 Mavericks sur le site "MacPorts":http://www.macports.org et installer MacPorts.

h2. 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":http://www.macports.org/ports.php, 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.

h3. Dépot local MacPorts

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

<pre>mkdir -p ~/nix/macports</pre>

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.

<pre>file:///Users/julesvernes/nix/macports

rsync://rsync.macports.org/release/tarballs/ports.tar [default]</pre>

h3. Fichiers de ports

Une archive contenant le fichier de port décrit ici est disponible au téléchargement : attachment:macports.zip.

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.

Voici une commande permettant de créer cette hiérarchie.

<pre>cd ~/nix/macports

mkdir -p x11/auto-multiple-choice-devel</pre>

!port-hierarchy.png!

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.

h4. @x11/auto-multiple-choice-devel/Portfile@

<pre title="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

name                    auto-multiple-choice-devel

hg.tag                  b8c5a5c44d06

#                       révision 1551

version                 1.2.1.${hg.tag}

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

conflicts               auto-multiple-choice

depends_build-append    port:dblatex \

                        port:p5.16-xml-libxml

depends_lib             port:opencv

depends_run             port:gdk-pixbuf2 \

                        port:librsvg \

                        port:netpbm \

                        port:p5.16-archive-zip \

                        port:p5.16-dbd-sqlite \

                        port:p5.16-digest-md5 \

                        port:p5.16-email-mime \

                        port:p5.16-email-sender \

                        port:p5.16-file-basedir \

                        port:p5.16-file-mimeinfo \

                        port:p5.16-gtk2 \

                        port:p5.16-locale-gettext \

                        port:p5.16-module-load-conditional \

                        port:p5.16-openoffice-oodoc \

                        port:p5.16-perlmagick \

                        port:p5.16-text-csv \

                        port:p5.16-xml-simple \

                        port:p5.16-xml-writer \

                        port:poppler \

                        port:sqlite3

use_configure           no

fetch.type              hg

hg.url                  https://bitbucket.org/auto-multiple-choice/auto-multiple-choice

worksrcdir              trunk

build.args              AMCCONF=macports \

                        BASEPATH=${prefix} \

                        LATEX_FREE=1 \

                        GCC_PP="${configure.cc} ${configure.cc_archflags}"

build.args-delete       LATEX_FREE=1

# 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"

}

destroot.args           AMCCONF=macports \

                        BASEPATH=${prefix}

variant latex description "Add LaTeX support" {

  depends_run-append    port:texlive-fonts-extra \

                        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</pre>

h2. Installation de AMC

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

<pre>cd ~/nix/macports

portindex</pre>

*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.

<pre>sudo port uninstall auto-multiple-choice</pre>

Enfin, l'installation de la version de développement d'AMC peut être lancée.

<pre>sudo port install auto-multiple-choice-devel</pre>

AMC est prêt à être utilisé.

h2. Utilisation de AMC

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

h3. Dans Terminal

<pre>auto-multiple-choice-devel</pre>

Cette commande lancera l'application XQuartz puis AMC.

h3. Dans XQuartz

Lancer l'application XQuartz.

!xquartz.png!

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

!xquartz-menu-applications-personnaliser.png!

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

!xquartz-fenetre-personnaliser-menu-applications.png!

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

!xquartz-fenetre-personnaliser-menu-applications-2.png!

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

!xquartz-menu-applications-amc.png!

La fenêtre de AMC doit apparaître.

!auto-multiple-choice-window.png!

h2. Impression avec AMC

Normalement, AMC utilise le module Perl @Net::CUPS@ pour d'accéder aux fonctions d'impression. Ce module ne fonctionne plus avec les versions récentes d'OS X (> 10.7) et n'a pas été installé par les outils MacPorts. Il faut modifier les préférences pour la méthode d'impression à utiliser par AMC. Pour modifier la méthode ouvrir le menu @Édition > Préférences@.

!amc-preferences-general.png!

Faire défiler les informations de l'onglet @Général@ de la fenêtre des préférences pour accéder à la partie @Impression@. Dans le menu @Méthode d'impression@ choisir une méthode d'impression.

!amc-menu-print-method.png!

* @CUPS@ : ne pas choisir cette méthode sous OS X.

* @par une commande@ : cette méthode permet d'indiquer une commande que peut utiliser AMC pour imprimer un fichier. La commande fournie par défaut @lpr %f@ permet d'imprimer avec l'imprimante et les réglages sélectionnés par défaut.

* @dans des fichiers@ : avec cette méthode, AMC générera un ou plusieurs fichiers PDF qu'il sera possible d'imprimer à partir d'OS X. Dans ce dernier cas il est possible de profiter des options spécifiques aux imprimantes au moment de l'impression : recto-verso, aggrafage…

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

h2. Liens

* Auto Multiple Choice, "http://home.gna.org/auto-qcm/":http://home.gna.org/auto-qcm/.

* Auto Multiple Choice, "Installation sous OS X (10.8)":http://project.auto-multiple-choice.net/projects/auto-multiple-choice/wiki/Installation_d'AMC_sous_OS_X_Mountain_Lion.

* MacPorts, "http://www.macports.org":http://www.macports.org.

* MacPorts, "Local Portfile Repositories":http://guide.macports.org/#development.local-repositories.

* MacPorts, "How to create portfiles for CPAN Perl modules":https://trac.macports.org/wiki/howto/cpan2port.

* XQuartz, http://xquartz.macosforge.org</a>.