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. Il faut aussi disposer des droits d'administration sur l'ordinateur. Elle n'est donc malheureusement pas destinée à tout le monde.

Prérequis¶

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

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.

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

La famille de polices DejaVu¶

Ces polices sont utilisées pour la génération des documentations. Il faut télécharger la dernière version sur le site sourceforge.

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

Les polices IPAexMincho et IPAexGothic¶

Ces polices sont utilisées pour la génération des documentations. Il faut télécharger la dernière version sur le site https://moji.or.jp/wp-content/ipafont/IPAexfont/IPAexfont00401.zip.

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

Attention aussi Vérifier aussi les droits et utiliser si besoin chmod 755 /Library/Fonts/<NomDeLaPolice> sur les polices concernées

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 et installer MacPorts. Suivez bien les instructions et n'oubliez pas d'installer Xcode.

L'environnement X Window System¶

MacOS ne contient pas en standard le système de fenêtrage X Window. Ce système peut être fourni soit par l'application XQuartz, soit installé à partir de MacPorts.

Pour installer le système de fenêtrage X Windows à partir de MacPorts, lancer la commande suivante.

sudo port install xorg-server

*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.

Installation de AMC¶

Il est possible d'installer une des deux versions de AMC. Soit la version stable (actuellement, la version 1.4.0 du 29/12/2018), soit la version développement (actuellement la révision 3b5fec09 du 8/1/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 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.

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.

sudo port install auto-multiple-choice

Ou alors utilisez la commande suivante pour installer la version dévelopement de AMC.

sudo port install auto-multiple-choice-devel

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, 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.

binpath               /opt/local/bin:/opt/local/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/Library/TeX/texbin

Pour la version stable de AMC, il faut lancer l'installation avec la commande suivante.

sudo port install auto-multiple-choice +mactex

Et pour la version developpement de AMC il faut utiliser la commande qui suit.

sudo port install auto-multiple-choice-devel +mactex

AMC est prêt à être utilisé.

Utilisation de AMC¶

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

Dans Terminal¶

auto-multiple-choice

Cette commande lancera l'application XQuartz puis AMC.

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.