h1. Installation d'AMC sous macOS avec MacPorts

L'installation décrite ici nécessite quelques connaissances sur les outils Unix, l'utilisation de lignes de commandes, l'installation de "MacPorts":http://www.macports.org. Il faut aussi disposer des droits d'administration sur l'ordinateur. Elle n'est donc malheureusement pas destinée à tout le monde.

h2. Prérequis

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

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 "sourceforge":https://sourceforge.net/projects/linuxlibertine/.

*Attention* : le système X Window 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 de macOS sur le site "MacPorts":http://www.macports.org et installer MacPorts. Suivez bien les instructions et n'oubliez pas d'installer Xcode.

h3.  Perl

Auto-Multiple-Choice est un outil développé avec le langage de programmation Perl. MacPorts permet l'installation de plusieurs versions de Perl. Certaines incohérences dans la gestion de ces versions fait que si la version de Perl attendue pour l'installation d'AMC n'est pas la version par défaut, certains des modules dont dépend AMC ne seront pas installés au bon endroit et AMC ne fonctionnera pas ou pas correctement. Pour éviter ce problème, la première chose à faire est d'installer la version de Perl attendue par AMC et que ce soit la version par défaut de Perl. Ceci est fait avec la commande qui suit.

<pre>sudo port install perl5 +perl5_30</pre>

h3.  L'environnement X Window System

MacOS ne contient pas en standard le système de fenêtrage X Window. Si vous n'avez pas l'application "XQuartz":http://xquartz.macosforge.org, il faut installer X Window à partir de MacPorts.

Pour installer X Window à partir de MacPorts, lancer la commande suivante.

<pre>sudo port install xorg-server xterm xman xlogo</pre>

*Attention* : pour que le système de fenêtrage X Window soit correctement pris en compte, après son installation il faut que vous quittiez votre session et vous connectiez à nouveau.

h2. Installation de AMC

Il est possible d'installer une des deux versions de AMC. Soit la version @stable@ (actuellement, la version 1.5.0-1-g7ad0c6c6 du 10/9/2021), soit la version @développement@ (actuellement la version 1.5.0-3-g3f13eaba du 19/9/2021). 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 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. 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.

Si nécessaire, mettez à jour votre installation Macports avec les commandes suivantes.

<pre>sudo port selfupdate

sudo port upgrade outdated</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

Les outils de construction MacPorts doivent pouvoir accéder aux outils MacTeX. Par exemple avec l'installation MacTeX 2018, ces outils sont disponibles dans le dossier @"/Library/TeX/texbin"@. Il faut modifier la configuration de MacPorts pour que ce dossier soit inclus 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 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, il faut lancer l'installation avec la commande suivante.

<pre>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>

AMC est prêt à être utilisé.

h2. Utilisation de AMC

Vous pouvez lancer AMC à partir du terminal ou à partir du système X Window.

h3. Dans Terminal

<pre>auto-multiple-choice</pre>

Cette commande lancera l'application XQuartz puis AMC.

h3. Dans le système X Window

Le système X Window peut être fourni par l'application XQuartz (dans le dossier @Applications@) ou l'application X11 (dans le dossier @Applications/MacPorts@). Lancer l'application.

!xquartz.png!

On peut tout de suite configurer l'application 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 "@LANG=fr_FR.UTF-8 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!

Auto-multiple-choice est maintenant prêt à l'emploi.

h2. Liens

* MacPorts, "http://www.macports.org":http://www.macports.org.

* MacTeX, "http://www.tug.org/mactex/":http://www.tug.org/mactex/

* Police de caractères Linux Libertine font, "https://sourceforge.net/projects/linuxlibertine/":https://sourceforge.net/projects/linuxlibertine/

* XQuartz, "http://xquartz.macosforge.org":http://xquartz.macosforge.org.