Obsolete

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