h1. Installation de AMC (version 1.1.1) sous OS X Mountain Lion

L'installation décrite ici nécessite quelques connaissances sur les outils Unix, l'utilisation de lignes de commandes et une petite compréhension des dépendances entre différents outils (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 quelques petits défauts dans certains modules utilisés et cette installation va essayer de les contourner, mais ne va pas les résoudre tous. La version installée ne pourra pas imprimer directement. Les documents générés par AMC devront être imprimés à partir de OSX. Elle ne pourra pas non plus envoyer les résultats par courrier électronique.

h2. Prérequis

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.

h3. L'environnement X Window System

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'image de 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'alphabet phonétique international (et d'autres). Il faut télécharger le paquet "OTF" sur le site "LinuxLibertine.org":http://www.linuxlibertine.org.

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@".

h3. MacPorts

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 correspondant à votre version d'OS X Mountain Lion sur le site "MacPorts":http://www.macports.org et installer MacPorts.

h2. Installation de AMC

Comme Si tout va allait pour pour le mieux dans le meilleur des mondes, il ne reste resterait plus qu'une seule opération à effectuer : lancer l'installation de AMC en utilisant MacPorts. Malheureusement il n'en est pas ainsi. Il y a eu quelques changements d'organisation dans Mountain Lion (et ailleurs) qui font que l'installation proposée dans MacPorts ne fonctionne pas.

Voici un résumé des problèmes du port de AMC.
* Le port du module d'interface PERL-CUPS ne fonctionne plus car l'installation Apple de CUPS a changé et il manque (au moins) un fichier nécessaire à l'installation du module d'interface. La solution proposée ici va supprimer la dépendance à ce module pour permettre l'installation. *Par contre il ne sera pas possible de lancer d'impression directement à partir de AMC*. Les impressions devront être lancée de OS X ou d'une autre application.
* La gestion des polices dans LaTeX a aussi subit des modifications et il faut ajouter une dépendance au port @texlive-fonts-recommanded@ pour prendre en compte ces modifications.
* AMC utilise une bibliothèque graphique pour le traitement des images. La version actuelle utilise le port @graphicsmagick@, mais ce port ne contient plus la passerelle PERL. Il faut donc remplacer la dépendance à @graphicsmagick@ par une dépendance au port @p5.12-perlmagick@. Ce dernier étant lui même dépendant du port @imagemagick@ la passerelle PERL et la bibliothèque graphique seront installées toutes les deux. (Voir "Bug#71":http://project.auto-multiple-choice.net/issues/71.)

Pour résoudre ou contourner ces problèmes, il faut modifier le fichier de description du port de AMC : "@/opt/local/var/macports/sources/rsync.macports.org/release/tarballs/ports/x11/auto-multiple-choice/Portfile@".

*Attention, toute mise à jour de MacPorts supprimera nos modifications.*

Dans le fichier de description, il faut remplacer
<pre>
depends_run port:p5.12-gtk2 \
port:p5.12-xml-simple \
port:p5.12-xml-writer \
port:p5.12-archive-zip \
port:p5.12-locale-gettext \
port:p5.12-digest-md5 \
port:p5.12-module-load-conditional \
port:GraphicsMagick \
port:p5.12-openoffice-oodoc \
port:p5.12-net-cups \
port:p5.12-file-mimeinfo \
port:p5.12-dbd-sqlite \
port:p5.12-text-csv \
port:p5.12-file-basedir \
port:sqlite3 \
port:poppler \
port:netpbm \
port:librsvg
</pre>
par
<pre>
depends_run port:p5.12-gtk2 \
port:p5.12-xml-simple \
port:p5.12-xml-writer \
port:p5.12-archive-zip \
port:p5.12-locale-gettext \
port:p5.12-digest-md5 \
port:p5.12-module-load-conditional \
port:p5.12-module-metadata \
port:p5.12-perlmagick \
port:p5.12-openoffice-oodoc \
port:p5.12-file-mimeinfo \
port:p5.12-dbd-sqlite \
port:p5.12-text-csv \
port:p5.12-file-basedir \
port:sqlite3 \
port:poppler \
port:netpbm \
port:librsvg
</pre>
et remplacer
<pre>
variant latex description "Add LaTeX support" {
depends_run-append port:texlive-latex-extra \
port:texlive-latex-recommended \
port:texlive-xetex
</pre>
par
<pre>
variant latex description "Add LaTeX support" {
depends_run-append port:texlive-latex-extra \
port:texlive-latex-recommended \
port:texlive-fonts-recommended \
port:texlive-xetex \
port:texlive-lang-french
</pre>

Une fois les modifications enregistrées, il faut installer AMC.
<pre>
sudo port install auto-multiple-choice
</pre>
AMC est 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. Si le lancement de AMC échoue avec une erreur @Format d'image non reconnu at /opt/local/lib/AMC/perl/AMC-gui.pl line 101.@ il faut utiliser la commande qui suit (voir "Bug #68":http://project.auto-multiple-choice.net/issues/68).
<pre>sudo /opt/local/bin/gdk-pixbuf-query-loaders --update-cache</pre>
Cela devrait permettre le lancement de 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…@.

!xquartz-menu-applications-personnaliser.png!

Dans la fenêtre de personnalisation, cliquer le bouton @Ajouter un é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 de personnalisation puis choisir le menu @Applications > Auto Multiple Choix@.

!xquartz-menu-applications-amc.png!

La fenêtre de AMC doit apparaître.

!auto-multiple-choice-window.png!

h3. Impression avec AMC

Normalement, AMC utilise le module Perl @Net::CUPS@ À part pour d'accéder aux fonctions d'impression. Ce module ne fonctionne plus avec les versions récentes d'OS X (> 10.7) l'impression et n'a pas été installé par les outils MacPorts. Il faut modifier les préférences pour la méthode d'impression à utiliser par AMC. Pour modifier la méthode ouvrir le menu @Édition > Préférences@.

!amc-preferences-general.png!

Faire défiler les informations l'envoi de l'onglet @Général@ de la fenêtre des préférences pour accéder à la partie @Impression@. Dans le menu @Méthode d'impression@ choisir une méthode d'impression.

!amc-menu-print-method.png!

* @CUPS@ : ne pas choisir cette méthode sous OS X.
* @par une commande@ : cette méthode permet d'indiquer une commande que peut utiliser AMC pour imprimer un fichier. La commande fournie par défaut @lpr %f@ permet d'imprimer avec l'imprimante et les réglages sélectionnés par défaut.
* @dans des fichiers@ : avec cette méthode, AMC générera un ou plusieurs fichiers PDF qu'il sera possible d'imprimer à partir d'OS X. Dans ce dernier cas il est possible de profiter des options spécifiques aux imprimantes au moment de l'impression&nbsp;: recto-verso, aggrafage…

Auto-multiple-choice est maintenant prêt à l'emploi. courrier électronique, tout devrait marcher.