Obsolete

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

1 1
h1. Installation de la version de développement d'AMC sous OS X Mountain Lion (10.8)
2 1
3 10 Joël Brogniart
_(Cette installation fonctionne sous OS X 10.8.5 avec XCode 5 et MacPorts 2.2.0)_
4 7 Joël Brogniart
5 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.
6 1
7 1
Il est possible d'installer la "version précompilée 1.1.1 d'AMC":http://project.auto-multiple-choice.net/projects/auto-multiple-choice/wiki/Installation_d'AMC_sous_OS_X_Mountain_Lion, 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.
8 1
9 8 Joël Brogniart
Pour l'instant, l'installation décrite ici est assez technique et concerne uniquement OS X 10.8 (et 10.7.5 avec la dernière version de XCode). Cette installation 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 pour la communication avec les outils d'impression et la version installée ne pourra pas imprimer directement. Les documents générés par AMC devront être imprimés à partir de OS X.
10 1
11 10 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. Une fois le fichier de port installé, l'installation d'AMC pourra être lancée.
12 1
13 1
h2. Prérequis
14 1
15 1
Les prérequis sont identiques à ceux de l'installation de la version 1.1.1 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 et le système d'installation MacPorts.
16 1
17 1
h3. L'environnement X Window System
18 1
19 1
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.
20 1
21 1
h3. La police Linux Libertine
22 1
23 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.
24 1
25 1
*Attention* : La version actuelle de XQuartz (2.7.4) 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@".
26 1
27 1
h3. MacPorts
28 1
29 1
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 Mountain Lion sur le site "MacPorts":http://www.macports.org et installer MacPorts.
30 1
31 1
h2. MacPorts et les fichiers de port
32 1
33 10 Joël Brogniart
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.
34 1
35 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.
36 1
37 1
*Remarque* : MacPorts est un effort collaboratif et de nombreux développeurs participent à son évolution. Ainsi les fichiers décrits ici ont ils été proposés pour être ajoutés aux fichiers référencés dans MacPorts. Lorsque et si un ajout est accepté, le fichier de port local n'est plus nécessaire. Une mise à jour de MacPorts importera le fichier de port accepté dans la hiérarchie standard de MacPorts.
38 1
39 1
h3. Dépot local MacPorts
40 1
41 1
Pour que MacPorts puisse utiliser un dossier local, il faut créer ce dossier local.
42 1
43 1
<pre>mkdir -p ~/nix/macports</pre>
44 1
45 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.
46 1
47 1
<pre>file:///Users/julesvernes/nix/macports
48 1
rsync://rsync.macports.org/release/tarballs/ports.tar [default]</pre>
49 1
  
50 1
h3. Fichiers de ports
51 1
52 10 Joël Brogniart
Une archive contenant le fichier de ports décrit ici est disponible au téléchargement : attachment:macports.zip.
53 1
54 10 Joël Brogniart
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@. AMC est développé en PERL et nécessite de nombreux modules CPAN disponibles sur MacPorts. Jusqu'à récemment, il était nécessaire d'avoir une version locale de certains modules PERL, ce n'est plus le cas maintenant mais il peut en rester des traces dans ce texte.
55 7 Joël Brogniart
56 3 Joël Brogniart
Voici une commande permettant de créer cette hiérarchie.
57 1
<pre>cd ~/nix/macports
58 10 Joël Brogniart
mkdir -p x11/auto-multiple-choice-devel</pre>
59 1
60 1
!port-hierarchy.png!
61 1
62 10 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.
63 8 Joël Brogniart
  
64 1
h4. @x11/auto-multiple-choice-devel/Portfile@
65 10 Joël Brogniart
<pre title="x11/auto-multiple-choice-devel/Portfile">
66 10 Joël Brogniart
# -*- 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
67 1
# $Id: Portfile 96038 2012-07-30 02:14:11Z dports@macports.org $
68 1
69 1
PortSystem              1.0
70 10 Joël Brogniart
71 1
name                    auto-multiple-choice-devel
72 10 Joël Brogniart
version                 1.2.1.${svn.revision}
73 6 Joël Brogniart
categories              x11 tex education
74 1
platforms               darwin
75 6 Joël Brogniart
license                 GPL-2+
76 6 Joël Brogniart
maintainers             nomaintainer
77 9 Joël Brogniart
78 8 Joël Brogniart
description             Auto Multiple Choice - Multiple Choice Papers Management
79 6 Joël Brogniart
long_description        Utility to manage multiple choice questionnaires, \
80 6 Joël Brogniart
                        with optionally mixed questions and answers. \
