Obsolete

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

1 13 Joël Brogniart
h1. Installation de la version de développement d'AMC sous OS X
2 1
3 15 Joël Brogniart
_(Cette installation - révision 1728 b36f9124e727 du 29/4/2015 - a été testée sous OS X 10.9.5, Xcode 6.1, MacPorts 2.3.3 et sous OS X 10.10.3, Xcode 6.3.2, MacPorts 2.3.3)_
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 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.
8 1
9 15 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 OS X. Il faut aussi disposer des droits d'administration sur l'ordinateur. Elle n'est donc malheureusement pas destinée à tout le monde.
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 14 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 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 16 Joël Brogniart
h3. La police Linux Libertine
22 16 Joël Brogniart
23 16 Joël Brogniart
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 16 Joël Brogniart
25 16 Joël Brogniart
Attention : La version actuelle de XQuartz (2.7.7) 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 16 Joël Brogniart
27 1
h3. MacPorts
28 1
29 17 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 OS X 10.10 Yosemite sur le site "MacPorts":http://www.macports.org et installer MacPorts.
30 1
31 10 Joël Brogniart
h2. MacPorts et les fichiers de port
32 1
33 13 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
h3. Dépot local MacPorts
38 1
39 1
Pour que MacPorts puisse utiliser un dossier local, il faut créer ce dossier local.
40 1
41 1
<pre>mkdir -p ~/nix/macports</pre>
42 1
43 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.
44 1
45 1
<pre>file:///Users/julesvernes/nix/macports
46 1
rsync://rsync.macports.org/release/tarballs/ports.tar [default]</pre>
47 1
  
48 1
h3. Fichiers de ports
49 1
50 13 Joël Brogniart
Une archive contenant le fichier de port décrit ici est disponible au téléchargement : attachment:macports.zip.
51 1
52 13 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.
53 1
54 7 Joël Brogniart
Voici une commande permettant de créer cette hiérarchie.
55 10 Joël Brogniart
<pre>cd ~/nix/macports
56 1
mkdir -p x11/auto-multiple-choice-devel</pre>
57 1
58 1
!port-hierarchy.png!
59 1
60 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.
61 1
  
62 1
h4. @x11/auto-multiple-choice-devel/Portfile@
63 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
64 8 Joël Brogniart
# $Id: Portfile 96038 2012-07-30 02:14:11Z dports@macports.org $
65 1
66 1
PortSystem              1.0
67 15 Joël Brogniart
PortGroup               bitbucket 1.0
68 1
69 15 Joël Brogniart
set bitbucket_commit    "b36f912"
70 15 Joël Brogniart
set amc_revision        "1728"
71 15 Joël Brogniart
72 15 Joël Brogniart
bitbucket.setup         auto-multiple-choice auto-multiple-choice ${bitbucket_commit}
73 14 Joël Brogniart
name                    auto-multiple-choice-devel
74 15 Joël Brogniart
version                 1.2.1.${amc_revision}
75 10 Joël Brogniart
categories              x11 tex education
76 6 Joël Brogniart
platforms               darwin
77 13 Joël Brogniart
license                 GPL-2+
78 6 Joël Brogniart
maintainers             laposte.fr:joel.brogniart,openmaintainer
79 6 Joël Brogniart
80 9 Joël Brogniart
description             Auto Multiple Choice - Multiple Choice Papers Management
81 8 Joël Brogniart
long_description        Utility to manage multiple choice questionnaires, \
82 6 Joël Brogniart
                        with optionally mixed questions and answers. \
83 1
                        AMC provides automatic marking from papers' scans. \
84 1
                        Annotated papers are produced. Marks can be exported \
85 1
                        as an OpenOffice.org sheet file. \
86 1
                        \
87 1
                        This version can't print directly with CUPS. User should set \
88 1
                        "Printing method" to "file" or "command" in preferences. \
89 1
                        "file" method produce PDF files that could be printed from OS X.
90 1
                    
