Obsolete

Version 22 (Joël Brogniart, 12/07/2017 10:41 am)

1 22 Joël Brogniart
h1. Installation de la version de développement d'AMC sous macOS
2 1
3 22 Joël Brogniart
_Cette installation - AMC version 1.3.0, révision 1966 d6719412b9a3 du 21/11/2016 - a été testée sous :_
4 22 Joël Brogniart
* _macOS 10.12.1 (Xcode 8.2, MacPorts 2.3.5),_
5 22 Joël Brogniart
* _macOS 10.10.5 (Xcode 7.2.1, MacPorts 2.3.5),_
6 22 Joël Brogniart
* _macOS 10.9.5 (Xcode 6.2, MacPorts 2.3.5)._
7 7 Joël Brogniart
8 22 Joël Brogniart
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.
9 1
10 19 Joël Brogniart
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.
11 19 Joël Brogniart
12 13 Joël Brogniart
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.
13 15 Joël Brogniart
14 22 Joël Brogniart
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 macOS. Il faut aussi disposer des droits d'administration sur l'ordinateur. Elle n'est donc malheureusement pas destinée à tout le monde.
15 1
16 19 Joël Brogniart
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.
17 1
18 1
h2. Prérequis
19 1
20 19 Joël Brogniart
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.
21 1
22 1
h3. L'environnement X Window System
23 1
24 22 Joël Brogniart
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":http://xquartz.macosforge.org.
25 16 Joël Brogniart
26 1
h3. La police Linux Libertine
27 16 Joël Brogniart
28 1
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":http://www.linuxlibertine.org.
29 1
30 22 Joël Brogniart
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@".
31 1
32 19 Joël Brogniart
h3. La famille de polices DejaVu
33 19 Joël Brogniart
34 19 Joël Brogniart
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":http://dejavu-fonts.org/wiki/Download.
35 19 Joël Brogniart
36 22 Joël Brogniart
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@".
37 19 Joël Brogniart
38 1
h3. MacPorts
39 1
40 22 Joël Brogniart
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":http://www.macports.org et installer MacPorts.
41 10 Joël Brogniart
42 1
h2. MacPorts et les fichiers de port
43 13 Joël Brogniart
44 1
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.
45 1
46 1
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.
47 1
48 1
h3. Dépot local MacPorts
49 1
50 1
Pour que MacPorts puisse utiliser un dossier local, il faut créer ce dossier local.
51 1
52 1
<pre>mkdir -p ~/nix</pre>
53 19 Joël Brogniart
54 1
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.
55 1
56 1
<pre>file:///Users/julesvernes/nix/macports
57 13 Joël Brogniart
rsync://rsync.macports.org/release/tarballs/ports.tar [default]</pre>
58 1
  
59 1
h3. Fichiers de ports
60 1
61 22 Joël Brogniart
Trois archives sont disponibles au téléchargement :
62 22 Joël Brogniart
* pour l'installation sous macOS 10.9 et 10.10 attachment:macports-10.10.zip.
63 22 Joël Brogniart
* pour l'installation sous macOS 10.11 attachment:macports-10.11.zip.
64 22 Joël Brogniart
* pour l'installation sous macOS 10.12 attachment:macports-10.12.zip.
65 1
66 22 Joël Brogniart
La première archive ne contient que la description du port AMC. L'archive pour macOS 10.11 comprend une adaptation des ports @gcc5@ et @pdftk@ permettant leur fonctionnement sous cette version de macOS. L'archive pour macOS 10.12 contient une adaptation du port @opencv@ en plus des adaptations des ports @gcc5@ et @pdftk@.
67 1
68 19 Joël Brogniart
Téléchargez et décompressez cette archive puis déplacer le dossier "@macports@" à l'intérieur du dossier créé précédemment.
69 1
70 1
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.
71 1
72 1
!port-hierarchy.png!
73 1
74 1
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.
75 19 Joël Brogniart
  
76 1
h4. Extrait du fichier @x11/auto-multiple-choice-devel/Portfile@
77 10 Joël Brogniart
<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
78 22 Joël Brogniart
# $Id$
79 15 Joël Brogniart
80 1
PortSystem              1.0
81 19 Joël Brogniart
PortGroup               bitbucket 1.0
82 1
PortGroup               perl5 1.0
83 19 Joël Brogniart
84 22 Joël Brogniart
set bitbucket_commit    "d6719412b9a3"
85 22 Joël Brogniart
set amc_revision        "1966"
86 22 Joël Brogniart
#1966:d6719412b9a3
87 19 Joël Brogniart
bitbucket.setup         auto-multiple-choice auto-multiple-choice ${bitbucket_commit}
88 10 Joël Brogniart
name                    auto-multiple-choice-devel
89 19 Joël Brogniart
version                 1.3.${amc_revision}
90 15 Joël Brogniart
categories              x11 tex education
91 13 Joël Brogniart
platforms               darwin
92 2 Joël Brogniart
license                 GPL-2+
93 13 Joël Brogniart
maintainers             laposte.fr:joel.brogniart,openmaintainer
94 13 Joël Brogniart
95 13 Joël Brogniart
description             Auto Multiple Choice - Multiple Choice Papers Management
96 6 Joël Brogniart
long_description        Utility to manage multiple choice questionnaires, \
97 11 Joël Brogniart
                        with optionally mixed questions and answers. \