81 6 Joël Brogniart
                        AMC provides automatic marking from papers' scans. \
82 6 Joël Brogniart
                        Annotated papers are produced. Marks can be exported \
83 1
                        as an OpenOffice.org sheet file. \
84 6 Joël Brogniart
                        \
85 6 Joël Brogniart
                        This version can't print. Documents should be printed from OS X.
86 10 Joël Brogniart
                    
87 6 Joël Brogniart
homepage                http://home.gna.org/auto-qcm
88 6 Joël Brogniart
conflicts               auto-multiple-choice
89 6 Joël Brogniart
90 6 Joël Brogniart
depends_build-append    port:dblatex \
91 6 Joël Brogniart
                        port:p5.12-xml-libxml
92 1
depends_lib             port:opencv
93 6 Joël Brogniart
depends_run             port:p5.12-gtk2 \
94 6 Joël Brogniart
                        port:p5.12-xml-simple \
95 1
                        port:p5.12-xml-writer \
96 6 Joël Brogniart
                        port:p5.12-archive-zip \
97 6 Joël Brogniart
                        port:p5.12-locale-gettext \
98 6 Joël Brogniart
                        port:p5.12-digest-md5 \
99 6 Joël Brogniart
                        port:p5.12-module-load-conditional \
100 6 Joël Brogniart
                        port:p5.12-perlmagick \
101 6 Joël Brogniart
                        port:p5.12-openoffice-oodoc \
102 6 Joël Brogniart
                        port:p5.12-file-mimeinfo \
103 6 Joël Brogniart
                        port:p5.12-dbd-sqlite \
104 6 Joël Brogniart
                        port:p5.12-text-csv \
105 6 Joël Brogniart
                        port:p5.12-file-basedir \
106 6 Joël Brogniart
                        port:p5.12-email-mime \
107 6 Joël Brogniart
                        port:p5.12-email-sender \
108 6 Joël Brogniart
                        port:sqlite3 \
109 6 Joël Brogniart
                        port:poppler \
110 6 Joël Brogniart
                        port:netpbm \
111 6 Joël Brogniart
                        port:librsvg \
112 6 Joël Brogniart
                        port:gdk-pixbuf2
113 6 Joël Brogniart
114 6 Joël Brogniart
use_configure           no
115 6 Joël Brogniart
116 6 Joël Brogniart
fetch.type              svn
117 12 Joël Brogniart
svn.revision            1453
118 1
svn.url                 svn://svn.gna.org/auto-qcm/trunk/
119 6 Joël Brogniart
worksrcdir              trunk
120 1
121 6 Joël Brogniart
build.args              AMCCONF=macports \
122 6 Joël Brogniart
                        BASEPATH=${prefix} \
123 6 Joël Brogniart
                        LATEX_FREE=1 \
124 1
                        GCC_PP="${configure.cc} ${configure.cc_archflags}"
125 10 Joël Brogniart
                    
126 6 Joël Brogniart
# When building from source, some files should be configured before.
127 6 Joël Brogniart
# This pre-configuration use the make tool, not the configure tool.
128 6 Joël Brogniart
pre-build {
129 1
    system -W ${worksrcpath} "${build.cmd} version_files"
130 1
}
131 1
132 1
# When first installed auto-multiple-choice could fail to launch with
133 1
# a "Format d'image non reconnu at /opt/local/lib/AMC/perl/AMC-gui.pl line 101"
134 1
# ("Unknown image format?").
135 2 Joël Brogniart
# The following update cache command makes auto-multiple-choice happy.
136 1
post-activate {
137 1
    system "${prefix}/bin/gdk-pixbuf-query-loaders --update-cache 2>&1"
138 1
}
139 2 Joël Brogniart
140 6 Joël Brogniart
destroot.args           AMCCONF=macports \
141 1
                        BASEPATH=${prefix}
