Obsolete
Version 27 (Joël Brogniart, 12/07/2017 10:41 am) → Version 28/29 (Joël Brogniart, 12/07/2017 10:41 am)
h1. Installation de la version de développement développement d'AMC sous macOS
_Cette installation - AMC version 1.3.0, révision commit:f540cd2af512 révision commit:8dc721d86584 du 12/10/2017 17/7/2017 - a été testée sous :_ été testée sous :_
* _macOS 10.13 10.12.5 (MacPorts 2.4.2, 2.4.1, Xcode 9)._ 8.3.1)._
Le logiciel Auto Multiple Choice (AMC) est un logiciel de gestion de questionnaires. Il permet, à à partir de la définition définition des questions (question à à choix unique/question à à choix multiple, bonnes/mauvaises réponses…) réponsesâ¦) de générer générer des feuilles de questionnaires. Une fois ces questionnaires remplis et numérisés, 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 précédentes de cette note, le code source de tous les fichiers nécessaires étaient affiché. nécessaires étaient affiché. Comme ces sources sont fournis dans l'archive associée 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 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 bénéfier des améliorations apportées à améliorations apportées à Auto Multiple Choice au cours de son développement, développement, il est aussi possible d'installer AMC à à partir du code source.
L'installation décrite décrite ici est assez technique. Elle nécessite nécessite quelques connaissances sur les outils Unix, l'utilisation de lignes de commandes, une compréhension compréhension de l'architecture des ports "MacPorts":http://www.macports.org, une petite compréhension compréhension des dépendances dépendances entre différents différents outils (Subversion, MacPorts, PERL, X11, ports…) 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 à destinée à tout le monde.
Pour cette installation il va falloir créer créer un dépot dépot local MacPort. Dans ce dépot, dépot, sera mis le fichier de description de port pour AMC et éventuellement éventuellement les fichiers de ports complémentaires. complémentaires. Une fois ces fichiers de port installés, installés, l'installation d'AMC pourra être lancée. être lancée.
h2. Prérequis Prérequis
Les prérequis prérequis sont identiques à à ceux de l'installation de la version stable d'AMC. Pour fonctionner avec son interface, AMC nécessite nécessite un environnement graphique X Window System ou X11, la police de caractères caractères Linux Libertine, la famille de polices de caractères caractères DejaVu et le système système d'installation MacPorts.
h3. 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 télécharger l'application sur le site "XQuartz":http://xquartz.macosforge.org.
h3. 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'hébreu, l'alphabet phonétique phonétique international (et d'autres). Il faut télécharger télécharger le paquet "OTF" sur le site "LinuxLibertine.org":http://www.linuxlibertine.org.
Attention : La version actuelle de XQuartz (2.7.11) ne reconnait pas les polices installées installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant déplaçant dans le dossier "@/Library/Fonts@".
h3. La famille de polices DejaVu
Ces polices sont utilisées utilisées pour la génération génération des documentations en japonais. Il faut télécharger télécharger la dernière dernière version sur le site "dejavu-fonts.org":http://dejavu-fonts.org/wiki/Download.
Attention : La version actuelle de XQuartz (2.7.11) ne reconnait pas les polices installées installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant déplaçant dans le dossier "@/Library/Fonts@".
h3. MacPorts
MacPorts est un système système qui permet de compiler, installer et gérer gérer des logiciels source libre. Il faut télécharger télécharger le paquet d'installation macOS 10.10 Yosemite 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 système MacPorts. Il indique quels sont les outils nécessaires à 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 décrivant l'installation d'AMC à à partir du code source du programme. Il va donc falloir créer créer le fichier de port pour la version de développement développement d'AMC.
Pour éviter éviter les conflits avec les ports déjà décrits déjà décrits de MacPorts, les nouveaux fichiers de ports seront installés installés dans le dossier de l'utilisateur qui fait l'installation, au lieu d'être installés d'être installés dans les dossiers directements gérés gérés par MacPorts.
h3. Dépot Dépot local MacPorts
Pour que MacPorts puisse utiliser un dossier local, il faut créer créer ce dossier local.
<pre>mkdir -p ~/nix</pre>
Il faut ensuite indiquer à à MacPorts de prendre en compte le dossier local et ceci, avant la prise en compte de la hiérarchie hiérarchie standard de MacPorts. Pour cela il faut éditer é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 dépot MacPorts.
<pre>file:///Users/julesvernes/nix/macports
rsync://rsync.macports.org/release/tarballs/ports.tar [default]</pre>
h3. Fichiers de ports
Une 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 contenant le fichier 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 port décrit ici est disponible au téléchargement : attachment:macports.zip. macOS.
Téléchargez Téléchargez et décompressez décompressez cette archive puis déplacer déplacer le dossier "@macports@" à l'intérieur à l'intérieur du dossier créé précédemment. créé précédemment.
Les ports sont regroupés regroupés par catégories catégories et l'organisation des fichiers de port reflète reflète ce groupement. Chaque port fait partie d'une catégorie catégorie principale et dispose de son propre dossier. La catégorie catégorie principale de AMC dans MacPorts est X11, aussi le dossier du port pour AMC se trouvera à l'intérieur à l'intérieur d'un dossier x11.
!port-hierarchy.png!
Chacun des dossiers de port doit contenir un document nommé nommé @Portfile@. Ce document est un document texte contenant une description permettant l'installation par MacPorts d'AMC.
h4. Extrait du fichier @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
PortSystem 1.0
PortGroup bitbucket 1.0
PortGroup perl5 1.0
PortGroup texlive 1.0
set bitbucket_commit "f540cd2af512" "8dc721d86584"
set amc_revision "2104" "2075"
#2104:f540cd2af512 #2075:8dc721d86584
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://www.auto-multiple-choice.net/
conflicts auto-multiple-choice
checksums rmd160 9fa96fd9133c957c7fa618ffcee37e835c0d0e92 90cebf01f59dcba945d5de6d97593f80f8664743 \
sha256 533e3904d0091777825acdfbf2ad5da0281bd59208f1a6fb3af5ebe7abd9d4f2 95f74839c81945c455e9e02e524350fd081e075355feaaf2923063f69f35f1d3
depends_build-append \
port:dblatex \
port:p${perl5.major}-xml-libxml
</pre>
h2. Installation de AMC
Une fois le fichier de port mis en place, il faut générer générer l'index du nouveau port.
<pre>cd ~/nix/macports
portindex</pre>
*Attention* : les versions standard et développement développement d'AMC ne peuvent être installées simultanément. être installées simultanément. Si une version standard était précédemment installée, était précédemment installée, il faut la désinstaller désinstaller avant l'installation de la version de développement. développement.
<pre>sudo port uninstall auto-multiple-choice</pre>
Et enfin l'installation d'AMC.
<pre>sudo port install auto-multiple-choice-devel</pre>
L'installation peut prendre un bon moment. Une fois l'installation terminée, terminée, AMC est prêt à être utilisé. 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</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…@. Personnaliserâ¦@.
!xquartz-menu-applications-personnaliser.png!
Dans la fenêtre fenêtre de personnalisation, cliquer le bouton @Ajouter un élément@. é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 fenêtre de personnalisation puis choisir le menu @Applications > Auto Multiple Choice@.
!xquartz-menu-applications-amc.png!
La fenêtre fenêtre de AMC doit apparaître. apparaître.
!auto-multiple-choice-window.png!
Auto-multiple-choice est maintenant prêt à prêt à l'emploi.
h2. Liens
* Auto Multiple Choice, "http://www.auto-multiple-choice.net":http://www.auto-multiple-choice.net.
* Auto Multiple Choice, "Installation sous macOS (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>.
_Cette installation - AMC version 1.3.0, révision commit:f540cd2af512 révision commit:8dc721d86584 du 12/10/2017 17/7/2017 - a été testée sous :_ été testée sous :_
* _macOS 10.13 10.12.5 (MacPorts 2.4.2, 2.4.1, Xcode 9)._ 8.3.1)._
Le logiciel Auto Multiple Choice (AMC) est un logiciel de gestion de questionnaires. Il permet, à à partir de la définition définition des questions (question à à choix unique/question à à choix multiple, bonnes/mauvaises réponses…) réponsesâ¦) de générer générer des feuilles de questionnaires. Une fois ces questionnaires remplis et numérisés, 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 précédentes de cette note, le code source de tous les fichiers nécessaires étaient affiché. nécessaires étaient affiché. Comme ces sources sont fournis dans l'archive associée 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 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 bénéfier des améliorations apportées à améliorations apportées à Auto Multiple Choice au cours de son développement, développement, il est aussi possible d'installer AMC à à partir du code source.
L'installation décrite décrite ici est assez technique. Elle nécessite nécessite quelques connaissances sur les outils Unix, l'utilisation de lignes de commandes, une compréhension compréhension de l'architecture des ports "MacPorts":http://www.macports.org, une petite compréhension compréhension des dépendances dépendances entre différents différents outils (Subversion, MacPorts, PERL, X11, ports…) 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 à destinée à tout le monde.
Pour cette installation il va falloir créer créer un dépot dépot local MacPort. Dans ce dépot, dépot, sera mis le fichier de description de port pour AMC et éventuellement éventuellement les fichiers de ports complémentaires. complémentaires. Une fois ces fichiers de port installés, installés, l'installation d'AMC pourra être lancée. être lancée.
h2. Prérequis Prérequis
Les prérequis prérequis sont identiques à à ceux de l'installation de la version stable d'AMC. Pour fonctionner avec son interface, AMC nécessite nécessite un environnement graphique X Window System ou X11, la police de caractères caractères Linux Libertine, la famille de polices de caractères caractères DejaVu et le système système d'installation MacPorts.
h3. 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 télécharger l'application sur le site "XQuartz":http://xquartz.macosforge.org.
h3. 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'hébreu, l'alphabet phonétique phonétique international (et d'autres). Il faut télécharger télécharger le paquet "OTF" sur le site "LinuxLibertine.org":http://www.linuxlibertine.org.
Attention : La version actuelle de XQuartz (2.7.11) ne reconnait pas les polices installées installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant déplaçant dans le dossier "@/Library/Fonts@".
h3. La famille de polices DejaVu
Ces polices sont utilisées utilisées pour la génération génération des documentations en japonais. Il faut télécharger télécharger la dernière dernière version sur le site "dejavu-fonts.org":http://dejavu-fonts.org/wiki/Download.
Attention : La version actuelle de XQuartz (2.7.11) ne reconnait pas les polices installées installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant déplaçant dans le dossier "@/Library/Fonts@".
h3. MacPorts
MacPorts est un système système qui permet de compiler, installer et gérer gérer des logiciels source libre. Il faut télécharger télécharger le paquet d'installation macOS 10.10 Yosemite 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 système MacPorts. Il indique quels sont les outils nécessaires à 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 décrivant l'installation d'AMC à à partir du code source du programme. Il va donc falloir créer créer le fichier de port pour la version de développement développement d'AMC.
Pour éviter éviter les conflits avec les ports déjà décrits déjà décrits de MacPorts, les nouveaux fichiers de ports seront installés installés dans le dossier de l'utilisateur qui fait l'installation, au lieu d'être installés d'être installés dans les dossiers directements gérés gérés par MacPorts.
h3. Dépot Dépot local MacPorts
Pour que MacPorts puisse utiliser un dossier local, il faut créer créer ce dossier local.
<pre>mkdir -p ~/nix</pre>
Il faut ensuite indiquer à à MacPorts de prendre en compte le dossier local et ceci, avant la prise en compte de la hiérarchie hiérarchie standard de MacPorts. Pour cela il faut éditer é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 dépot MacPorts.
<pre>file:///Users/julesvernes/nix/macports
rsync://rsync.macports.org/release/tarballs/ports.tar [default]</pre>
h3. Fichiers de ports
Une 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 contenant le fichier 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 port décrit ici est disponible au téléchargement : attachment:macports.zip. macOS.
Téléchargez Téléchargez et décompressez décompressez cette archive puis déplacer déplacer le dossier "@macports@" à l'intérieur à l'intérieur du dossier créé précédemment. créé précédemment.
Les ports sont regroupés regroupés par catégories catégories et l'organisation des fichiers de port reflète reflète ce groupement. Chaque port fait partie d'une catégorie catégorie principale et dispose de son propre dossier. La catégorie catégorie principale de AMC dans MacPorts est X11, aussi le dossier du port pour AMC se trouvera à l'intérieur à l'intérieur d'un dossier x11.
!port-hierarchy.png!
Chacun des dossiers de port doit contenir un document nommé nommé @Portfile@. Ce document est un document texte contenant une description permettant l'installation par MacPorts d'AMC.
h4. Extrait du fichier @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
PortSystem 1.0
PortGroup bitbucket 1.0
PortGroup perl5 1.0
PortGroup texlive 1.0
set bitbucket_commit "f540cd2af512" "8dc721d86584"
set amc_revision "2104" "2075"
#2104:f540cd2af512 #2075:8dc721d86584
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://www.auto-multiple-choice.net/
conflicts auto-multiple-choice
checksums rmd160 9fa96fd9133c957c7fa618ffcee37e835c0d0e92 90cebf01f59dcba945d5de6d97593f80f8664743 \
sha256 533e3904d0091777825acdfbf2ad5da0281bd59208f1a6fb3af5ebe7abd9d4f2 95f74839c81945c455e9e02e524350fd081e075355feaaf2923063f69f35f1d3
depends_build-append \
port:dblatex \
port:p${perl5.major}-xml-libxml
</pre>
h2. Installation de AMC
Une fois le fichier de port mis en place, il faut générer générer l'index du nouveau port.
<pre>cd ~/nix/macports
portindex</pre>
*Attention* : les versions standard et développement développement d'AMC ne peuvent être installées simultanément. être installées simultanément. Si une version standard était précédemment installée, était précédemment installée, il faut la désinstaller désinstaller avant l'installation de la version de développement. développement.
<pre>sudo port uninstall auto-multiple-choice</pre>
Et enfin l'installation d'AMC.
<pre>sudo port install auto-multiple-choice-devel</pre>
L'installation peut prendre un bon moment. Une fois l'installation terminée, terminée, AMC est prêt à être utilisé. 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</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…@. Personnaliserâ¦@.
!xquartz-menu-applications-personnaliser.png!
Dans la fenêtre fenêtre de personnalisation, cliquer le bouton @Ajouter un élément@. é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 fenêtre de personnalisation puis choisir le menu @Applications > Auto Multiple Choice@.
!xquartz-menu-applications-amc.png!
La fenêtre fenêtre de AMC doit apparaître. apparaître.
!auto-multiple-choice-window.png!
Auto-multiple-choice est maintenant prêt à prêt à l'emploi.
h2. Liens
* Auto Multiple Choice, "http://www.auto-multiple-choice.net":http://www.auto-multiple-choice.net.
* Auto Multiple Choice, "Installation sous macOS (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>.