98 12 Joël Brogniart
                        AMC provides automatic marking from papers' scans. \
99 1
                        Annotated papers are produced. Marks can be exported \
100 19 Joël Brogniart
                        as an OpenOffice.org sheet file.
101 19 Joël Brogniart
102 10 Joël Brogniart
homepage                http://home.gna.org/auto-qcm
103 2 Joël Brogniart
104 22 Joël Brogniart
checksums               rmd160  2d3597af254da3219e17c1d9dadc6c6fe4edd518 \
105 22 Joël Brogniart
                        sha256  9207cfd1cd63d3889aa51eca7a987f2435bb053fabf6e4d9e5e9383be72d34e8
106 13 Joël Brogniart
107 13 Joël Brogniart
depends_build-append    \
108 15 Joël Brogniart
                        port:dblatex \
109 19 Joël Brogniart
                        port:p${perl5.major}-xml-libxml
110 2 Joël Brogniart
</pre>
111 1
112 2 Joël Brogniart
h2. Installation de AMC
113 2 Joël Brogniart
114 1
Une fois le fichier de port mis en place, il faut générer l'index du nouveau port.
115 2 Joël Brogniart
<pre>cd ~/nix/macports
116 1
portindex</pre>
117 1
118 1
*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.
119 1
120 1
<pre>sudo port uninstall auto-multiple-choice</pre>
121 1
122 20 Joël Brogniart
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@.
123 20 Joël Brogniart
124 20 Joël Brogniart
<pre>sudo port install pdftk</pre>
125 20 Joël Brogniart
126 22 Joël Brogniart
Puis l'installation du port @pdflatex@.
127 20 Joël Brogniart
128 22 Joël Brogniart
<pre>sudo port install pdflatex</pre>
129 20 Joël Brogniart
130 20 Joël Brogniart
Et enfin l'installation d'AMC.
131 1
132 2 Joël Brogniart
<pre>sudo port install auto-multiple-choice-devel</pre>
133 1
134 1
AMC est prêt à être utilisé.
135 1
136 1
h2. Utilisation de AMC
137 2 Joël Brogniart
138 1
Vous pouvez lancer AMC à partir du terminal ou à partir de XQuartz.
139 1
140 1
h3. Dans Terminal
141 17 Joël Brogniart
142 1
<pre>auto-multiple-choice</pre>
143 2 Joël Brogniart
144 2 Joël Brogniart
Cette commande lancera l'application XQuartz puis AMC.
145 13 Joël Brogniart
146 2 Joël Brogniart
h3. Dans XQuartz
147 13 Joël Brogniart
148 13 Joël Brogniart
Lancer l'application XQuartz.
149 13 Joël Brogniart
150 13 Joël Brogniart
!xquartz.png!
151 13 Joël Brogniart
152 13 Joël Brogniart
On peut tout de suite configurer XQuartz pour faciliter le lancement de AMC. Ouvrir le menu @Applications > Personnaliser…@.
153 13 Joël Brogniart
154 13 Joël Brogniart
!xquartz-menu-applications-personnaliser.png!
155 13 Joël Brogniart
156 13 Joël Brogniart
Dans la fenêtre de personnalisation, cliquer le bouton @Ajouter un élément@.
157 13 Joël Brogniart
158 13 Joël Brogniart
!xquartz-fenetre-personnaliser-menu-applications.png!
159 13 Joël Brogniart
160 13 Joël Brogniart
Mettre "@Auto Multiple Choice@" dans la colonne @Nom@ et "@auto-multiple-choice@" dans la colonne @Commande@ du nouvel item de menu.
161 1
162 1
!xquartz-fenetre-personnaliser-menu-applications-2.png!
163 17 Joël Brogniart
164 13 Joël Brogniart
Fermer la fenêtre de personnalisation puis choisir le menu @Applications > Auto Multiple Choice@.
165 1
166 1
!xquartz-menu-applications-amc.png!
167 1
168 1
La fenêtre de AMC doit apparaître.
169 1
170 1
!auto-multiple-choice-window.png!
171 1
172 1
Auto-multiple-choice est maintenant prêt à l'emploi.
173 1
174 1
h2. Liens
175 1
      
176 1
* Auto Multiple Choice, "http://home.gna.org/auto-qcm/":http://home.gna.org/auto-qcm/.
177 22 Joël Brogniart
* 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.
178 1
* MacPorts, "http://www.macports.org":http://www.macports.org.
179 1
* MacPorts, "Local Portfile Repositories":http://guide.macports.org/#development.local-repositories.
180 1
* MacPorts, "How to create portfiles for CPAN Perl modules":https://trac.macports.org/wiki/howto/cpan2port.
181 1
* XQuartz, http://xquartz.macosforge.org</a>.