91 1
homepage                http://home.gna.org/auto-qcm
92 1
93 15 Joël Brogniart
checksums               rmd160  871847a2102c01401a0204e86968f0f43357209a \
94 15 Joël Brogniart
                        sha256  521d6134fb5869bdf9d105c32be2884dd583d0da01e53f742447056c0e4b1b63
95 15 Joël Brogniart
96 15 Joël Brogniart
set amc_perl_version    "5.16"
97 15 Joël Brogniart
98 15 Joël Brogniart
depends_build-append    \
99 15 Joël Brogniart
                        port:dblatex \
100 15 Joël Brogniart
                        port:p${amc_perl_version}-xml-libxml
101 15 Joël Brogniart
102 14 Joël Brogniart
depends_lib             port:opencv
103 15 Joël Brogniart
104 15 Joël Brogniart
depends_run             \
105 15 Joël Brogniart
                        port:gdk-pixbuf2 \
106 15 Joël Brogniart
                        port:libnotify \
107 14 Joël Brogniart
                        port:librsvg \
108 14 Joël Brogniart
                        port:netpbm \
109 15 Joël Brogniart
                        port:p${amc_perl_version}-archive-zip \
110 15 Joël Brogniart
                        port:p${amc_perl_version}-dbd-sqlite \
111 15 Joël Brogniart
                        port:p${amc_perl_version}-digest-md5 \
112 15 Joël Brogniart
                        port:p${amc_perl_version}-email-mime \
113 15 Joël Brogniart
                        port:p${amc_perl_version}-email-sender \
114 15 Joël Brogniart
                        port:p${amc_perl_version}-file-basedir \
115 15 Joël Brogniart
                        port:p${amc_perl_version}-file-mimeinfo \
116 15 Joël Brogniart
                        port:p${amc_perl_version}-glib-object-introspection \
117 15 Joël Brogniart
                        port:p${amc_perl_version}-gtk2 \
118 15 Joël Brogniart
                        port:p${amc_perl_version}-locale-gettext \
119 15 Joël Brogniart
                        port:p${amc_perl_version}-module-load-conditional \
120 15 Joël Brogniart
                        port:p${amc_perl_version}-openoffice-oodoc \
121 15 Joël Brogniart
                        port:p${amc_perl_version}-perlmagick \
122 15 Joël Brogniart
                        port:p${amc_perl_version}-text-csv \
123 15 Joël Brogniart
                        port:p${amc_perl_version}-xml-simple \
124 15 Joël Brogniart
                        port:p${amc_perl_version}-xml-writer \
125 18 Joël Brogniart
                        port:pdftk \
126 1
                        port:poppler \
127 1
                        port:sqlite3
128 1
129 1
use_configure           no
130 15 Joël Brogniart
use_parallel_build  no
131 1
132 1
build.args              AMCCONF=macports \
133 1
                        BASEPATH=${prefix} \
134 1
                        LATEX_FREE=1 \
135 1
                        GCC_PP="${configure.cc} ${configure.cc_archflags}"
136 1
137 14 Joël Brogniart
# When building from source, some files should be configured before.
138 13 Joël Brogniart
# This pre-configuration use the make tool, not the configure tool.
139 14 Joël Brogniart
pre-build {
140 15 Joël Brogniart
    system -W ${worksrcpath} "${build.cmd} version_files AMCCONF=macports BASEPATH=${prefix}"
141 14 Joël Brogniart
}
142 14 Joël Brogniart
143 1
destroot.args           AMCCONF=macports \
144 13 Joël Brogniart
                        BASEPATH=${prefix}