142 1
143 6 Joël Brogniart
variant latex description "Add LaTeX support" {
144 6 Joël Brogniart
    depends_run-append  port:texlive-latex-extra \
145 1
                        port:texlive-latex-recommended \
146 1
                        port:texlive-fonts-recommended \
147 10 Joël Brogniart
                        port:texlive-xetex \
148 10 Joël Brogniart
                        port:texlive-lang-french
149 1
150 1
    build.args-delete   LATEX_FREE=1
151 1
152 1
    post-activate {
153 1
        system "${prefix}/bin/mktexlsr 2>&1"
154 1
    }
155 2 Joël Brogniart
156 6 Joël Brogniart
    post-deactivate {
157 1
        system "${prefix}/bin/mktexlsr 2>&1"
158 6 Joël Brogniart
    }
159 6 Joël Brogniart
}
160 11 Joël Brogniart
161 12 Joël Brogniart
default_variants        +latex</pre>
162 1
163 2 Joël Brogniart
h2. Installation de AMC
164 1
165 10 Joël Brogniart
Une fois le fichier de port mis en place, il faut générer l'index du nouveau port.
166 2 Joël Brogniart
<pre>cd ~/nix/macports
167 1
portindex</pre>
168 1
169 2 Joël Brogniart
Enfin, l'installation de la version de développement d'AMC peut être lancée.
170 1
171 1
<pre>sudo port install auto-multiple-choice-devel</pre>
172 1
173 2 Joël Brogniart
AMC est prêt à être utilisé.
174 1
175 2 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.
176 1
177 2 Joël Brogniart
<pre>sudo port uninstall auto-multiple-choice</pre>
178 1
179 2 Joël Brogniart
h2. Utilisation de AMC
180 1
181 2 Joël Brogniart
Vous pouvez lancer AMC à partir du terminal ou à partir de XQuartz.
182 1
183 2 Joël Brogniart
h3. Dans Terminal
184 1
185 2 Joël Brogniart
<pre>auto-multiple-choice-devel</pre>
186 1
187 2 Joël Brogniart
Cette commande lancera l'application XQuartz puis AMC.
188 1
189 2 Joël Brogniart
h3. Dans XQuartz
190 1
191 1
Lancer l'application XQuartz.
192 1
193 2 Joël Brogniart
!xquartz.png!
194 1
195 1
On peut tout de suite configurer XQuartz pour faciliter le lancement de AMC. Ouvrir le menu @Applications > Personnaliser…@.
196 1
197 2 Joël Brogniart
!xquartz-menu-applications-personnaliser.png!
198 1
199 2 Joël Brogniart
Dans la fenêtre de personnalisation, cliquer le bouton @Ajouter un élément@.
200 2 Joël Brogniart
201 2 Joël Brogniart
!xquartz-fenetre-personnaliser-menu-applications.png!
202 2 Joël Brogniart
203 2 Joël Brogniart
Mettre "@Auto Multiple Choice@" dans la colonne @Nom@ et "@auto-multiple-choice@" dans la colonne @Commande@ du nouvel item de menu.
204 2 Joël Brogniart
205 2 Joël Brogniart
!xquartz-fenetre-personnaliser-menu-applications-2.png!
206 1
207 1
Fermer la fenêtre de personnalisation puis choisir le menu @Applications > Auto Multiple Choix@.
208 1
209 1
!xquartz-menu-applications-amc.png!
210 1
211 1
La fenêtre de AMC doit apparaître.
212 1
213 1
!auto-multiple-choice-window.png!
214 1
215 1
À part pour l'impression, tout devrait marcher.
216 1
217 1
h2. Liens
218 1
      
219 1
* Auto Multiple Choice, "http://home.gna.org/auto-qcm/":http://home.gna.org/auto-qcm/.
220 1
* Auto Multiple Choice "(version 1.1.1) - installation sous OS X Mountain Lion (10.8)":http://project.auto-multiple-choice.net/projects/auto-multiple-choice/wiki/Installation_d'AMC_sous_OS_X_Mountain_Lion.
221 1
* MacPorts, "http://www.macports.org":http://www.macports.org.
222 1
* MacPorts, "Local Portfile Repositories":http://guide.macports.org/#development.local-repositories.
223 1
* MacPorts, "How to create portfiles for CPAN Perl modules":https://trac.macports.org/wiki/howto/cpan2port.
224 1
* Famille de polices Linux Libertine, "LinuxLibertine.org":http://www.linuxlibertine.org.
225 1
* XQuartz, http://xquartz.macosforge.org</a>.