h1. Installation de AMC sous macOS OS X

L'installation décrite décrite ici nécessite nécessite quelques connaissances sur les outils Unix, l'utilisation de lignes de commandes, l'installation commandes et une petite compréhension des dépendances entre différents outils (PERL, X11, ports…) et de "MacPorts":http://www.macports.org. l'architecture OS X. Il faut aussi disposer des droits d'administration sur l'ordinateur. Elle n'est donc malheureusement pas destinée à destinée à tout le monde.



h2. Prérequis Prérequis

Pour fonctionner avec son interface, AMC nécessite nécessite un environnement graphique X Window System ou X11, la police de caractères caractères Linux Libertine et le système système d'installation MacPorts.

h3. L'environnement X Window System

MacOS 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 macOS. OS X. On peut télécharger 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'hébreu, l'alphabet phonétique phonétique international (et d'autres). Il faut télécharger télécharger le paquet "OTF" sur le site "LinuxLibertine.org":http://www.linuxlibertine.org.

Attention : XQuartz 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. La famille version actuelle de polices DejaVu

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.

Attention : XQuartz (2.7.4) ne reconnait pas les polices installées installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant déplaçant dans le dossier "@/Library/Fonts@".

h3. MacPorts

MacPorts est un système système qui permet de compiler, installer et gérer gérer des logiciels source libre. Il faut télécharger télécharger le paquet d'installation correspondant à à votre version de macOS d'OS X sur le site "MacPorts":http://www.macports.org et installer MacPorts. Suivez bien les instructions et n'oubliez pas d'installer Xcode.

h2. Installation de AMC

Il est possible d'installer une des deux versions de AMC. Soit la version @stable@ (actuellement, la version 1.3.0.2132 du 20/11/2017), soit la version @développement@. La version @stable@ évolue lentement et les changements de version sont peu fréquents. Plusieurs mois ou années peuvent passer entre deux changements de version. La version @développement@ est sujette à des modifications plus fréquentes. Certaines des nouvelles fonctionnalités n'ont pas été complètement testées et peuvent ne pas fonctionner comme attendu.

Il n'est pas possible d'installer à la fois la version @stable@ et la version @developpement@. Si une de ces versions est installée, il faut la désinstaller avant d'installer l'autre version.

Pour son installation et son fonctionnement AMC nécessite un environnement @LaTeX@. L'installation standard Comme tout va utiliser MacPorts pour installer cet environnement. Si vous utilisez "MacTeX":http://www.tug.org/mactex/ et souhaitez que AMC utilise @MacTeX@ au lieu de l'environnement proposé par MacPort, la procédure d'installation diffère de l'installation standard. La première étape sera celle de l'installation du langage de programmation Perl qui est nécessaire au fonctionnement de AMC. Ensuite il faudra soit suivre les indications de l'installation standard, soit celles de l'installation d'une version de AMC utilisant MacTeX. Ces descriptions supposent que vous avez une installation MacPorts toute fraiche et à jour.

h3. Installation de Perl version 5.26
MacPort est en phase de transition du passage de la version 5.24 à la version 5.26 de Perl. Pour éviter les disfonctionnements, il faut forcer l'installation de la version 5.26.
<pre>sudo port install perl5 +perl5_26</pre>

h3. Installation standard

L'installation standard utilise MacPorts pour installer l'environnement LaTeX nécessaire à AMC. Utilisez la commande suivante pour installer la version @stable@ de AMC.
<pre>sudo port install auto-multiple-choice</pre>

Ou alors utilisez la commande suivante pour installer la version @dévelopement@ de AMC.
<pre>sudo port install auto-multiple-choice-devel</pre>

h3. Installation avec MacTeX</h3>

Les outils de construction MacPorts doivent pouvoir accéder aux outils MacTeX. Par exemple avec l'installation MacTeX 2017, ces outils sont disponibles dans le dossier @"/Library/TeX/texbin"@. Il faut modifier la configuration de MacPorts pour que ce dossier soit inclus mieux dans le @path@ de MacPorts.

Attention, comme indiqué dans la "documentation MacPorts":https://guide.macports.org/chunked/internals.configuration-files.html, la modification du @path@ MacPorts peut avoir meilleur des effets imprévisibles et des conséquences pour d'autres outils. Il faut éviter d'y recourir.

Éditez le fichier @/opt/local/etc/macports/macports.conf@ pour y ajouter la ligne suivante.
<pre>binpath /opt/local/bin:/opt/local/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/Library/TeX/texbin</pre>

Pour la version stable de AMC, mondes, il faut ne reste plus qu'une seule opération à effectuer : lancer l'installation avec la commande suivante. de AMC en utilisant MacPorts.

<pre>
<pre>sudo sudo port install auto-multiple-choice +mactex</pre>

Et pour la version developpement de AMC il faut utiliser la commande qui suit.
<pre>sudo port install auto-multiple-choice-devel +mactex</pre>

</pre>
AMC est prêt à être utilisé. 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…@. Personnaliser…@.

!xquartz-menu-applications-personnaliser.png!

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

!xquartz-menu-applications-amc.png!

La fenêtre fenêtre de AMC doit apparaître. apparaître.

!auto-multiple-choice-window.png!

h3. Impression avec AMC

Normalement, AMC utilise le module Perl @Net::CUPS@ pour d'accéder aux fonctions d'impression. Ce module ne fonctionne plus avec les versions récentes d'OS X (> 10.7) 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 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 à prêt à l'emploi.