145 10 Joël Brogniart
146 13 Joël Brogniart
variant latex description "Add LaTeX support" {
147 15 Joël Brogniart
  depends_run-append     \
148 13 Joël Brogniart
                        port:texlive-fonts-recommended \
149 2 Joël Brogniart
                        port:texlive-lang-french \
150 13 Joël Brogniart
                        port:texlive-latex-extra \
151 13 Joël Brogniart
                        port:texlive-latex-recommended \
152 13 Joël Brogniart
                        port:texlive-xetex
153 6 Joël Brogniart
154 11 Joël Brogniart
  build.args-delete   LATEX_FREE=1
155 12 Joël Brogniart
156 1
  post-activate {
157 2 Joël Brogniart
    system "${prefix}/bin/mktexlsr 2>&1"
158 1
  }
159 10 Joël Brogniart
160 2 Joël Brogniart
  post-deactivate {
161 1
    system "${prefix}/bin/mktexlsr 2>&1"
162 1
  }
163 13 Joël Brogniart
}
164 13 Joël Brogniart
165 15 Joël Brogniart
default_variants        +latex
166 15 Joël Brogniart
</pre>
167 2 Joël Brogniart
168 1
h2. Installation de AMC
169 2 Joël Brogniart
170 1
Une fois le fichier de port mis en place, il faut générer l'index du nouveau port.
171 2 Joël Brogniart
<pre>cd ~/nix/macports
172 1
portindex</pre>
173 2 Joël Brogniart
174 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.
175 1
176 1
<pre>sudo port uninstall auto-multiple-choice</pre>
177 1
178 1
Enfin, l'installation de la version de développement d'AMC peut être lancée.
179 2 Joël Brogniart
180 1
<pre>sudo port install auto-multiple-choice-devel</pre>
181 2 Joël Brogniart
182 1
AMC est prêt à être utilisé.
183 1
184 1
h2. Utilisation de AMC
185 1
186 2 Joël Brogniart
Vous pouvez lancer AMC à partir du terminal ou à partir de XQuartz.
187 1
188 1
h3. Dans Terminal
189 1
190 17 Joël Brogniart
<pre>auto-multiple-choice</pre>
191 1
192 2 Joël Brogniart
Cette commande lancera l'application XQuartz puis AMC.
193 2 Joël Brogniart
194 13 Joël Brogniart
h3. Dans XQuartz
195 2 Joël Brogniart
196 13 Joël Brogniart
Lancer l'application XQuartz.
197 13 Joël Brogniart
198 13 Joël Brogniart
!xquartz.png!
199 13 Joël Brogniart
200 13 Joël Brogniart
On peut tout de suite configurer XQuartz pour faciliter le lancement de AMC. Ouvrir le menu @Applications > Personnaliser…@.
201 13 Joël Brogniart
202 13 Joël Brogniart
!xquartz-menu-applications-personnaliser.png!
203 13 Joël Brogniart
204 13 Joël Brogniart
Dans la fenêtre de personnalisation, cliquer le bouton @Ajouter un élément@.
205 13 Joël Brogniart
206 13 Joël Brogniart
!xquartz-fenetre-personnaliser-menu-applications.png!
207 13 Joël Brogniart
208 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.
209 13 Joël Brogniart
210 1
!xquartz-fenetre-personnaliser-menu-applications-2.png!
211 1
212 17 Joël Brogniart
Fermer la fenêtre de personnalisation puis choisir le menu @Applications > Auto Multiple Choice@.
213 13 Joël Brogniart
214 1
!xquartz-menu-applications-amc.png!
215 1
216 1
La fenêtre de AMC doit apparaître.
217 1
218 1
!auto-multiple-choice-window.png!
219 1
220 1
Auto-multiple-choice est maintenant prêt à l'emploi.
221 1
222 1
h2. Liens
223 1
      
224 1
* Auto Multiple Choice, "http://home.gna.org/auto-qcm/":http://home.gna.org/auto-qcm/.
225 1
* 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.
226 1
* MacPorts, "http://www.macports.org":http://www.macports.org.
227 1
* MacPorts, "Local Portfile Repositories":http://guide.macports.org/#development.local-repositories.
228 1
* MacPorts, "How to create portfiles for CPAN Perl modules":https://trac.macports.org/wiki/howto/cpan2port.
229 1
* XQuartz, http://xquartz.macosforge.org</a>.